For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.
Configure an external database with a IBM MobileFirst Platform Foundation System Pattern
We can configure IBM MobileFirst™ Platform Foundation System Patterns to enable connecting out to an external database. IBM® DB2® is the only supported external database. The configuration is common for all the supported patterns.
Before you begin
This procedure involves configuring the external database parameters for connecting to the external database. Before you begin, ensure the following:
- Configure the external database instance on your installed IBM DB2.
- Make a note of the database instance name, database user name, database password, database host name or IP and database instance port.
Procedure
- Build a pattern with any topology you need. For more information, see the following topics:
- Deploy MobileFirst Server on a single-node WebSphere Application Server Liberty profile server
- Deploy MobileFirst Server on a multiple-node WebSphere Application Server Liberty profile server
- Deploy MobileFirst Server on a single-node WebSphere Application Server full profile server
- Deploy MobileFirst Server on a multiple-node WebSphere Application Server full profile server
- Deploy MobileFirst Server on clusters of WebSphere Application Server Network Deployment servers
- Select the MobileFirst Platform DB and click Remove component.
- Configure MobileFirst Server administration:
- In IBM PureApplication® System, in the dashboard, click Patterns > Virtual System Patterns. The Virtual System Patterns page opens.
- On the Virtual System Patterns page, use the Search field to find and select the pattern you created, and then click Open to open the Pattern Builder page.
- In the MobileFirst Platform Server node (or the DmgrNode node when using the MobileFirst Platform (WAS ND) template), select the MFP Server Administration component. The properties of the selected component are displayed next to the canvas.
- Check the option USE_EXTERNAL_DATABASE and configure the following parameters:
- db_instance
- External database instance name.
- db_user
- External database user name.
- db_name
- External database name.
- db_password
- External database password.
- db_ip
- External database IP.
- db_port
- External database port number.
Note: If you are using the MobileFirstPlatform (WAS ND) pattern template, you will need to additionally configure the attribute Open firewall ports for WAS to the external database port number.
- In the MobileFirst Platform Server node (or the DmgrNode node when using the MobileFirst Platform (WAS ND) template), select the MFP Server Runtime Deployment component. The properties of the selected component are displayed next to the canvas.
- Under the USE_EXTERNAL_DATABASE configure the following parameters:
- rtdb_instance
- External database instance name.
- rtdb_user
- External runtime database user name.
- rtdb_name
- External runtime database name, which will be created.
- rtdb_password
- External runtime database password.
- Configure and launch the pattern deployment. For more information about pattern deployment, see the "Configure and launch the pattern deployment" step in one of the following topics depending on the topology you selected when creating the pattern;
- Deploy MobileFirst Server on a single-node WebSphere Application Server Liberty profile server, step 8
- Deploy MobileFirst Server on a multiple-node WebSphere Application Server Liberty profile server, step 9
- Deploy MobileFirst Server on a single-node WebSphere Application Server full profile server, step 8
- Deploy MobileFirst Server on a single-node WebSphere Application Server full profile server, step 9
- Deploy MobileFirst Server on clusters of WebSphere Application Server Network Deployment servers, step 9 onwards.
Parent topic: Deploy MobileFirst Server on IBM PureApplication System