This document covers the following topics:
This document describes the installation procedure for the RPM version of EntireX DCOM. The default installation directory is /opt/sag. The installation must be performed as root user. The user sag and a group sag are also 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.
Note:
Throughout this documentation, the abbreviation
vrs stands for the current version, release and
system maintenance level of the software.
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 log in as user sag and the EntireX DCOM environment will be set. All other users have to source the corresponding environment file to set the EntireX DCOM environment. The environment file can be found under /opt/sag/exx/vrs/INSTALL/exxenv (if /opt/sag is not the installation directory, the path name can be different). Before sourcing the environment file, the environment variable SAG must be set to the installation directory (e.g. /opt/sag).
This version contains the following files, which are located in directory <dvd-root>/unix/linux/exx/v<nn>ng32 and are available for 32-bit Linux only:
drvrs<nn>.rpm (DCOM Runtime)
dsvrs<nn>.rpm (DCOM SDK)
For licensing, a third rpm package is necessary.
The DVD version of EntireX contains a file dlvrs<nn>.rpm. Before installing this rpm packet, copy a valid license file either to /root or to /opt/sag/common/LKey.
In the download version of EntireX DCOM, you will find a file dcom-license-vv.r.s-<nn>.i686.rpm which contains a trial license file.
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.rpm for the license package
d4r73300.rpm for the runtime package
d4s73300.rpm for the SDK package
To install EntireX DCOM vrs
You must be logged on as user root.
Provide a valid license file either in /root or in /opt/sag/common/LKey.
Enter the following commands:
rpm -i dlvrs<nn>.rpm rpm -i drvrs<nn>.rpm rpm -i dsvrs<nn>.rpm
If you have installed your own compiler instead of the supplied gcc
compiler and the binutils, you will need to install the DCOM packages with the
option --nodeps --force.
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:
rpm --relocate /opt/sag=/usr/SAG -i dlvrs<nn>.rpm rpm --relocate /opt/sag=/usr/SAG -i drvrs<nn>.rpm rpm --relocate /opt/sag=/usr/SAG -i dsvrs<nn>.rpm
In this example, the installation directory will be changed to /usr/SAG
To uninstall EntireX DCOM vrs
Enter the following commands:
rpm -e dcom-sdk rpm -e dcom rpm -e dcom-license
This installation will configure the authentication method to local
authentication (paulad -local), 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.
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
> >
>
.
