Preparing to Install on Linux
The Streaming Integration Platform components run as systemd services under the context of a user account, and on Linux each user account is assigned to a primary user group. The platform supports the concept of execution profiles, with each profile having different settings.
All of the Linux component installers can read configuration information from the file /etc/sysconfig/sip.conf. You can create this file to define configuration settings, but if you don't, the file will be created by the first component you install and will contain the default values shown below. This ensures that any components you subsequently install will use the same values.
| Setting | Default value |
|---|---|
| Service user account | sip-service |
| Service user group | sip-service |
| Profile name | default |
| Config server host | (none) |
| Config Server port | 5121 |
| ISAM Agent port | 5126 |
| SQL Agent port | 5127 |
| JSON Agent port | 5128 |
If /etc/sysconfig/sip.conf does not exist and you want to use default settings, you can proceed to installing the necessary components on the system.
Customizing Configuration Settings
To use custom configuration settings, you should create and configure /etc/sysconfig/sip.conf before installing any components on the system:
#
# Streaming Integration Platform Installation Overrides
#
# The configuration values specified in this file are used only during the
# installation of the following components on this system:
#
# - Base Environment (message-broker and snapshot-agent)
# - ISAM Agent
# - JSON Agent
# - SQL Agent
#
# Changing these values after initial installation will not have any effect
# unless you uninstall and reinstall all of the above components that are
# currently installed on this system.
# This is the user account that services will run as. If the specified user
# does not exist at installation time, it will be created as a service account
# with no login shell and no home directory. If the specified user already
# exists at installation time, it will be used without modification.
#
SVC_USER=sip-service
#
# This is the group that services will run as. If the specified group does not
# exist at installation time, it will be created. If the specified group already
# exists at installation time, it will be used without modification.
#
SVC_GROUP=sip-service
#
# This is the configuration profile that will be used when services start.
#
PROFILE=default
#
# This is the Configuration Server host name or IP address used by services
# at startup. Leave this blank to omit the --config-server command line option.
#
CONFIG_SERVER_HOST=
#
# Optional HTTPS service ports.
#
CONFIG_SERVER_PORT=5121
ISAM_AGENT_PORT=5126
SQL_AGENT_PORT=5127
JSON_AGENT_PORT=5128
The information in /etc/sysconfig/sip.conf is used only by the component installers. Changing the file after installation will not affect currently installed components. To change the user account, group, or profile name, you must remove and reinstall installed components.
User Account Creation
If the user account or group defined in the file doesn't exist, it will be created when you install the first component. A user account created this way will be a service account with no login shell, no home directory, and no root permissions.
Configuration Files
If Configuration Server has not been deployed in your environment, you will need to provide several configuration files and place them in the appropriate directories for the components that you will deploy.