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:
The following topics are covered below:
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.
Make sure that the following software has been installed on your computer:
Natural.
Adabas.
Entire Net-Work (only required if the FDIC system file
is located in a remote database).
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.
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.
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.
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.
During an update installation the values of the system parameters are automatically checked.
The Natural Development Server installation procedure performs the following steps:
Checks whether the prerequisite version of the operating system is running.
Temporarily sets the privileges (BYPASS,
CMKRNL, SYSNAM).
Checks whether Sagbase (GBA) is installed.
Sets the owner of the SAG$ROOT directory to all installed product directories and files.
Checks whether system parameters have correct values.
Registers the product Sagbase to PCSI, if required.
Calculates and verifies the disk space needed for installation on both the work-directory device and the installation device.
Checks whether Natural is installed.
Creates the directories SAG$ROOT:[NATNDV] and SAG$ROOT:[NATNDV.V<version>].
Moves all files and images to the appropriate directories.
Sets protections for files and directories.
Creates the patch level file in the version subdirectory of the Natural Development Server directory.
Note:
Patch level files are for internal use and should not be modified or
deleted. They are used for other installations.
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.
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.
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.
The following topics are covered below:
To verify the product entry in the PCSI database, enter the following:
PRODUCT SHOW PRODUCT NDV_<version>
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:
Transfer the command procedure (NDVDIR:[V<version>]FDIC_NDV<version>.COM) to the OpenVMS node on which the database is running and then execute it.
Make sure that the FDIC file can be accessed.
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.
