This document describes how to install Natural Security on a UNIX platform.
It is recommended that you install Natural Security after having installed all other subproducts of Natural, as this makes defining the subproducts' system libraries to Natural Security easier.
Important:
Once Natural Security is installed, Natural on the assigned
system file (FNAT) can only be accessed under the control of
Natural Security. Natural Security cannot be removed once it has been
installed. It is therefore recommended that you make a backup copy of your
FNAT system file before you install Natural Security.
The following topics are covered:
See also Natural Security On Different Platforms in the Natural Security documentation.
The following topics are covered below:
Make sure that the following software has been installed on your computer:
Natural (same version and update package or patch level as that of Natural Security).
Adabas.
Entire Net-Work (only required if the FSEC system file
is located in a remote database).
Natural Security 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 the environment variables for the above products have been set correctly.
You need a license key file to install and activate Natural Security.
During the Natural Security installation, you will be required to specify the location of the license key file provided by Software AG.
Before you start the installation, ensure that the license key file is available locally on the machine where you intend to install Natural Security.
In general, Software AG recommends you to place the license key file on the file system before starting the installation.
With this version, you can continue to use your existing FSEC system file. No migration of Natural Security data from the previous version to the current version is necessary.
The first steps of the installation are the same as during the installation of Natural. If you are installing Natural and Natural Security together, they need not be performed again. You can then continue the installation with the step SAG Environment Shell.
The installation can be performed in two installation modes, either in graphical mode or in character mode.
See the following list for an overview of the necessary steps:
If your drive for the installation medium has not yet been mounted, mount it now as described in the section Installing the Contents of the Installation Medium to Disk of the steps common to all Software AG products.
When the installation is started, the setup procedure will check the hardware platform and operating system version and then start the appropriate installation program.
The installation procedure examines the environment variable
DISPLAY to determine whether to run in graphical
or character mode.
To use graphical mode, the environment variable
DISPLAY must be set. If it is not yet set in your
environment and you want to use graphical mode, set it using the following
commands:
DISPLAY="machine_name:0" export DISPLAY
Character mode will be used automatically if the environment variable
DISPLAY is not set. If
DISPLAY has been set in your environment but you
want to use character mode, you can use the -nw option when you
start the installation.
At the end of an installation process, in either mode, a batch script is generated and written to the end of the installation log. It lists the parameters specified for that particular installation.
You can use the -help option to display a list of all
supported parameters.
To display the Natural-specific batch mode parameters, enter the following command:
setup.ux nat version -help
where version represents the version of the current Natural installation medium; for example, "v6320".
To display the Natural Security parameters which are supported in batch mode, enter the following command:
setup.ux nsc version -help
where version represents the version of the current Natural installation medium; for example, "v6320".
To perform this step, you must be either the user "sag" or a member of the group "sag" to which the administrator and all users of Software AG products are assigned. Do not perform this step as the user "root".
Start the installation procedure from a writable working directory. We recommend $SAG/INSTALL. Enter the command:
sh /mount_dir/setup.ux [-nw]
where mount_dir is the starting directory on your product installation medium. Upper/lower case usage is possible depending on your local settings.
Note:
The following descriptions of installation steps assume that the
graphical installation mode is used. The step sequence is the same in character
mode.
The setup program is started and guides you through the installation. During installation you have to provide the license key.
In this screen, the variant of Natural that is to be installed is displayed.
Choose to proceed.
This screen appears only when you are logged in as the user "root".
It is not intended that you perform the installation as "root". It is recommended to use the Software AG user "sag" instead.
If you still need to perform the installation as "root", enter the user ID of the Software AG user to be able to continue.
Choose to proceed.
In this screen, you can change the value of the
SAG environment variable, which is the path name
of the directory tree where all Software AG products are installed.
By default, the content of the current $SAG variable is displayed.
Optional. Enter a different path or use the button to change the path.
Choose to proceed.
This screen appears only if you are installing Natural Security separately. In this case, you have to select the path to the environment file.
Note:
This screen does not appear if you have selected to install both
Natural and Natural Security at the same time. In this case, the environment
settings were selected during the Natural installation.
The default name is sagenv.new. This documentation assumes that the environment file is called sagenv.new.
Optional. Select another environment file.
You can use any name for your environment file.
Choose to proceed.
This screen appears only if you are installing Natural Security separately.
Note:
Natural must have been installed before you can install Natural
Security.
Activate the check box for Natural Security.
Choose to proceed.
When you have selected to install both Natural and Natural Security at the same time, this is the first Natural Security installation screen to appear after you have chosen in the Installation Complete screen.
In this screen, the license agreement is displayed.
Choose the button to proceed.
Note:
If you run the installation procedure in character mode, at each
command prompt, you must type in the exact wording (for example:
"accept", not just "y" or
the ENTER key).
In this screen, you specify the path to the Natural Security license key file.
Note:
If no common Software AG environment exists yet,
<your-current-directory>/<product-code>.xml
is displayed.
If you do not want to use the displayed license key file, specify the path to your license key file.
Or:
Choose the button to select the license
key file from a dialog.
If you choose the button, the content of your license key file is displayed in a separate screen. Choose or to go back to the License File screen.
Choose to proceed.
In this screen, the name of the source directory and $SAG directory are shown.
To review or change your settings, choose the button.
Choose to begin extracting files.
This screen, which contains a progress indicator, informs you about the installation status.
When all files have been extracted, choose to proceed.
In this screen, you have to specify where Adabas is installed ($ADADIR/$ADAVERS).
If you use Natural Security on multiple platforms, see also the section Central FSEC System File in the Natural Security documentation.
Specify the path to the directory in which Adabas has been installed.
You can also use the browse button to select to the required directory.
Or:
To use a remote FSEC, select Use remote
database.
Adabas databases outside of the current $SAG directory (that is: in another $SAG directory) must be defined as remote.
Choose to proceed.
In this screen, you specify the Natural parameter file you want to use as a template.
Select the Natural parameter file.
The settings in this Natural parameter file will be used to create a
new parameter file for Natural Security called NSCPARM. If
NSCPARM already exists, a copy of it will be saved.
If you want to create a Natural Development Server environment with
Natural Security, use the parameter file named NDVPARM as a
template.
Note:
You can choose the command button displaying a magnifying glass to
display the contents of the currently selected parameter file.
Choose to proceed.
In this screen, the environment settings for FNAT are
shown.
If required, select a different system file.
Choose to proceed.
In this screen, you have to enter a database ID and file number for the
FSEC system file.
Select an existing DBID and FNR.
If you are using a local FSEC system file, all available
databases are available for selection.
If you specified Use remote database in the
step Environment
Check, enter the DBID and FNR of an existing
FSEC on your remote database you want to use.
Or:
To create a new system file, select an existing DBID and enter an
unused number for FNR. In this case, you will be asked whether you want the new
system file to be created.
If no local FSEC exists yet, the system file will be
created and initialized. If you choose an existing FSEC, its
contents will not be modified.
FNAT/FUSER reside on the file system and
the FSEC in Adabas. It is therefore not possible to use the same
DBID for FNAT/FUSER and
FSEC.
Choose to proceed.
Before this screen appears, you are asked whether you want to use a log file with your Natural Security installation.
Choose , if you want to use the Natural Security feature Logging of Maintenance Functions (see Maintenance Log Records in the Natural Security documentation).
Note:
The option
Logging of Maintenance Functions
must additionally be enabled in Natural Security after the installation.
Enter or select the database ID and file number for the Natural Security log file. If you do not want to use this feature, enter "0" as DBID.
If you are using a local database, all available database IDs and file numbers are available for selection.
If you want to use an existing log file, select the DBID and FNR. If no log file exists yet, the Natural Security installation creates a new log file. Enter a DBID and FNR.
If you specified Use remote database in the step Environment Check, enter the DBID and FNR of an existing log file on the remote database you want to use.
Choose to proceed.
You are asked whether you want to create a log system file with the specified numbers.
Choose to create the log system file.
In this screen, you can decide whether you want to link a new Natural nucleus and/or a new shared library nucleus.
If you have selected Entire Screen Builder, ApplinX and/or Natural for Tamino or if Entire Access is installed, the option Relink Natural nucleus is preselected.
Natural Security is delivered with a prelinked Natural Security nucleus called "natsec" and a Natural Security shared library nucleus. However, if you want to use additional packages such as Entire Screen Builder, ApplinX, Natural for Tamino or Entire Access, you need to relink the Natural Security nucleus. See Compilers Used to Build Natural for the compiler you must use.
Select the option Relink Natural nucleus and/or Relink shared library nucleus
Choose to proceed.
This screen appears only when you have selected the option Relink Natural nucleus.
Select the required options.
Choose Next to proceed.
This screen appears only when you have selected the option Relink Natural nucleus. It displays the output of this relinking process.
The relinking process creates a new Natural Security nucleus called "natnsc".
When you have not selected to relink Entire Screen Builder or ApplinX, you are first asked whether the new nucleus shall be the default nucleus and replace the current Natural nucleus which is called "natural".
If you have selected to relink Entire Screen Builder or ApplinX, a nucleus called "natnsw" (for Entire Screen Builder) or "natapx" (for ApplinX) is created. The Natural nucleus called "natural" is not replaced in this case. Therefore, you are not asked whether you want to replace the current nucleus.
Review the results of the relinking process.
Choose Next to proceed.
This screen appears only when you have selected the option Relink shared library nucleus.
The relinking process creates a new shared library nucleus.
Select the required options.
Choose Next to proceed.
This screen appears only when you have selected the option Relink shared library nucleus. It displays the output of this relinking process.
However, you are first asked whether the new nucleus shall be the default nucleus and replace the current shared library nucleus.
Choose to use the new nucleus.
Review the results of the relinking process.
Choose Next to proceed.
This screen, which contains a progress indicator, appears after the above configuration steps have been completed. The installation now loads the libraries.
When the loading of the libraries is complete, choose to proceed.
This screen informs you that the installation of Natural Security has finished successfully. You are asked whether you want to read the Readme file for Natural Security.
It is recommended that you read the Readme file.
If you do not want to display the Readme file, remove the corresponding selection.
Choose .
You have to activate Natural Security in this screen.
Note:
This screen is also shown when you install both Natural and Natural
Security at the same time.
Select the product(s) you want to activate in the Software AG environment file.
Choose to proceed.
This screen appears when the installation has finished.
Choose to exit the installation program.
It is necessary to execute the sagenv.new file
after finishing this installation program to set the environment variables
NATDIR, NATVERS and
PATH. You can do this now, if you want to work
with Natural immediately, or later, if you want to perform other tasks first.
But the environment file must have been executed before using Natural.
Note:
When you install both Natural and Natural Security at the same time,
this step is required only once. When you install Natural and Natural Security
separately and do not use Natural in the meantime, you can perform this step
directly after the installation of Natural Security. Otherwise, you have to
perform this step twice (after the installation of Natural and after the
installation of Natural Security).
Check these settings and insert them into your profile (for example, .profile).
Once the installation has been successfully completed, you can remove the working directory (which you specified in step Start the Installation Process) and all of its contents.
If you have installed Natural Security for the very first time (that is,
if the version you have installed is your first version of Natural Security on
this FSEC system file), proceed as described in the
Natural Security documentation under the heading
First Steps
After the Installation. Do this immediately after a
successful installation of Natural Security.
