System Configuration for DSS Agent on Unix - DSS 6 | Data Source Solutions Documentation
Documentation: System Configuration for DSS Agent on Unix - DSS 6 | Data Source Solutions Documentation
System Configuration for DSS Agent on Unix
This section describes the system configuration required for an DSS Agent installed on Unix. The steps mentioned on this page are normally performed while Installing DSS Agent on Unix (step - Configure the system for DSS Agent).
There are different ways for configuring the DSS Agent to listen on a TCP/IP port:
- Unix inetd
Standard on older Unix distributions. Requires root privilege. - Solaris Service Management Facility (SMF)
Used on Solaris (versions 10 and higher) distributions. Requires root privilege. - DSS Agent Listener
Our own daemon dssagentlistener. Does not require root privilege.
Unix inetd
The following steps should be performed as user root to configure the inetd service:
-
In the /etc/services file, add the following line specifying the name (e.g. mydss) and the TCP/IP port number of the DSS Agent:
mydss 4343/tcp #Port for DSS Agent -
Add the following line to /etc/inetd.conf file:
mydss stream tcp nowait datasourcesolutions /home/datasourcesolutions/dss_home/bin/dssagent dssagent -EDSS_HOME=/home/datasourcesolutions/dss_home -EDSS_CONFIG=/home/datasourcesolutions/dss_config -EDSS_TMP=/home/datasourcesolutions/dss_tmp- The user must be set to the user (e.g. datasourcesolutions) under which DSS Agent is installed/running.
- The service name (e.g. mydss) specified in this inetd.conf file must match with the name specified (step #1) in the /etc/services file.
- The above configuration should be defined in a single line (without manual line break).
<div class="callout callout-note">Option
<b>-E</b>defines the environment variables. - The user must be set to the user (e.g. datasourcesolutions) under which DSS Agent is installed/running.
- Reload or restart the inetd service to apply the changes. For information about restarting the inetd service, refer to the operating system documentation.
Solaris Service Management Facility (SMF)
In Solaris 10 and higher, the /etc/inetd.conf file has been replaced by SMF manifests. All inetd services are now configured/controlled under the SMF. The following steps should be performed as user root to configure the SMF service:
-
In the /etc/services file, add the following line specifying the name (e.g. mydss) and the TCP/IP port number of the DSS Agent:
mydss 4343/tcp #Port for DSS Agent -
Create a temporary file (e.g. /tmp/inet.dss) containing the following inetd.conf-style entry for the DSS Agent:
mydss stream tcp nowait datasourcesolutions /home/datasourcesolutions/dss_home/bin/dssagent dssagent -EDSS_HOME=/home/datasourcesolutions/dss_home -EDSS_CONFIG=/home/datasourcesolutions/dss_config -EDSS_TMP=/home/datasourcesolutions/dss_tmp- The user must be set to the user (e.g. datasourcesolutions) under which the DSS Agent is installed/running.
- The service name (e.g. mydss) specified in this temporary file must match with the name specified (step #1) in the /etc/services file.
- The above configuration should be defined in a single line (without manual line break).
<div class="callout callout-note">Option
<b>-E</b>defines the environment variables. - The user must be set to the user (e.g. datasourcesolutions) under which the DSS Agent is installed/running.