Product Administration Guide

If you are a product administrator, the follow content will provide an overview of the administration tasks that you need to perform when working with WSO2 Business Process Server (WSO2 BPS).

Administering WSO2 BPS involves the following:

Upgrading from a previous release

If you are upgrading from WSO2 BPS 3.5.1 to WSO2 BPS 3.6.0 version, see Upgrading to the Latest BPS Version.

Configuring the server

WSO2 Business Process Server (WSO2 BPS) is shipped with default configurations that will allow you to download, install and get started with your product instantly. However, when you go into production, it is recommended to change some of the default settings to ensure that you have a robust system that is suitable for your operational needs. Also, you may have specific use cases that require specific configurations to the server.

Listed below are configurations for setting up your product server.

Changing the default database

By default, WSO2 products are shipped with an embedded H2 database, which is used for storing user management and registry data. We recommend that you use an industry-standard RDBMS such as Oracle, PostgreSQL, MySQL, MS SQL, etc. when you set up your production environment.  You can change the default database configuration by simply setting up a new physical database and updating the configurations in the product server to connect to that database. 

For instructions on setting up and configuring databases, see Working with Databases in the WSO2 Product Administration Guide.

For instructions on managing datasources, see Managing Datasources in the WSO2 Product Administration Guide.

Configuring users, roles and permissions

The user management feature in your product allows you to create new users and define the permissions granted to each user. You can also configure the user stores that are used for storing data related to user management.

For instructions on how to configure user management, see Working with Users, Roles and Permissions in the WSO2 Product Administration Guide.

Configuring security

After you install WSO2 BPS, it is recommended to change the default security settings according to the requirements of your production environment. As BPS is built on top of the WSO2 Carbon Kernel (version 4.4.6), the main security configurations applicable to BPS are inherited from the Carbon kernel.

For instructions on configuring security in your server, see the following topics in the WSO2 Product Administration Guide.

• Configuring Transport-Level Security
• Using Asymmetric Encryption
• Using Symmetric Encryption
• Enabling Java Security Manager
• Securing Passwords in Configuration Files
• Resolving Hostname Verification

Configuring multitenancy

You can create multiple tenants in your product server, which will allow you to maintain tenant isolation in a single server/cluster. For instructions on configuring multiple tenants for your server, see Working with Multiple Tenants in the WSO2 Product Administration Guide.

Configuring the registry

registry is a content store and a metadata repository for various artifacts such as services, WSDLs and configuration files. In WSO2 products, all configurations pertaining to modules, logging, security, data sources and other service groups are stored in the registry by default. 

For instructions on setting up and configuring the registry for your server, see the following topics on Working with the Registry in the WSO2 Product Administration Guide.

• Managing the Registry
• Searching the Registry
• Using Remote Registry Instances for the Registry Partitions

Performance tuning

You can optimize the performance of your WSO2 server by using configurations and settings that are suitable to your production environment. At a basic level, you need to have the appropriate OS settings, JVM settings etc. Since WSO2 products are all based on a common platform called Carbon, most of the OS, JVM settings recommended for production are common to all WSO2 products. Additionally, there will be other performance enhancing configuration recommendations that will depend on very specific features used by your product. 

For instructions on the Carbon platform-level performance tuning recommendations, see Performance Tuning in the WSO2 Product Administration Guide.

For instructions on performance tuning recommendations that are specific to WSO2 BPS functionality, see the  Performance Tuning Recommendations in the WSO2 BPS Guide. 

Changing the default ports

When you run multiple WSO2 products, multiple instances of the same product, or multiple WSO2 product clusters on the same server or virtual machines (VMs), you must change their default ports with an offset value to avoid port conflicts.

For instructions on configuring posts, see Changing the Default Ports in the WSO2 Product Administration Guide.