Script to run MobileFirst Server in container group

For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.

Script to run MobileFirst Server in container group | startservergroup.sh

This script runs a MobileFirst Server image as a container group on IBM® Containers on Bluemix®. Before running startservergroup.sh, ensure that you have run the prepareserver.sh script to upload the container image to the IBM Containers registry.

Table 1. Mandatory command-line arguments
Command-line argument Description
[-t|--tag] SERVER_IMAGE_TAG The name of the MobileFirst Server container image in the Bluemix registry.
[-gn|--name] SERVER_CONTAINER_NAME The name of the MobileFirst Server container group.
[-gh|--host] SERVER_CONTAINER_GROUP_HOST The host name of the route.
[-gs|--domain] SERVER_CONTAINER_GROUP_DOMAIN The domain name of the route.

Usage example:
startservergroup.sh
 --tag image_name
 --name container_group_name
 --host container_group_host_name
 --domain container_group_domain_name
Table 2. Optional command-line arguments
Command-line argument Description
[-gm|--min] SERVERS_CONTAINER_GROUP_MIN The minimum number of container instances. The default value is 1.
[-gx|--max] SERVER_CONTAINER_GROUP_MAX The maximum number of container instances. The default value is 1.
[-gd|--desired] SERVER_CONTAINER_GROUP_DESIRED The desired number of container instances. The default value is 2.
[-a|--auto] ENABLE_AUTORECOVERY Enable the automatic recovery option for the container instances. Accepted values are Y or N (default).
[-si|--services] SERVICES Comma-separated Bluemix service instance names that we want to bind to the container.
[-tr|--trace] TRACE_SPEC The trace specification to be applied.
Default: *=info
[-ml|--maxlog] MAX_LOG_FILES The maximum number of log files to maintain before they are overwritten. The default is 5 files.
[-ms|--maxlogsize] MAX_LOG_FILE_SIZE The maximum size of a log file. The default size is 20 MB.
[-e|--env] MFPF_PROPERTIES Specify MobileFirst properties as comma-separated key:value pairs. Example: mfp.analytics.url:http://127.0.0.1/analytics-service/rest mfp.analytics.console.url:http://127.0.0.1/analytics/console
Note: If you specify properties using this script, ensure that the same properties have not been set in the configuration files in the usr/config folder.
[-m|--memory] SERVER_MEM Assign a memory size limit to the container in megabytes (MB). Accepted values are 1024 MB (default) and 2048 MB.
[-v|--volume] ENABLE_VOLUME Enable mounting volume for container logs. Accepted values are Y or N (default).

Learn more about creating scalable container groups.

Parent topic: Script overview and usage


Command-line argument	Description
[-t\|--tag] SERVER_IMAGE_TAG	The name of the MobileFirst Server container image in the Bluemix registry.
[-gn\|--name] SERVER_CONTAINER_NAME	The name of the MobileFirst Server container group.
[-gh\|--host] SERVER_CONTAINER_GROUP_HOST	The host name of the route.
[-gs\|--domain] SERVER_CONTAINER_GROUP_DOMAIN	The domain name of the route.


Command-line argument	Description
[-gm\|--min] SERVERS_CONTAINER_GROUP_MIN	The minimum number of container instances. The default value is 1.
[-gx\|--max] SERVER_CONTAINER_GROUP_MAX	The maximum number of container instances. The default value is 1.
[-gd\|--desired] SERVER_CONTAINER_GROUP_DESIRED	The desired number of container instances. The default value is 2.
[-a\|--auto] ENABLE_AUTORECOVERY	Enable the automatic recovery option for the container instances. Accepted values are Y or N (default).
[-si\|--services] SERVICES	Comma-separated Bluemix service instance names that we want to bind to the container.
[-tr\|--trace] TRACE_SPEC	The trace specification to be applied. Default: *=info
[-ml\|--maxlog] MAX_LOG_FILES	The maximum number of log files to maintain before they are overwritten. The default is 5 files.
[-ms\|--maxlogsize] MAX_LOG_FILE_SIZE	The maximum size of a log file. The default size is 20 MB.
[-e\|--env] MFPF_PROPERTIES	Specify MobileFirst properties as comma-separated key:value pairs. Example: mfp.analytics.url:http://127.0.0.1/analytics-service/rest mfp.analytics.console.url:http://127.0.0.1/analytics/console Note: If you specify properties using this script, ensure that the same properties have not been set in the configuration files in the usr/config folder.
[-m\|--memory] SERVER_MEM	Assign a memory size limit to the container in megabytes (MB). Accepted values are 1024 MB (default) and 2048 MB.
[-v\|--volume] ENABLE_VOLUME	Enable mounting volume for container logs. Accepted values are Y or N (default).