Entire Net-Work Server is installed using the Software AG Installer. It requires a license key. For more information, read The License Key, elsewhere in this document.
You can download the Software AG Installer from the Software AG Empower website at https://empower.softwareag.com/.
More than one Entire Net-Work Server can exist in your enterprise, however, only one Entire Net-Work Server can be installed per computer. An Entire Net-Work Server must be installed on each machine in your enterprise where an Entire Net-Work Kernel is required to:
Provide access to local Adabas databases
Act as a migration bridge between Adabas databases on classic Entire Net-Work nodes and those on the new Entire Net-Work 7 e-business nodes.
Once the Entire Net-Work Server is installed, one or more Kernels can be defined.
This document provides product-specific instructions for installing Entire Net-Work Server. It is intended for use with Using the Software AG Installer, which explains how to prepare your machine to use the Software AG Installer and how to use the Software AG Installer and Software AG Uninstaller to install and uninstall your products. The most up-to-date version of Using the Software AG Installer is always available in the webMethods product documentation located on the Software AG Empower website (https://empower.softwareag.com/).
This document covers the following topics:
This product is installed using the Software AG Installer, which you can download from the Software AG Empower website at https://empower.softwareag.com/.
Installation of Entire Net-Work requires the presence of an Adabas Directory Server in your enterprise.
If you have a Directory Server already installed at your site from an earlier release of Software AG products, you do not need to install it again; your new products can use the existing installation instead.
The Directory Server 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). It should be installed on a dedicated system that is operational 24 hours a day, with a UPS.
We recommend that you install one Directory Server for use with all the Software AG products that require it.
A permanent license is required in order to run this product. Every time its software starts, the license key file is read and the validity of the license key is checked. So, you will be required to specify the location of a license key file that contains your license key during the installation procedure.
Entire Net-Work Server licenses include a setting for the maximum number of clients that can be installed for your site. This setting is established when you purchase Entire Net-Work.
This section contains the following information on license keys for Entire Net-Work Server.
Important:
If you uninstall Entire Net-Work Server on Windows systems, the license file
will be deleted. Management of the license file
is, therefore, your responsibility. Make sure that you have a copy of the file
before doing the uninstall.
The Entire Net-Work Server license key file is generally distributed on distribution media, although, in special cases, it may be shipped via e-mail. The file name is in the following format, where vr is the version and release number of the product: wcpvr.xml.
Be sure that the file containing the license key is in a location that will be accessible during the Entire Net-Work Server installation, such as on the file system or in a disk drive. During the installation of Entire Net-Work Server, you are asked to locate the license file. Once it is located, the license file will be copied into a Software AG common area.
If you are installing Entire Net-Work Server on a laptop and you have received your license file via distribution media, note that some laptop configurations do not allow you access to the CD-ROM drive and a diskette drive simultaneously. In such cases you must copy the license file to a location that is accessible while the CD-ROM drive is in use, such as your laptop's hard disk, before you start the installation procedure. In general, Software AG recommends that you place the license file on the file system before starting the installation procedure.
Note:
The license file is sometimes transmitted via e-mail. If you received
the file via e-mail, copy it to a directory on your hard drive.
The license key file is provided as an XML document. This document can be viewed, using a browsing tool or text editor. It contains text representing the licensing information and a digital signature. It displays Software AG legal notices, copyright information, as well as the product license information.
 |
