Running the API-M Profiles¶
When the API-M server is started, all components, features, and related artifacts bundled with it are started. Multi-profile support allows you to run the product on a selected profile so that only the features specific to that profile along with common features startup with the server.
Tip
Starting a product on a preferred profile only blocks/allows the relevant OSGI bundles. As a result, even if you start the server on a profile, you can still access the API Publisher web application.
An OSGI Bundle is a tightly coupled, dynamically loadable collection of classes, jars, and configuration files that explicitly declare their external dependencies (if any). In OSGi, a bundle is the primary deployment format. Bundles are applications that are packaged in JARs and can be installed, started, stopped, updated, and removed.
Before you begin¶
See the following topics to understand how API-M profiles are used in a distributed deployment:
Profile startup commands¶
Listed below are the startup commands for starting each of the API-M profiles.
Profile | Command |
---|---|
Gateway Profile |
|
Control Plane Profile |
|
Traffic Manager Profile |
|
Key Manager Profile |
|
Starting an API-M profile¶
You can start an API Manager profile in the following methods, based on your requirement.
Method 1- Optimizing before starting the server¶
Note
Make sure to update the API-M pack to the latest using the "WSO2 in-place updates tool" before running the profile optimization. If you update the server after running the profile optimization, you may need to follow Method 2, as the updates would have fetched irrelevant files for this profile
Create an optimized distribution for a particular API-M profile.
-
Run the
<API-M_HOME>/bin/profileSetup.sh
script or<API-M_HOME>/bin/profileSetup.bat
script based on your operating system, with the profile flag. -
Copy the respective database connector JAR to
/lib
directory.For example, if you are using a MySQL database,
-
Download the MySQL connector JAR file and extract it.
Tip
Look for the compatible MySQL Connector version based on the MySQL version being used.
- For MySQL version 8.0.x, the compatible MySQL Connector version is 8.0.x.
- For MySQL version 8.4.x, the compatible MySQL Connector version is 8.4.x.
-
Copy it to the
<API-M_HOME>/repository/components/lib/
directory.
-
-
Create the required databases, namely the API-M database (
apimgtdb
also known asWSO2_AM_DB
) and the shared database (WSO2_SHARED_DB
also known asshareddb
). -
Update the default DB configurations to match your environment.
Change the following DB configurations, which are in the
<API-M_HOME>/repository/conf/deployment.toml
file. -
Start the server with the specified profile.
Method 2 - Optimizing while starting the server¶
Start the server using the script based on your operating system, using the command given below.
Warning
Before running this command you are expected to do the configuration changes in the deployment.toml
file manually in the pack.
Click here to see the sample output when you optimize the server for Gateway profile while starting in Gateway worker profile.
[2023-02-23 16:46:52] INFO - Starting to optimize API Manager for the Gateway worker profile
[2023-02-23 16:46:52] INFO - Starting to optimize configs in deployment.toml
[2023-02-23 16:46:52] INFO - Renamed the existing ../repository/conf/deployment.toml file as deployment.toml.backup
[2023-02-23 16:46:52] INFO - Copied the existing ../repository/resources/conf/deployment-templates/gateway-worker.toml file as ../repository/conf/deployment.toml
[2023-02-23 16:46:52] INFO - Renamed the existing ../repository/resources/conf/templates/repository/conf/tomcat/carbon/WEB-INF/web.xml.j2 file as web.xml.j2.backup
[2023-02-23 16:46:53] INFO - Renamed the existing ../repository/resources/conf/templates/repository/conf/tomcat/carbon/WEB-INF/web_TM_GW.xml.j2 file as web.xml.j2
[2023-02-23 16:46:53] INFO - Removed the file ../repository/resources/conf/templates/repository/deployment/server/webapps/authenticationendpoint/WEB-INF/web.xml.j2
[2023-02-23 16:46:53] INFO - Removed the file ../repository/resources/conf/templates/repository/deployment/server/webapps/accountrecoveryendpoint/WEB-INF/web.xml.j2
[2023-02-23 16:46:53] INFO - Removed the api#identity#consent-mgt#v1.0.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:53] INFO - Removed the publisher file from ../repository/deployment/server/webapps
[2023-02-23 16:46:53] INFO - Removed the oauth2.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:53] INFO - Removed the api#am#devops#v0.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:53] INFO - Removed the admin file from ../repository/deployment/server/webapps
[2023-02-23 16:46:53] INFO - Removed the api#am#devportal.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:53] INFO - Removed the api#am#service-catalog#v1.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:53] INFO - Removed the api#identity#recovery#v0.9.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:53] INFO - Removed the api#identity#oauth2#v1.0.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:53] INFO - Removed the internal#data#v1.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:53] INFO - Removed the api#am#publisher.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:53] INFO - Removed the package.json file from ../repository/deployment/server/webapps
[2023-02-23 16:46:54] INFO - Removed the accountrecoveryendpoint file from ../repository/deployment/server/webapps
[2023-02-23 16:46:54] INFO - Removed the api#identity#user#v1.0.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:54] INFO - Removed the api#identity#oauth2#dcr#v1.1.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:54] INFO - Removed the am#sample#calculator#v1.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:54] INFO - Removed the client-registration#v0.17.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:54] INFO - Removed the api#am#admin.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:54] INFO - Removed the lerna.json file from ../repository/deployment/server/webapps
[2023-02-23 16:46:54] INFO - Removed the devportal file from ../repository/deployment/server/webapps
[2023-02-23 16:46:54] INFO - Removed the keymanager-operations.war file from ../repository/deployment/server/webapps
[2023-02-23 16:46:54] INFO - Removed the authenticationendpoint file from ../repository/deployment/server/webapps
Finished the optimizations
Passing the --skipConfigOptimization
option allows you to preserve the configurations that you previously manually applied while optimizing the profile.
Note
Profile optimization using scripts is the recommended approach. Manually optimizing and including the usage of the --skipConfigOptimization
option should be done only in the cases where it can't be avoided.