Install and Setup Overview¶
The installation and the setup of ESB involve installing the product, deploying it in the method that is best suited for your requirements, and setting it up to run in the production environment. If you already have an older version of MWARE ESB or one of its components, you can follow the upgrading instructions in this guide.
This section provides installation and setup instructions for the following three components of MWARE ESB that you need to operate as three separate runtimes.
ESB¶
This component manages APIs. To install and set up this component, see the following topics.
Installing¶
To install and run the ESB in virtual machines, see the following topics.
| Installing the ESB Runtime | Explains how to download the ESB component as a binary and install it on a virtual machine. |
|---|---|
| Running the API-M Runtime | Explains how you can execute the API-M runtime and start using its features. |
| Running API-M as a Linux Service | Explains how to install and run the ESB as a Linux service. |
| Running API-M as a Windows Service | Explains how to install and run the ESB as a Windows service. |
Setting up¶
To set up the ESB component, see the following topics.
| Applying WUM Updates | Explains how to get the latest updates that are available for a particular release of the ESB. |
|---|---|
| Setting up a Key Manager | The key manager of the ESB handles all clients, security, and access token-related operations. This section covers the following topics: |
| Setting up Databases | The ESB is shipped with an H2 database for storing data. This guide explains the default H2 databases used within ESB as well as how to switch to a different database supported for the ESB such as MSSQL, MySQL, PostgreSQL, Oracle, MariaDB, IBM DB2, and Oracle RAC. In addition, this section covers how to manage data growth and improve performance when storing metadata and runtime data in databases. |
| Setting up Proxy Server and the Load Balancer | A load balancer or reverse proxy is required to map external traffic with ports and URLs that the APi Manager component uses internally. This section covers the following topics relating to the proxy server and the load balancer. |
| Securing the ESB |
Covers the different ways in which you can secure the ESB and the data it handles. The topics covered are as follows:
|
| Configuring User Stores | You can configure primary user stores as well as secondary user stores for the ESB component. This section explains the concept of user stores and provides instructions to configure primary user stores. The topics covered are as follows: |
| SSO |
Explains how to configure SSO (Single Sign On) for the ESB component with an external identity provider. The topics covered are as follows.
|
| Advanced Configurations |
Covers some advance configurations including how to change the transport used by the ESB component from the default PassThrough transport to a different transport, how to configure caching, and how to change the user interfaces of the ESB component.
|
Deploying¶
To deploy the ESB runtime, see the topics given below.
| Deployment Patterns | This explains all the deployment patterns you can follow when you deploy MWARE ESB. These patterns involve deploying the ESB component together with Micro Integrator and Streaming Integrator components in clustered setups. |
|---|---|
| All-in-One Deployment | This describes the all-in-one deployment patterns where you can deploy all the sub components of the ESB component in one instance. |
| Distributed Deployment | This describes the distributed deployment patterns where you can deploy the sub-components of the ESB component in a distributed manner in order to handle a high volume of requests in an efficient manner. |
| Deploy API-M on Kubernetes using the Operator | Explains how the MWARE ESB Kubernetes operator deploys the ESB component in Kubernetes. |
| Deploy API-M on Kubernetes using Helm Resources | Explains how Helm resources deploy the ESB component in Kubernetes. |
| Deploy APIs on Kubernetes | Explains how the Kubernetes operator can deploy APIs in Kubernetes as managed APIs. |
CI/CD¶
To implement continuous integration and continuous deployment pipelines for APIs on ESB, see the topics given below.
| CI/CD for APIs - Overview | Find out about the methods of implementing CI/CD for APIs using the API Controller (apictl). |
|---|---|
| Building a CI/CD Pipeline for APIs using the CLI | See the instructions on how to implement a CI/CD pipeline for APIs using the API Controller (apictl). |
| Building a CI/CD Pipeline for APIs using Jenkins | See the instructions on how to implement a CI/CD pipeline for APIs using Jenkins and the API Controller (apictl). |
See the topics given below to manage APIs, API products, Apps, etc. in the API-M runtime by using the API Controller (apictl).
| Getting Started with ESB API Controller | Explains how to set up the API Controller. |
|---|---|
| Managing APIs and API Products |
This section covers the following topics.
|
| Managing Applications |
This section covers the following topics.
|
| Advanced Topics |
This section covers the following topics.
|
Upgrading¶
To upgrade to the current ESB component from a previous version, see the topics given below.
Micro Integrator¶
This component develops complex integration services that can be exposed as managed APIs.
Installing¶
To install and run the Micro Integrator on a virtual machine, see the topics given below.
| Installing the Micro Integrator Runtime | Explains how to download the Micro Integrator runtime as a binary and install it on a virtual machine. |
|---|---|
| Running the Micro Integrator Runtime | Explains how you can execute the Micro Integrator runtime and start using its features. |
| Running the Micro Integrator as a Windows Service | Explains how to install and run the Micro Integrator as a Windows service. |
To install and run the Micro Integrator Dashboard on a virtual machine, see the topics given below.
| Installing the Micro Integrator Dashboard | Explains how to download the Micro Integrator Dashboard as a binary and install it on a virtual machine. |
|---|---|
| Running the Micro Integrator Dashboard | Explains how you can execute the Micro Integrator Dashboard and start using its features. |
Setting up¶
To set up and configure the Micro Integrator runtime, see the topics given below.
| Applying Updates | Explains how to get the latest updates that are available for a particular release of the Micro Integrator. |
|---|---|
| Data Stores | Explains how to set up a user store, databases (multiple types), and a file-based registry. The topics covered are as follows: |
| Securing the Micro Integrator |
Covers the different ways in which you can secure the Micro Integrator and the data it handles. The topic covered are as follows:
|
| Performance |
Explains how to configure the Micro Integrator at different levels to optimize performance.
|
| Message Brokers |
Explains how to set up the Micro Integrator component to integrate with message brokers such as RabbitMQ, Kafka, and JMS. The topics covered are as follows:
|
| Transports | Explains how to configure the Micro Integrator component to work with a range of transports. These include all the widely used transports including HTTP/S, JMS, VFS, as well as domain-specific transports such as FIX. |
| Multi-HTTPS Transport | Explains how to enable dynamic SSL profiles for the Micro Integrator component and how to dynamically load the SSL profiles at runtime using a periodic schedule or JMX invocation. |
| Message Builders and Formatters | When the Micro Integrator receives a request via a mode of transport, the transport uses a **message builder** to process the payload and convert it to SOAP. Similarly, when the Micro Integrator sends a message via a mode of transport, the publishing transport uses a **message formatter** to present the payload in the required format. This section explains how to configure these message builders and message formatters. |
| Message Relay | Enabling message relay allows the Micro Integrator component to to pass messages along without building or processing them unless specifically requested to do so. This way, the Micro Integrator can handle a higher throughput. |
| Observability |
There are two possible observability solutions that you can enable for the Micro Integrator component. This section explains how to set them up and well as how to configure logging. The topics covered are as follows:
|
| Timestamp Conversion for RDBMS | Explains how to enable/disable time stamp conversions for the RDBMS databases configured for the Micro Integrator component.. |
Deploying¶
To deploy the Micro Integrator runtime, see the topics given below.
| Deployment Patterns | This explains all the deployment patterns you can follow when you deploy MWARE ESB. These patterns involve deploying the ESB component together with Micro Integrator and Streaming Integrator components in clustered setups. |
|---|---|
| Configuring a Micro Integrator Cluster | Explains how to set up a two-node Micro Integrator cluster. |
| Deployment Synchronization | Set up deployment synchronization for the Micro Integrator. |
CI/CD¶
To implement continuous integration and continuous deployment pipelines for integrations, see the topics given below.
| CI/CD for Integrations - Overview | Find out about the methods of implementing CI/CD for integrations in the Micro Integrator. |
|---|---|
| Building a CI/CD Pipeline for Integrations (VM deployment) | See the instructions on how to implement a CI/CD pipeline for integrations in a VM deployment of the Micro Integrator. |
| Building a CI/CD Pipeline for Integrations (K8s deployment) | See the instructions on how to implement a CI/CD pipeline for integrations in a Kubernetes deployment of the Micro Integrator. |
To manage integration artifacts and logs in the Micro Integrator by using the API Controller (apictl), see the topics given below.
| Getting Started with ESB API Controller | Explains how to set up the API Controller. |
|---|---|
| Managing Integrations | Explains how to manage integrations with the API Controller. |
Upgrading¶
The Micro integrator of Enterprise Integrator is the predecessor of the Micro Integrator component of MWARE ESB. To upgrade from an Enterprise Integrator version, see the following topics.
Streaming Integrator¶
This component develops streaming solutions that can be exposed as managed APIs asynchronously.
Installing¶
To install and run the Streaming Integrator, see the following topics.
| Installing the Streaming Integrator Runtime | Explains how to download the Streaming Integrator runtime as a binary and install it on a virtual machine. |
|---|---|
| Running the Streaming Integrator Runtime | Explains how you can execute the Streaming Integrator runtime and start using its features. |
| Running the Streaming Integrator as a Linux Service | Explains how to install and run the Streaming Integrator as a Linux service. |
| Running the Streaming Integrator as a Windows Service | Explains how to install and run the Streaming Integrator as a Windows service. |
| Installing the Streaming Integrator on Containers |
Explains how to install the Streaming Integrator component in different containerized environments. The topics covered are as follows:
|
Setting up¶
Setting up the Streaming Integrator component involves performing the following tasks.
| Applying ESB Updates | Explains how to get the latest updates that are available for a particular release of the Streaming Integrator. |
|---|---|
| Production Checklist | Lists all the setup tasks you need to complete in order to run the Streaming Integrator component in a production environment. |
| Performance Analysis Results | This has the results of the performance tests carried out for the Streaming Integrator component. |
| Configuring Business Rules Deployment | Explains how to configure a Streaming Integrator node to use a specified business rule template. Business rules templates are templates Streaming applications and queries that allow you to use the streaming logic ofWSO2 ESB without writing queries from scratch. |
| Configuring Data Sources |
Explains how to configure the data sources vis which the Streaming Integrator server and the Streaming Integrator Tooling connect to databases. This section also explains the default data sources configured for the Streaming Integrator and the Streaming Integrator Tooling. |
| Securing the Streaming Integrator |
Explains how to secure the Streaming Integrator component and the data it handles. The topics covered are as follows.
|
| Supporting Different Transports | Explains the setup tasks you need to complete to allow the Streaming Integrator component to work with different transports. |
| Configuring State Persistence | Explains how to prevent the loss of data that can result from a system failure by persisting the state of Streaming Integrator component periodically either into a database system or into the file system. |
| Configuring Cluster Coordination | Explains how to configure a cluster coordination strategy that determines how the Streaming Integrator nodes in a cluster coordinate with each other. |
| Adding Third Party Non OSGi Libraries | The Streaming Integrator component is OSGi-based. Therefore, when you are adding non-OSGi libraries to the Streaming Integrator pack, you need to first convert them into OSGi bundles. This section provides instructions to do this. |
| Configuring Default Ports | Explains the default ports that the Streaming Integrator component uses for different purposes when the port offset is 0. |
| Changing the Host Name and Context Path of Web UI Applications | Explains how to change the host name and the context path specified in the URLS via which the user interfaces of the Streaming Integrator are accessed. |
| Enabling Logs for Received Event Count | Explains how to configure the Streaming Integrator component to log the total number of events it received via its sources per given time interval. |
Deploying¶
See the topics given below for instructions on setting up a Streaming Integrator deployment.
| Deployment Patterns | This explains all the deployment patterns you can follow when you deploy MWARE ESB. These patterns involve deploying the ESB component together with Micro Integrator and Streaming Integrator components in clustered setups. |
|---|---|
| Single-Node Streaming Integrator Deployment | Instructions on setting up a single-node Streaming Integrator deployment. |
| Minimum HA Streaming Integrator Deployment | Instructions on setting up a Streaming Integrator deployment with minimum high availablity. |
| Active-Active Streaming Integrator Deployment | Instructions on setting up an Active-Active Streaming Integrator deployment. |
| Scalable Streaming Integrator Deployment | Instructions on setting up a scalable Streaming Integrator deployment. |
Reference¶
| Common Runtime and Configuration Artifacts | Describes some artifacts that are commonly used with the ESB component. |
|---|---|
| Default Product Ports | Explains the defauly ports used by the ESB component. |
| Product Compatibility | Provides details relating to the compatibility of the ESB component with different operating systems and JDKs, databases, key managers, web browsers, and other MWARE products. |
| Supported Cipher Suites | Provides details of the supported cipher suites. |