Warning: Any modification of the license key file will invalidate the digital signature and the license key check will fail. If the check fails, you will not be able to install or run the product. In the event of a check failure, please contact your Software AG Support representative. |
This section describes the system requirements of Entire Net-Work Client.
Software AG generally provides support for the operating system platform versions supported by their respective manufacturers; when an operating system platform provider stops supporting a version of an operating system, Software AG will stop supporting that version.
For information regarding Software AG product compatibility with IBM platforms and any IBM requirements for Software AG products, please review the Product Compatibility for IBM Platforms web page.
Before attempting to install this product, ensure that your host operating system is at the minimum required level. For information on the operating system platform versions supported by Software AG products, complete the following steps.
Access Software AG's Empower web site at https://empower.softwareag.com.
Log into Empower. Once you have logged in, you can expand in the left menu of the web page and select to access the Product Version Availability screen.
Use the fields on the top of this screen to filter its results for your Software AG product. When you click the button, the supported Software AG products that meet the filter criteria are listed in the table below the filter criteria.
This list provides, by supported operating system platform:
the Software AG general availability (GA) date of the Software AG product;
the date the operating system platform is scheduled for retirement (OS Retirement);
the Software AG end-of-maintenance (EOM) date for the product; and
the Software AG end-of-sustained-support (EOSS) date for the product.
Note:
Although it may be technically possible to run a new version of your
Software AG product on an older operating system, Software AG cannot continue
to support operating system versions that are no longer supported by the
system’s provider. If you have questions about support, or if you plan to
install this product on a release, version, or type of operating system other
than one listed on the Product Version Availability screen described above,
consult Software AG technical support to determine whether support is possible,
and under what circumstances.
For general information regarding Software AG product compatibility with other platforms and their requirements for Software AG products, visit Software AG's Hardware Supported web page.
The Adabas Manager requires an Internet browser. For information on supported browsers, see the webMethods System Requirements documentation on the Empower web site.
The following table displays the minimum disk space requirements on Windows and Linux systems for various Adabas LUW and Entire Net-Work LUW products, including the Adabas Directory Server:
| Product | Space Requirement |
|---|---|
| Entire Net-Work Client | 25 MB |
| Entire Net-Work Server | 30 MB |
| Adabas Directory Server | 20 MB |
If you attempt to install and use this software in a system with a firewall in place, be sure that your system administrator has set up the firewall so that the component applications can access the ports they need (including the Adabas Directory Server port and any ports Entire Net-Work dynamically assigns during its own processing). For more information about port usage, read the Port Number Reference found elsewhere in this documentation.
Before you install this product, you must decide how you are going to configure it. To assist you in these decisions, the following table provides some questions you should answer for the installation of this product in your enterprise. Corresponding considerations for the questions are also provided.
| Category | Question | Considerations |
|---|---|---|
| Adabas Directory Server and this product | Do you want to direct specific clients or Kernels to specific databases by department or other organizational grouping? |
You can create multiple Kernels and use Directory Server partitioning and client and Kernel filtering in SMH to control which clients and Kernels have access to which databases. |
| Partitioning | Do you want to implement partitioning? | Partitioning allows you to direct specific clients or Kernels to specific databases. Partitions are defined for the clients and Kernels in the Adabas Manager. For more information, read Understanding Partitioning. |
| Entire Net-Work Servers | On which machines must an Entire Net-Work Server be installed? | One Entire Net-Work Server must be installed on each machine where you wish to define Kernels. Only one server can be installed on a machine. |
| Kernels | On which machines do your open system databases reside? | At least one Kernel must be defined on each of these machines if you want your clients to be able to access the open system databases. |
| Will your Entire Net-Work Clients need to communicate with databases on the mainframe or with databases managed by classic Entire Net-Work 2 Kernels? |
One Entire Net-Work Kernel must be used as a bridge to access these databases. This Kernel will translate and direct requests as appropriate. The Entire Net-Work Kernel used can be one already defined on a system with a local database. It can also be a Kernel that is defined standalone on a machine without a local database. You will need to evaluate your network traffic to determine which configuration works best for your site. |
|
| Will you want to install and run an Entire Net-Work 7 Kernel and an Entire Net-Work 2 Kernel on the same machine? |
Software AG recommends that you install either the Entire Net-Work 7 or the Entire Net-Work 2 Kernel on a machine -- but not both. Instead, when you are ready to migrate a system to Entire Net-Work 7, stop the classic Entire Net-Work 2 Kernel and install the Entire Net-Work 7 Kernel. The migration will happen smoothly, without complications, and you can use Entire Net-Work 7 to access the same databases you accessed using classic Entire Net-Work. While it is possible to install and run an Entire Net-Work 7 Kernel on a system where an Entire Net-Work 2 Kernel is installed and running, choosing to do so is an advanced option. We recommend that you contact your Software AG technical support representative for assistance in doing this. |
|
| If you are implementing partitioning, which Kernels will be part of which partition? | Partitioning allows you to direct specific Kernels to specific databases. For more information, read Understanding Partitioning. | |
| Are you implementing filtering? | Filtering allows you to direct specific Kernels to specific databases. For more information, read Understanding Filtering. | |
| Entire Net-Work Clients | How many Entire Net-Work Clients will you need and on which machines will they be needed? | One Entire Net-Work Client must be installed on each machine that needs to communicate with an Adabas database or that needs to access other Software AG product servers (such as those for EntireX Communicator, Tamino, or Adabas SQL Gateway). |
| If you are implementing partitioning, which clients will be part of which partition? | Partitioning allows you to direct specific clients to specific databases. For more information, read Understanding Partitioning. | |
| Are you implementing filtering? | Filtering allows you to direct specific clients to specific databases. For more information, read Understanding Filtering. | |
| Will any of the machines be used to run both databases and Entire Net-Work Clients? | At least one Entire Net-Work 7 Kernel must be defined and one Entire Net-Work 7 client must be installed on any machine on which a local database is installed and from which access to other databases is required. |
Before you begin installing this product, ensure that the following prerequisites have been met:
Software AG strongly recommends that you create an installation image of your existing Software products and store the image on your internal network. You should create an image for each operating system on which you plan to run the installation (for example, 32-bit, 64-bit, or both). This will help you reduce WAN traffic and speed up installation and will ensure consistency across installations over time, since the Software AG Installer provides only the latest release of each product.
Close (stop) all open applications, especially those applications interacting with or depending on your Adabas databases. This includes Natural, Adabas Manager, the Adabas DBA Workbench, and prior releases of any other Adabas products. To be on the safe side, also shut down all Software AG services.
Important:
For some Software AG products, the Software AG Uninstaller will
not be able to remove key files that are locked by the operating system if the
associated Software AG products are not shut down.
Disable any antivirus software.
Ensure the target computer is connected to the network.
If this product requires a license key file, verify the license key file is copied somewhere in your environment . Products requiring license key files will not run without valid license keys. For more information, read The License Key, elsewhere in this section.
Verify your environment supports the system requirements for this product, as described in System Requirements, elsewhere in this section.
Entire Net-Work Server is installed using the Software AG Installer. This installation documentation provides a brief description on how to install the Entire Net-Work Server directly on the target machine using the installer wizard. For detailed information on the installer wizard, read Using the Software AG Installer.
Note:
Read Using the Software AG Installer also if
you want to use console mode, or if you want to install using an installation
script or installation image.
To install Entire Net-Work Server, complete the following steps:
Software AG provides a license file for Entire Net-Work Server; the installer requires it during installation. Copy the license file to the machine on which you want to install Entire Net-Work Server. You can copy it to any temporary location. The installer will ask for the location of your license file and will then copy it to the appropriate location.
Start the Software AG Installer as described in Using the Software AG Installer.
When the first page of the Software AG Installer wizard (the Welcome panel) appears, choose the button repeatedly, specifying all required information on the displayed panels, until the panel containing the product selection tree appears.
All Adabas-related products (including Adabas Directory Server) can be selected for installation within the Adabas Family product selection tree.
Note:
The Infrastructure tree and required components therein is
automatically selected for all Software AG product installations.
To install Entire Net-Work Server, select (check) the Entire Net-Work Server entry from the Adabas Family product selection tree.
Note:
You can opt to install other Software AG products from this
list at the same time. This section just describes the installation of
Entire Net-Work Server.
The selection of Entire Net-Work Server by default also selects the Platform Manager under Infrastructure > Platform Manager and the Entire Net-Work Plug-in for Platform manager under Infrastructure > Platform Manager Plug-ins > Entire Net-Work Plug-in. If you choose not to use Platform Manager, you can deselect these items before proceeding with the installation.
On the License panel, read the license agreement and select the check box to agree to the terms of the license agreement and then click to continue. If you do not accept the license agreement, the installation will stop.
When the Configure panel appears, enter the full path to the Entire Net-Work Server license file (or use the button to select it from a dialog box.
During the installation, the installer will copy the Entire Net-Work Server license file to the <common/conf> directory of your Entire Net-Work Server installation.
Remain on the Configure panel and specify the URL and port number for the Directory Server that should be used for this installation. The default is tcpip://localhost:4952. For complete information on the port used by the Directory Server, read Port Number Reference.
In addition, on Linux systems, select the radio button indicating whether Entire Net-Work Server should be installed as an application or a Daemon. You can only select one. By default, it is installed as a Daemon (recommended). If installed as an Application, the user must manually start and stop the Entire Net-Work Server service.
Click to continue.
On the last panel, review the items you have selected for installation. If the list is correct, choose the button to start the installation process.
After Entire Net-Work Server has been installed, it will start automatically on Windows, and on Linux only, if it has been installed as a Daemon.
If you have the default Microsoft Windows personal firewall enabled on a PC and you would like to install and run Adabas and Entire Net-Work components on that PC, you will need to allow communications through the firewall on certain ports. You can do this in one of two ways: you can allow ports for a specific executable program or you can open specific ports. This section covers the following topics:
Note:
If you attempt to install Adabas or Entire Net-Work in a system with a
firewall in place, be sure that your system administrator has opened the
firewall for the Adabas Directory Server port or the installation may not complete
successfully.
You can allow a specific executable program to open a port. To do so, issue the following command:
C:\>netsh firewall add allowedprogram program="<path and file name>" name="<component-name>" profile=ALL
where <path and file name> is the path and file name of the file you want to allow and <component-name> is a user-specified name to identify the file you are allowing. The following table lists the common Adabas and Entire Net-Work component files that might need to be allowed if Windows personal firewall is enabled:
| Component Name | Path and File Name |
|---|---|
| Entire Net-Work Client Service | <your-installation-location>\EntireNetWorkClient\bin\wclservice.exe |
| Entire Net-Work Kernel program | <your-installation-location>\EntireNetWorkServer\bin\wcpkernel.exe |
| Entire Net-Work Server Service | <your-installation-location>\EntireNetWorkServer\bin\wcpservice.exe |
| Adabas Directory Server Service | <your-installation-location>\SoftwareAG\SoftwareAgDirectoryServer\bin\xtsdssvcadi.exe |
To remove the Adabas or Entire Net-Work component as an allowed program, issue the following command:
C:\>netsh firewall delete allowedprogram program="<path and file name>" profile=ALL
where <path and file name> is the path and file name of the file you want to disallow.
To open a specific port for use by an Adabas or Entire Net-Work component in the firewall, issue the following command:
C:\>netsh firewall add portopening protocol=TCP port=nnnn name="<component-name>" profile=ALL
where nnnn is the port number you want to open and <component-name> is a user-specified name to identify the port you are allowing.
To avoid port number conflicts, read Port Number Reference for a general list of the ports used by Software AG products.
To close a specific port in the firewall, issue the following command:
C:\>netsh firewall delete portopening protocol=TCP port=nnnn profile=ALL
where nnnn is the port number you want to close.
You uninstall this product using the Software AG Uninstaller. For information on how to use the uninstaller, read the Using the Software AG Installer guide.
Entire Net-Work Server is updated using the Software AG Update Manager (SUM).
You can download the Software AG Update Manager from the Software AG Empower website at https://empower.softwareag.com/.
This SUM installation documentation on Empower provides a brief description on how to update Software AG products directly on the target machine using the Update Manager wizard. The SUM documentation also includes instructions on how to apply updates in console mode or using scripts.
To update Entire Net-Work Server, complete the following steps:
Download and install Software AG Update Manager for your platform from Empower.
Shut down any running instances of the product. Updates cannot successfully apply if the application is active.
From a console prompt in the SUM /bin directory, enter
UpdateManagerGUI.bat (UpdateManagerGUI.sh on Linux).
On the opening page of the SUM tool, select Install Fixes from Empower, enter your SAG product directory root location and provide your Empower User ID and password. Click .
Expand through the Adabas Family product selection tree to find the entry for this product.
Tip:
If the product is not shown in the tree, there is either no
update available or the product is not installed in the location you
specified.
Select (check) the Entire Net-Work Server entry in the product selection tree. Click .
Tip:
You can select more than one product to update before
proceeding.
The next screen presents a summary of products that are about to be updated. If any of them require manual pre-installation steps, they will be highlighted in red and you will be directed to read the update readme file for that product before proceeding.
Complete any pre-installation steps outlined in the readme file and check the box next to Pre-installation steps have been completed. Click .
Note:
If any pre-installation steps are required, the
button will be unavailable until you confirm these
steps have been completed.
The tool will apply updates to all selected products and present you with a final screen confirming updates have been applied. Click to exit SUM or to return to the tool's starting panel.
To remove an installed update, complete the following steps:
Shut down any running instances of the product.
Start Software AG Update Manager.
On the opening page, select Uninstall Fixes from the selection panel. Click .
If any product selected for uninstall requires manual steps, you will be directed to review the update readme and confirm you have performed any pre-uninstallation steps. Click .
The fix(es) you selected for uninstall will be removed and the product(s) returned to their previous state. Click to exit SUM or to return to the tool's starting panel.