Installing Domino® on Linux™ on System z®

To install Domino® on a local or remote IBM® System z® Linux™ server, use either an interactive method, or run a script to install silently.

About this task

Before you install the Domino® program files on a Linux™ on IBM® System z® system, peform the following tasks:

Read the System Requirements technote at the IBM® Support Site for operating system and network protocol requirements and possible changes to the product documentation.
If you are upgrading to Domino® from a previous release, see the upgrade information in Domino® Administrator help, the IBM® Support Site, and the Notes® and Domini wiki.
Temporarily disable any screen savers and turn off any virus-detection software. Make sure that all other applications are closed.
For Domino® for Linux™, you must install the sysstat package containing iostat in order to obtain platform statistics.
If you are using Linux™ on System z®, do the following:

Procedure

Copy the Domino® installation tar file, ZLINUX.TAR.GZ, from the product media on your workstation to a Linux™ on System z® file system where it can be expanded and utilized for the installation steps. Be sure to transfer the file using a binary method. For example, for FTP, set the transfer mode to "binary." Neither the tar file nor its contents are required after installation has completed.
Expand the tar file by issuing the following shell command on Linux™ for System z®:
```
tar -xzvf ZLINUX.TAR.GZ
```
Note: It could take a minute or two for this process to complete. Once complete, the subdirectories zlinux/dominoshould exist.
Optional: Delete the tar file to save disk space.
Change to the directory containing the Domino® install script:
```
cd zlinux/domino
```
When the installation is complete (interactive mode or script mode), both the tar file and the zlinux subdirectory created by its expansion can be deleted.
You can install multiple instances of the Domino® server on a single system. If you install different releases, only one instance can be earlier than the current Domino® release.
If you want all instances to be the same release, install a Domino® partitioned server; Domino® partitions share one program directory and, by doing so, conserve system resources. When you have multiple instances of the Domino® server, each with a separate program directory, one or more of the instances may be a partitioned server.
To install the Domino® program files on a Linux™ on System z® system, you can use either interactive mode or script mode.

To use interactive mode

About this task

You use interactive mode to install the Domino® program and data files on the local machine or to use a Telnet connection to install the Domino® program and data files on specified remote systems.

During the interactive mode installation, you can use these keys at the UNIX™ command prompt:

Type h for help
Type e to exit the Install program
Press ESC to return to the previous screen
Press the spacebar to change the setting until you get the one you want
Press TAB to accept a setting and continue to the next screen

Procedure

Make sure the Domino® server kit is available from your network or media drive.

Note: If you are using Linux™ on System z®, be sure the Install files are located in your local file system. For information on transferring the files to your local file system, see the procedure at the beginning of this topic.
Log in to the root account for Domino® Server installation.
Change to the directory containing the install script.
Enter the following at the root command prompt to run the script:
```
./install
```

Follow the on-screen instructions and specify these options:

Table 1. Interactive mode options and actions
Option	Action
Add data directories only	Choose one: Yes to change a single Domino® server into a partitioned server or add data directories to an existing partitioned server No to keep a single Domino® server
Domino® Server installation type	Choose the server type that you acquired. For an xSP server, you must have the Domino® Enterprise Server.
Install template files	Choose one: Yes to install new templates No to retain templates from a previous release
Install xSP server (for Domino® Enterprise Server only)	Choose one: Yes if this is an xSP server No if this is not an xSP server
Program directory	Specify the directory in which Domino® will store program files.
Create /opt/ibm/domino soft link	Choose one: Yes if this system will have only one Domino® installation (program directory) No if this system will have multiple Domino® installations (multiple program directories)
Data directory	Specify the directory in which Domino® will store data files. If you are installing a partitioned server, indicate that and specify multiple data directories.
UNIX™ User name	Specify the person who will own the server configuration data. If you are installing a partitioned server, you may specify a different person for each data directory.
UNIX™ Group name	Specify the group to which the UNIX™ User belongs. If you are installing a partitioned server, you may specify a different group for each data directory.

To use script mode

About this task

Script mode installation provides silent install functionality for UNIX™ platforms and allows you to install saved installation settings to a local server or remote servers.

SCRIPT.DAT, the default sample script file, contains information you need to install the Domino® server program files, including descriptions of each parameter and instructions for using the -script option to install partitioned servers.

Note: Existing SCRIPT.DAT files from previous Domino® versions cannot be used with the new ISMP installer. Modify a local copy of the file sample unix_response.dat provided with the install kits. More options are now available than in the previous installation's script.dat file.

Procedure

Change the directory to the kit's install directory on either the media or network drive.
Copy SCRIPT.DAT from the kit's install directory to your local system as
```
filename.dat
```
Where filename is the name you want to give to the local script file that will contain the installation settings.
Open the local script file, filename.dat, and set the parameters as needed. It is usually best to use the default settings, as follows:
- Install target host name -- parameter = target_hosts
- Domino® server installation type -- Choose the server type that you acquired.
- Install template files -- template_install_option = 1
- Add data directories only -- add_data_directories_only = 0
- Install xSP server -- asp_install_option = 0
- Program directory -- Use the directory where Domino® stores program files.
- Create /opt/ibm/domino soft link -- opt_domino_softlink = 0
- Data directory -- Use the directory where Domino® stores data files.
- UNIX™ User name -- Person who will own the server configuration data
- UNIX™ Group name -- The group to which the UNIX™ User belongs
Save the local filename.dat.
Log in to the root account from your local system.
Switch back to the kit's install directory.
To install using the local script file, enter this command at the UNIX™ console prompt:
```
install -script filename.dat
```