The management components used by Entire Net-Work Client are the System Management Hub (SMH) and the Software AG Directory Server. These components:
Must be installed on a machine in your network that can be accessed by all machines where Entire Net-Work Client will be installed. They should be installed on a dedicated system that is operational 24 hours a day, with a UPS.
Can be installed together on the same machine or individually on separate machines. To reduce resource consumption, Software AG recommends that you install them on the same machine.
Once these management components are installed, you should not need to configure them much for Entire Net-Work Client. The defaults supplied in the Entire Net-Work Client installations of these components should work for most organizations. This is especially true of the Directory Server settings in SMH. Once the appropriate management components, Kernels, and Clients are installed, we recommend that you try to use Entire Net-Work Client in a test environment prior to attempting to configure it.
This document covers the following topics:
Only one System Management Hub (SMH) should be installed in your enterprise. It can be used to manage all Software AG products that use it. However, if you elect to install SMH while running the installation procedure, the procedure automatically checks to see if SMH is already installed and will either update the installed version or perform a new installation of SMH.
Regardless of whether or not SMH has already been installed in your enterprise, you will need to run the SMH installation supplied with Entire Net-Work Client to ensure that the Entire Net-Work Client SMH agents get installed.
The use of an X-terminal or suitable software emulator is recommended for a UNIX installation of SMH. This way, if SMH is installed on a UNIX system, it can be accessed from any suitable Web browser on both Windows or UNIX systems. Software AG does not recommend a particular Web Browser for UNIX use.
Note:
When installing SMH, other Software AG internal components may also
be installed (if they have not already been installed by another Software AG
product). SMH cannot run without these internal products.
One or more Directory Servers can be installed in your enterprise. You may want to install more than one if you are trying to limit access to specific databases by specific Clients. If a Directory Server does not have the URL for a database, any Entire Net-Work Client attempts to access the database will fail. Note, however, that you can use Directory Server partitioning to perform the same function. For more information, read Partitioning a Directory Server.
Software AG recommends that you use only one Directory Server in your enterprise. However, if you install more than one, remember:
You will have to manage and administer multiple Directory Server configurations.
The more Directory Servers you use, the more physical resources on your system will be consumed.
You will need to be very careful about which Directory Server you select to use in your installation of Entire Net-Work Client -- especially if other Directory Servers have been installed by other Software AG products.
As you are restricted to a single pointer to a Directory Server in your DNS (via its SAGXTSDSHOST and SAGXTSDSPORT entries), all systems required to use a different Directory Server must be redirected using local, manual, administration. For more information on this manual administration, contact your Software AG technical support representative.
The Software AG Directory Server uses port number 12731 by default; the port number can be changed to a custom setting during the installation of the Software AG Directory Server. If you need to change the port number after the Directory Server is installed, you will need to reinstall it.
To verify the existence of the Software AG Directory Server, check with your system administrator.
This section describes how to install Entire Net-Work Client management components on Windows systems. Prior to attempting the installation, verify that you have met all of the requirements described in Platform Coverage and Requirements.
Notes:
To install Entire Net-Work Client management components on Windows:
Insert the Entire Net-Work Client installation CD into your CD-ROM drive.
Locate and run the setup.exe file found in the root directory on the CD-ROM.
A Welcome panel appears. The appearance of this panel varies depending on whether this is the first time you have installed an Entire Net-Work component on this machine.
Note:
If you are prompted to "Modify",
"Repair", or "Remove" the
management component software during the course of installing Entire Net-Work Client, please
select the "Modify" option. Selecting
"Modify" will ensure all SMH features are correctly
enabled.
Follow the prompts on the installation panels. The following panels should be noted:
When you get to the Setup Type panel, select Custom to install Entire Net-Work Client management components. The types of installation you can perform are described in the following table.
| Installation Type | Description |
|---|---|
| Typical |
Select this option to install an Entire Net-Work Client only. |
| Custom |
Allows you to choose particular components to install, including the Entire Net-Work Client, the Software AG Directory Server, and the System Management Hub and allows you to direct the installation to a specific directory and to specify a program folder name for the installation. |
On the Select Features panel, select the management components you want to install. You must select either the Directory Server component, the System Management Hub, or both.
If you attempt to install the management components on the same machine as an Entire Net-Work Client, a warning message appears. We recommend that management components be installed on a separate system from the other Entire Net-Work components.
 |
Warning: If you deselect a component already selected when the Select Features panel first appears, that component will be uninstalled when the installation procedure runs. If you do not want to uninstall the component, do not deselect it on this panel; simply select the additional components you want installed. By default, Client Mode is selected when you first access the Select Features panel. If no Client has been installed on this machine, you can safely deselect Client Mode in this instance. |
On the License File Information panel, enter the fully-qualified license file name or click to locate the license file for Entire Net-Work Client.
For more information about the license file, read Entire Net-Work Client License Key.
Indicate whether or not you want to use a named Directory Server for this Client on the Directory Server Detection, Directory Server Access panels
The installation utility installs the software needed to operate Entire Net-Work Client in this order, based on what you selected for installation on the Select Features panel:
Software AG's System Management Hub software
Software AG Directory Server software.
The Setup Status panel displays the current status of the installation process.
This section describes how to install Entire Net-Work Client management components on UNIX systems. Prior to attempting the installation, verify that you have met all of the requirements described in Platform Coverage and Requirements and UNIX Installation Considerations.
Notes:
To install Entire Net-Work management components on UNIX:
Mount the Entire Net-Work CD as described in UNIX Installation Considerations.
Run the setup.ux command:
sh <cd mount dir>/setup.ux
where <cd mount dir> is the directory where the CD is mounted.
A Welcome panel appears.
Follow the prompts on the installation panels. The following areas should be noted:
On the SAG Environment Shell panel, specify the fully-qualified name of the Software AG environment file you want used for this installation.
On the Choose Programs panel, select the Software AG Directory Server. This will install the Directory Server agents for the System Management Hub (SMH) and will also automatically install SMH if it is not already installed.
If you attempt to install the management components on the same machine as an Entire Net-Work Client, a warning message appears. We recommend that management components be installed on a separate system from the other Entire Net-Work Client components.
On the Directory Server - Agents panel, select Directory Server to install the Software AG Directory Server software. Select ADI Agents to install the SMH agents for the Software AG Directory Server.
The default ports listed on the installation panels should be acceptable for most installations. They can, however, be changed should your configuration require it.
To avoid port number conflicts during installation, read Port Number Reference for a general list of the ports used by Software AG products.
Some of the installation steps will be performed as superuser, so you are prompted during the installation to indicate whether you will be using su or sudo commands. If using su commands, supply the root password in the Root's password text box; if using sudo commands, supply your own password in the Root's password text box.
Note:
If you select No command from the
Use drop-down list box on the installation panels that
request this superuser information, the installation may not proceed as
expected. Therefore, we recommend that you do not choose No
command.
When specifying the proper path for the installed Java runtime module (JRE), be sure to specify the location of JRE itself, not JDK. In other words, the path specified should end in "/jre". If you do not specify a valid path to JRE, errors will occur before you can proceed.
As part of the SMH installation process, a couple of popup windows appear describing the lines you should add to the configuration of an Apache or Sun Java System Web server if you want to enable the Software AG Management Independent Layer. Make note of the information on the Web server popup windows and click on both of them.
On the Activate Installed Products panel, select the products for which you want the Software AG environment file (sagenv.new) created.
Change to the Software AG installation directory and run sagenv.new to set up the environment for Software AG products.
. sagenv.new
The installation and deployment of Entire Net-Work management components in UNIX is complete.
