This document covers the following topics:
This document describes the installation procedure for the tgz version of EntireX DCOM. The default installation directory is $HOME/sag. The installation can also be performed as user root; if user root executes the installation, the directory is /opt/sag and the user sag and a group sag are required. If they do not exist, the installation will create them. The user sag created by the installation will have UID 507 and will belong to group sag which is created with GID 107. The password for user sag is set to sag. We recommend you change the password as soon as possible. If the installation is executed as regular user, no user and group are created.
Note:
Throughout this documentation, the abbreviation
vrs stands for the current version, release and
system maintenance level of the software.
If the installation is executed as user root, the user sag will be the user under which EntireX DCOM is started at boot time. It is also possible to use a different user or group. To do so you need to change the file /etc/dcom/ntd.conf after installing the license package. There are five entries which can be changed:
| Item | Description |
|---|---|
| DCOM_USER | The user ID under which EntireX DCOM is started. |
| DCOM_UID | The numerical user ID for DCOM_USER. |
| DCOM_PASSWD | The initial password for DCOM_USER if the user does not exist and must be created during installation. After installation this line will be deleted in this file. |
| DCOM_GROUP | The group to which the DCOM_USER should belong. |
| DCOM_GID | The numerical group ID for DCOM_GROUP. |
If any of these already exist, the existing will be used. We recommend not changing any other entries in this file.
After installation you can source the environment file. The environment file can be found under /opt/sag/exx/vrs/INSTALL/exxenv or $HOME/sag/exx/vrs/INSTALL/exxenv. Before sourcing the environment file, the environment variable SAG must be set to the installation directory.
This version contains four files:
dco-inst (install script)
drvrs<nn>.tgz (DCOM Runtime)
dsvrs<nn>.tgz (DCOM SDK)
dsvrs<nn>.tgz (DCOM License)
Before installing the license packet, copy a valid license file to $HOME.
Note:
In the file names, <nn> indicates
the current patch level.
There is also a version based on gcc 4.0. The installation and uninstallation procedure is the same as for the gcc 3.3 based version.
The file names for this version are:
d4l73300.tgz for the license package
d4r73300.tgz for the runtime package
d4s73300.tgz for the SDK package
dco4inst for the install script
To install EntireX DCOM vrs
Provide a valid license file either in /opt/sag/common/LKey or in $HOME.
Enter the following commands:
dco-inst -i license dco-inst -i runtime dco-inst -i sdk
To install EntireX DCOM vrs in a directory
other than /opt/sag
Provide a valid license file either in /root or in /opt/sag/common/LKey.
Enter the following commands:
dco-inst -i license --relocate<inst-pathdco-inst -i runtime --relocate<inst-path dco-inst -i sdk --relocate<inst-path
To uninstall EntireX DCOM vrs
Enter the following commands:
dco-inst -e sdk dco-inst -e runtime dco-inst -e license
This installation will configure the authentication method to local
authentication, i.e. paulad -local. There will be no
entry in the local password file. Entries can be added with the ntpasswd tool
(use ntpasswd). For details on how to change the
authentication method to NT Domain authentication, see EntireX DCOM
Security.
The startup script for EntireX DCOM is called ntd and is located in /etc/init.d if the installation was executed as user root.
SUSE Linux
The EntireX DCOM runtime environment can be started and activated via
> >
>
.
Red Hat
The EntireX DCOM runtime environment can be started and activated via
> >
>
.
