Version 6.3.12 for OpenVMS
 —  Installation  —

Installing and Setting Up Natural Development Server on OpenVMS

This document describes how to install Natural Development Server Version 2.2 on an OpenVMS platform.

Natural Development Server can be installed with a Natural suite installation.

The following topics are covered:


Product Requirements

The following topics are covered below:

Disk Space

The space required on disk will be checked by the PCSI utility during the installation. See Disk Space in the section Installing and Setting Up Natural on OpenVMS.

Prerequisites

Make sure that the following software has been installed on your computer:

Natural Development Server uses the same versions of Adabas and Entire Net-Work as Natural. For the supported versions, see Related Software AG Products.

Also, make sure that LOGIN.COM and STARTUP_<name><v>.COM for the above products have been executed with the required product versions.

License Key File Issues

You need a license key file to install and activate Natural Development Server.

Before you start the installation, ensure that the license key file is available locally on SYS$LOGIN of the installing user on the machine where you intend to install Natural Development Server.

In general, Software AG recommends you to place the license key file on the file system before starting the installation.

Top of page

Installing Natural Development Server in a Cluster Environment

If you install Natural Development Server in a cluster environment, you have to install it on each node in the cluster environment.

Note:
Sagbase must be installed on each node on which Natural Development Server is to be installed.

Initial Installation in a Cluster Environment

Depending on how Sagbase has been installed, the initial Natural Development Server installation within a cluster will choose either the common or the specific root directory. The installation procedure checks if there is already an existing Natural Development Server installation in the cluster.

Update Installations in a Cluster Environment

During an update installation the values of the system parameters are automatically checked.

Top of page

Overview of the Installation Procedure

The Natural Development Server installation procedure performs the following steps:

Note:
Patch level files are for internal use and should not be modified or deleted. They are used for other installations.

Top of page

PCSI Installation Procedure

Before you start installing Natural Development Server using the PCSI procedure, perform the necessary steps as described in Installing and Setting Up Software AG Products on OpenVMS.

You started the installation using the command procedure SETUP.COM located on the installation medium to install Natural Development Server in the OpenVMS environment.

SETUP.COM copies the Natural Development Server PSC file from the installation medium to the SAG$ROOT:[SAGKITS] directory and starts the Natural suite installation of the Polycenter Software Installation utility (PCSI). The suite installation automatically invokes the single product PCSI installations such as Natural and Natural Development Server. During the installation procedure, a number of general information messages are displayed. Read all messages carefully and follow any advice they may provide.

Continue the Suite Installation

During the Natural suite installation (see Continue the Suite Installation in the section Installing and Setting Up Natural on OpenVMS), you will be asked whether you want to install Natural Development Server:

Do you want to install NDV<version>? [YES] 

Enter "YES" to continue with the Natural Development Server PCSI installation.

Continue the PCSI Installation

A message appears during the installation process, informing you that the product "SAG I64VMS NDV_<version> V<v.r> Layered Product" has been selected.

The installation procedure checks whether the product Sagbase (product code GBA) has already been installed and registered with the PCSI utility.

Information on the product license key is shown. Check whether the license key file is available on SYS$LOGIN of the installing user. Without a proper license key file, the installation will abort.

After the successful installation of the suite, you are informed about the installed products.

You will have to perform some post-installation steps (that is, set up Natural Development Server and start the daemon). See After the Installation for further information.

Top of page

After the Installation

The following topics are covered below:

Verifying the PCSI Installation Procedure

To verify the product entry in the PCSI database, enter the following:

PRODUCT SHOW PRODUCT NDV_<version>

Completing the Installation

When Natural has been installed, enter the following commands to proceed with the setup of Natural Development Server:

@ADABAS$VERSION:SYMBOLS
SET DEFAULT SAG$ROOT:[NATNDV.V<version>.INSTALL]
@SAGINST_NDV.COM

Important:
Several functions of the SAGINST_NDV.COM command procedure require Natural administrator rights. Before you start the command procedure, you should therefore make sure that you are defined as a Natural administrator in the local configuration file (see Administrator Assignments in the Configuration Utility documentation).

The following screen appears:

  Development Server for Natural V<version>
                          Installation Procedure

------------------------------------------------------------------------------
                                                   Parameter File=NATPARM
                                                             DBID=000
           1  -  Specify Adabas DBID for FDIC file
                 (DBID=000 means creation of a procedure for a remote database)
           2  -  Create command procedure to load FDIC into remote database

           3  -  Specify Natural parameter file for INPL
           4  -  Specify FDIC profile parameter in parameter file
                 (same DBID as in Step 1, same FNR as in Step 2)

           5  -  Add database assignment for FDIC to
                 global configuration file

           6  -  Start NDV INPL procedure (this step takes some time)
           7  -  Check log file of INPL procedure



Enter the function   [exit]                  :

Execute all functions shown in the screen, one after the other. With function 1, you decide whether to work with a local database or a remote database.

With function 2, the following parameters are shown with their default values. If required, you can modify the default values.

Parameter for Database File Default Value
Number of blocks for DATA 1000
Number of blocks for NORMAL INDEX 1000
Number of blocks for UPPER INDEX 100
Maximum number of ISNs 60000
Padding factor for ASSO 10
Padding factor for DATA 10

If you want to create a new FDIC file for your Natural Development Server environment (function 2), check if the Adabas nucleus parameters listed in the following table are set for the database you want to use for your Natural Development Server system file (FDIC).

LWP Must be at least 1,000,000.
MGC Must be at least 50.
NISNHQ Must be at least 1,000.
OPTIONS The option TRUNCATION must be set in the OPTIONS parameter.

In the case of a remote database, proceed as follows before executing function 6:

Starting the Daemon

When Natural Development Server has been installed as described above, you have to start the Natural Development Server daemon. This is described in the Natural Development Server for OpenVMS documentation.

Top of page