This document covers the following topics:
The person performing the installation must have Windows system administrator privileges (Windows platforms).
During the installation, the Sudo panel may appear. When you enter the sudo password in this panel, the installer will execute the scripts which require sudoers privileges. For you to use sudo in the installer, the user that you are using to install must be in the sudoers configuration. (Unix/Linux).
During the installation, you are asked to specify an installation directory. Specify the installation directory in which to install your Software AG products. The user that you are using to install must have full read and write permissions to this directory.
The default installation directory under Windows is
SoftwareAG and under Unix/Linux is
/opt/softwareag, but any other directory
is also possible. In the following description the placeholder
<install-dir> is used to
represent the installation directory.
You can only install Adabas Manager on a local hard drive on a Windows/Linux system. You cannot install Adabas Manager on a network-mounted drive or a SUBST drive (Windows only).
You can install the same Adabas Manager version more than once on the same machine. And you can also install several different versions of Adabas Manager on the same machine. This may be necessary to test a new Adabas Manager version before it is taken over into a production environment. Each version, however, must be installed in a separate directory and on Windows you must specify a separate Start menu group name. That is, when Adabas Manager is already installed, for example, in the directory SoftwareAG or /opt/softwareag, you can install a second instance of Adabas Manager, for example, in a directory named SoftwareAG2 or /opt/softwareag2.
Since Software AG Empower only offers the latest version of Adabas Manager and other products, it is recommended that you create and keep an image of installed Adabas Manager versions for possible later use. Installing from an image rather than downloading it from Empower will usually be faster, too. For further information, see Using the Software AG Installer.
While Adabas Manager is being installed, it is not possible for another user to install Adabas Manager on the same machine. A message with the following information will then be shown: the name of the user who is currently installing Adabas Manager, when this installation has been started, and into which directory Adabas Manager is currently being installed.
Before you start Adabas Manager for the first time, you should be aware that Adabas Manager stores user-related data, such as user IDs, in configuration files and log files.
| File Path |
Windows:
Unix/Linux:
|
| Content |
|
| Administration |
User IDs in the entries can be managed (created, modified, deleted) by the owner of the configuration file from within the Adabas Manager. If a user ID is deleted, there is no longer access to the respective Adabas REST administration server with this user ID. |
| Access |
Access to the configuration file and its directory can be secured, based on operating system file permissions. |
| Deletion |
Single entries in the file: see Administration above. File: manually or automatically by operating system means or scripts. |
Important:
for existing users of Adabas Manager 8.5, who are upgrading
to Adabas Manager 8.6, Adabas Manager will automatically combine the 2 old
files adaHost_<uid>.config and
netHost_<uid>.config into the new file
host_<uid>.config. The user can then manually remove
the files adaHost_<uid>.config and
netHost_<uid>.config after
host_<uid>.config has been created. Users who only
install Adabas Manager 8.6 (without having previously installed Adabas Manager
8.5), only have 1 file (host_<uid>.config) for each
login UserID. (where <uid> stands for <User-ID>)
| File Path |
Windows:
Unix/Linux:
|
| Content |
Contains user IDs. |
| Administration |
Not possible via Adabas Manager. |
| Access |
Access to the configuration file and its directory can be secured, based on operating system file permissions. |
| Deletion |
Single entries in the file: manually or automatically by operating system means or scripts. File: manually or automatically by operating system means or scripts. |
In order to access Adabas Manager and Adabas databases (on Linux and Windows) that are installed on a remote host (e.g. on machine 1) from an internet browser (e.g. on machine 2), it is necessary to open the ports on machine 1, for example the default Adabas Manager port (8083) and the Adabas REST server administration port (8190). Similarly, in order to use Adabas Manager Communicator (AMC) installed remotely, it is necessary to open the port (default 4980), to allow incoming requests.
Important:
the following known restriction applies - in order to use
the HTTPS port (default 8084) on Adabas Manager, the Adabas Administration
Server needs to be connected via an HTTPS port (default 8191). Currently, it is
not possible to use HTTPS on Adabas Manager together with Adabas Manager
Communicator (AMC) to administer Entire Net-Work.
After installation, a
sag<n>amnpam service (where
<n> is the number of the
installed instance) and various shell scripts for use with the
amnpam service are available in the
$SAG/AdabasManager/bin/ directory.
The purpose of the Adabas Manager PAM server is to communicate with the Pluggable Authentication Module (PAM) in Unix, which in turn allows users to login to Adabas Manager using the Linux Operating System ID (i.e. those IDs created into the \etc\passwd file).
The Adabas Manager PAM server will be started after the user has executed the AfterInstallAsRoot.sh script.
In the event that the
sag<n>amnpam service is not
running properly, please execute the script amnpam_rc.sh
stop, followed by an execution of the script amnpam_rc.sh
start with sudo, to restart the amnpam service.
The Adabas Manager web pages are rendered by the Software AG Common Runtime. Adabas Manager uses the HTTP port (default port 8083) that it provides. For further information, please refer to the Software AG Infrastructure Administrator’s Guide.