The management components used by Entire Net-Work 7 are the Entire Net-Work Administration Open Systems 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 will be installed (both Entire Net-Work Server and Entire Net-Work Client). 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. The defaults supplied in the Entire Net-Work 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, servers, and clients are installed and appropriate Kernels are defined, we recommend that you try to use Entire Net-Work in a test environment prior to attempting to configure it further.
This document covers the following topics:
One or more Directory Servers can be installed in your enterprise although Software AG recommends that you use only one Directory Server in your enterprise. However, if you elect to install more than one, remember:
You will have to manage and administer multiple Directory Server configurations.
You will need to be very careful about which Directory Server you select to use in your installations of Entire Net-Work Client, Entire Net-Work Server, and Entire Net-Work Administration Open Systems -- 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.
Software AG has registered port number 4952 with the Internet Assigned Numbers Authority (IANA) for use by the Software AG Directory Server. You are not required to use this port number for the Directory Server and can change it. For complete information on the port used by the Directory Server, read The Directory Server Port Number.
To verify the existence of the Software AG Directory Server, check with your system administrator.
In an OpenVMS installation, the installation of a Directory Server occurs as part of the polycenter installation if requested. You can also install a Directory Server later by running the installadi.com procedure. This procedure prompts you for the Directory Server port number and creates the adienv.com environment file and all of the other needed command procedures required to run Directory Server in OpenVMS. The adienv.com environment file contains the following environment settings:
| Environment Setting Name | Default Setting |
|---|---|
| ADIDIR | SAG$ROOT:[ADI] |
| ADIVERS | V521 |
If SMH has already been installed in your enterprise, you still need to run the Entire Net-Work Administration Open Systems installation supplied with the Software AG Directory Server installation code. This Entire Net-Work Administration Open Systems installation for Directory Server should be run on the machine where SMH is installed. This will ensure that the Software AG Directory Server SMH agents get installed properly.
This section covers the following topics:
This section describes how to install Software AG Directory Server on Windows systems. .
To install a Software AG Directory Server on Windows:
Insert the Entire Net-Work installation CD into your CD-ROM drive.
The following executable files can be found on the CD:
| Executable File Name | Use to Install Component | Description |
|---|---|---|
| ADISETUP.EXE | Software AG Directory Server | Run this executable file to install the
Software AG Directory Server. Entire Net-Work requires that the Directory Server be available to the
installation or that it be installed as part of the installation.
If the Directory Server has already been installed in your enterprise, you do not need to install it again -- although multiple installations of the Directory Serverin the enterprise are allowed. If you elect to install the Software AG Directory Server, its installation must occur before any other components you might also select to install. |
| WCPSETUP.EXE | Entire Net-Work Server | Run this executable file to install Entire Net-Work Server. |
| WCLSETUP.EXE | Entire Net-Work Client | Run this executable file to install Entire Net-Work Client.
The installation of Entire Net-Work Client always includes the installation of the Adabas Client software. |
| WCBSETUP.EXE | Entire Net-Work Administration Open Systems | Run this executable file to install the System
Management Hub (SMH) as well as all the agents necessary to perform Directory Server
maintenance.
If SMH is already installed in your enterprise, it should not be installed again. Only one SMH is required to manage all Software AG products that require it. However, you should run this installation on the machine on which SMH is installed to ensure that the Software AG Directory Server agents required for SMH are installed. Note: For more information about installing and using the Entire Net-Work management components, see Entire Net-Work Administration Open Systems Installation. |
Locate and run the appropriate executable file on the CD-ROM. If you only want to install Software AG Directory Server, only run ADISETUP.EXE.
The Welcome panel appears.
Follow the prompts on the installation panels. The following panels should be noted:
On the Choose Destination panel, use the button to search for and identify the location where the Directory Server should be installed.
When the Directory Server Port Assignment panel appears, specify the port number of the Directory Server that should be used for this installation. For complete information on the port used by the Directory Server, read The Directory Server Port Number.
If the installation is not successful, you will receive one of several possible error messages. Contact your local distributor for information about customer support services. If the installation fails, it is likely that some parts of the product will have been installed. Therefore, before you attempt to install Entire Net-Work Server again, run the installation program to remove it. See Uninstalling Entire Net-Work Administration Open Systems or the Directory Server for instructions on removing the product.
This section describes how to install Software AG Directory Server on UNIX systems.
To install a Software AG Directory Server on UNIX:
Shut down all open applications, especially those applications interacting with or depending on your Adabas databases. This includes Natural, the Adabas DBA Workbench, and prior releases of Entire Net-Work.
Mount the Entire Net-Work CD as described in .
Run the setup.ux command:
sh <cd mount dir>/setup.ux
where <cd mount dir> is the directory where the CD is mounted.
The Welcome panel appears.
Follow the prompts on the installation panels. The following panels should be noted:
Some of the installation steps must be performed as superuser. Specifically, if you want to elect to run the Entire Net-Work Server service as a system service (one of the installation panels will ask you this), you must have superuser privileges.
On the Destination Location panel, you can change the $SAG environment variable, which identifies where your Software AG products are installed.
When you get to the SAG Environment Shell panel, verify the path and file name of the SAG environment file. The default name is sagenv.new. If you would like to change it, type the fully qualified name of the Software AG environment file you want used for this installation, or click the button to locate an existing file.
When you get to the Choose Programs panel, you have the option to install four Entire Net-Work components, as described in the table below. If you only want to install Software AG Directory Server, select only "Software AG Directory Server".
| Component Name | Description |
|---|---|
| Software AG Directory Server | Select this option to install the Software AG Directory Server.
Entire Net-Work requires that the Directory Server be available to the installation or that
it be installed as part of the installation.
If the Directory Server has already been installed in your enterprise, you do not need to install it again -- although multiple installations of the Directory Server in the enterprise are allowed. If you elect to install the Software AG Directory Server, its installation must occur before any other components you might also select to install. |
| Entire Net-Work Server | Select this option to install Entire Net-Work Server. |
| Entire Net-Work Client | Select this option to install Entire Net-Work Client.
The installation of Entire Net-Work Client always includes the installation of the Adabas Client software. |
| Entire Net-Work Administration Open Systems | Select this option to install the System
Management Hub (SMH) as well as all the agents necessary to perform Directory Server
maintenance.
If SMH is already installed in your enterprise, it should not be installed again. Only one SMH is required to manage all Software AG products that require it. However, you should run this installation on the machine on which SMH is installed to ensure that the Software AG Directory Server agents required for SMH are installed. Note: For more information about installing and using the Entire Net-Work management components, see Entire Net-Work Administration Open Systems Installation. |
You will be prompted for the port number to use for this Directory Server installation. For complete information on the port used by the Directory Server, read The Directory Server Port Number.
During the course of the installation, a panel appears prompting you to indicate whether you want the Directory Server service installed as a system service. For complete information about installing Entire Net-Work component services as system services, read Installing and Running Entire Net-Work Component Services as System Services on UNIX.
If you do not elect to run the Directory Server service as a system service, a window will appear asking you whether the Directory Server service should be started automatically by the installation.
We recommend that you read the post-installation README file. Click when you done reading the file.
The installation of Software AG Directory Server is complete. However, its environment is not yet activated.
After all the Entire Net-Work components you selected on the Choose Programs panel have been installed and when you click on the Readme panel for the last one, the Activate Installed Products panel appears. Select all the products listed on the panel. The Software AG environment file is called, by default, sagenv.new and is created for the list of products you select.
When finished with the Activate Installed Products panel, click and the full installation of the product completes. You must then activate the environment for the Software AG products you selected in the Software AG environment file. To do this, change to the installation directory and run sagenv.new:
. sagenv.new
The installation and deployment of the Software AG Directory Server in UNIX is complete.
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.
If SMH has already been installed in your enterprise, you still need to run the Entire Net-Work Administration Open Systems installation supplied with the Directory Server, Entire Net-Work Client and Entire Net-Work Server installations on the machine where SMH is installed to ensure that the Directory Server, Entire Net-Work Client or Entire Net-Work Server 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.
Notes:
This section covers the following topics:
This section describes how to install Entire Net-Work Administration Open Systems on Windows systems.
To install an Entire Net-Work Administration Open Systems on Windows:
Insert the Entire Net-Work installation CD into your CD-ROM drive.
The following executable files can be found on the CD:
| Executable File Name | Use to Install Component | Description |
|---|---|---|
| ADISETUP.EXE | Software AG Directory Server | Run this executable to install the Software AG Directory Server.
Entire Net-Work requires that the Directory Server be available to the installation or that
it be installed as part of the installation.
If the Directory Server has already been installed in your enterprise, you do not need to install it again -- although multiple installations of the Directory Server in the enterprise are allowed (for more details, read Software AG Directory Server Installation). If you elect to install the Software AG Directory Server, its installation must occur before any other components you might also select to install. |
| WCPSETUP.EXE | Entire Net-Work Server | Run this executable to install Entire Net-Work Server. |
| WCLSETUP.EXE | Entire Net-Work Client | Run this executable to install Entire Net-Work Client.
The installation of Entire Net-Work Client always includes the installation of the Adabas Client software. |
| WCBSETUP.EXE | Entire Net-Work Administration Open Systems | Run this executable to install the System
Management Hub (SMH) as well as all the agents necessary to perform Entire Net-Work
maintenance.
If SMH is already installed in your enterprise, it should not be installed again. Only one SMH is required to manage all Software AG products that require it. However, you should run this installation on the machine on which SMH is installed to ensure that the Entire Net-Work agents required for SMH are installed. Note: |
Locate and run the appropriate executable file on the CD-ROM. If you only want to install Entire Net-Work Administration Open Systems, only run WCBSETUP.EXE.
The Welcome panel appears.
Follow the prompts on the installation panels. The following panels should be noted:
On the Installation Instructions panel, read the installation instructions and click to continue. If you click , the installation will stop.
On the License Agreement panel, read the installation instructions and click to accept the license agreement and continue. If you click , the installation will stop.
When the Directory Server Access panel appears, specify the host name (or IP address) and port number of the Directory Server that should be used by this installation. For complete information on the port used by the Directory Server, read The Directory Server Port Number.
If the installation is not successful, you will receive one of several possible error messages. Contact your local distributor for information about customer support services. If the installation fails, it is likely that some parts of the product will have been installed. Therefore, before you attempt to install Entire Net-Work Server again, run the installation program to remove it. See Uninstalling Entire Net-Work Administration Open Systems or the Directory Server for instructions on removing the product.
This section describes how to install Entire Net-Work Administration Open Systems on UNIX systems.
To install an Entire Net-Work Administration Open Systems on UNIX:
Shut down all open applications, especially those applications interacting with or depending on your Adabas databases. This includes Natural, the Adabas DBA Workbench, and prior releases of Entire Net-Work.
Mount the Entire Net-Work CD as described in .
Run the setup.ux command:
sh <cd mount dir>/setup.ux
where <cd mount dir> is the directory where the CD is mounted.
The Welcome panel appears.
Follow the prompts on the installation panels. The following panels should be noted:
Some of the installation steps must be performed as superuser. Specifically, if you want to elect to run the Entire Net-Work Server service as a system service (one of the installation panels will ask you this), you must have superuser privileges.
On the Destination Location panel, you can change the $SAG environment variable, which identifies where your Software AG products are installed.
When you get to the SAG Environment Shell panel, verify the path and file name of the SAG environment file. The default name is sagenv.new. If you would like to change it, type the fully qualified name of the Software AG environment file you want used for this installation, or click the button to locate an existing file.
When you get to the Choose Programs panel, you have the option to install four Entire Net-Work components, as described in the table below. If you only want to install Entire Net-Work Administration Open Systems, select only "Entire Net-Work Administration Open Systems".
| Component Name | Description |
|---|---|
| Software AG Directory Server | Select this option to install the Software AG Directory Server.
Entire Net-Work requires that the Directory Server be available to the installation or that
it be installed as part of the installation.
If the Directory Server has already been installed in your enterprise, you do not need to install it again -- although multiple installations of the Directory Server in the enterprise are allowed (for more details, read Software AG Directory Server Installation). If you elect to install the Software AG Directory Server, its installation must occur before any other components you might also select to install. |
| Entire Net-Work Server | Select this option to install Entire Net-Work Server. |
| Entire Net-Work Client | Select this option to install Entire Net-Work Client.
The installation of Entire Net-Work Client always includes the installation of the Adabas Client software. |
| Entire Net-Work Administration Open Systems | Select this option to install the System
Management Hub (SMH) as well as all the agents necessary to perform Entire Net-Work
maintenance.
If SMH is already installed in your enterprise, it should not be installed again. Only one SMH is required to manage all Software AG products that require it. However, you should run this installation on the machine on which SMH is installed to ensure that the Entire Net-Work agents required for SMH are installed. Note: |
The Directory Server Access panel will appear requesting the location of the Directory Server you want used with this Entire Net-Work Administration Open Systems installation. For complete information on the port used by the Directory Server, read The Directory Server Port Number.
We recommend that you read the post-installation README file. Click when you done reading the file.
The installation of Entire Net-Work Administration Open Systems is complete. However, its environment is not yet activated.
After all the Entire Net-Work components you selected on the Choose Programs panel have been installed and when you click on the Readme panel for the last one, the Activate Installed Products panel appears. Select all the products listed on the panel. The Software AG environment file is called, by default, sagenv.new and is created for the list of products you select.
When finished with the Activate Installed Products panel, click and the full installation of the product completes. You must then activate the environment for the Software AG products you selected in the Software AG environment file. To do this, change to the installation directory and run sagenv.new:
. sagenv.new
The installation and deployment of the Entire Net-Work Administration Open Systems in UNIX is complete.
This section describes the uninstallation of Entire Net-Work Administration Open Systems and the Directory Serveron each of the platforms on which it is supported.
Uninstalling Entire Net-Work Administration Open Systems or Directory Server on Windows
Uninstalling Entire Net-Work Administration Open Systems or Directory Server on UNIX
This section describes how to uninstall Entire Net-Work Administration Open Systems or Directory Server on Windows.
Notes:
To uninstall Entire Net-Work Administration Open Systems or the Software AG Directory Server on Windows:
If you are uninstalling the Software AG Directory Server, stop the Directory Server service before you start these steps. This uninstallation procedure will uninstall the service, but it cannot do so if the service is running. If you do not uninstall the service (or if its uninstallation fails) and you try to reinstall Directory Server later, errors will occur when you try to use your new Directory Server installation.
Go to the Control Panel.
In Windows XP environments, select Add/Remove Programs.
In Windows 7 environments, select Uninstall or Change a Program.
To uninstall Entire Net-Work Administration Open Systems, locate Software AG Entire Net-Work Administration Open Systems v.r.m (where v.r.m are the version, release, and modification levels of the Entire Net-Work Administration Open Systems code). Then:
In Windows XP environments, click on the associated button.
In Windows 7 environments, double-click on Software AG Entire Net-Work Administration Open Systems v.r.m.
To uninstall the Software AG Directory Server, locate Software AG Directory Server. Then:
In Windows XP environments, click on the associated button.
In Windows 7 environments, double-click on Software AG Directory Server.
The InstallShield Wizard is invoked.
in Windows XP environments, select on the Welcome panel and click . Click for any verification messages.
In Windows 7 environments, click to start the uninstallation.
The Setup Status panel appears on which you can watch the progress of the uninstallation.
When the uninstallation has completed, the Finish panel appears. Click to end the uninstallation.
Alternatively, when you try to install this version of the product, the InstallShield automatically detects whether another version is already installed and prompts you to remove it.
The Entire Net-Work Administration Open Systems or Directory Server uninstallation process will not remove any files that were not originally installed by the Entire Net-Work Administration Open Systems or Directory Server installation tools.
To uninstall Software AG software on UNIX:
Enter sagrm on the command line.
Note:
The executable sagrm file resides in the
$SAG/common/bin directory. Ensure that this path is
included in the PATH environment variable.
The Software AG deinstallation GUI is started and the Product Selection panel appears.
On the Product Selection panel, select the Software AG products in this environment that you want to uninstall. To select a product, click on the check box to the left of the product name until a check appears in the box.
When all products have been selected, click .
A subpanel appears allowing you to select specific component packages of the product you selected in Step 1 to be uninstalled.
Select the component packages you want installed. To select a package, click on the check box to the left of the component package name until a check appears in the box.
Click when all appropriate component packages have been selected.
The component packages and products are uninstalled.
