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. Also, the platform supports the concept of execution profiles, with each profile having different settings.
All of the Linux component installers 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 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 URL | (none) |
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 re-install 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 URL used by services at startup.
# Omit or leave the value blank to use only local configuration files.
#
CONFIG_SERVER_URL=
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 re-install installed components.
User Account Creation
If the user account or group defined in the file don't exist, they 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.