Appendix A Silent Installation of a Web Agent in Policy Agent 2.2

In addition to a standard installation of web agents, you can perform a silent installation as described in this appendix. The tasks involved in a silent installation of a web agent in Policy Agent 2.2 are the same for Solaris systems and Linux systems, but different for Windows systems. This appendix provides the information for performing the respective tasks as follows:

About Silent Installation of a Web Agent in Policy Agent 2.2

A silent installation refers to installing a program by implementing a script. The script is part of a state file. The script provides all the answers that you would normally supply to the installation program interactively. Running the script saves time and is useful when you want to install multiple instances of a web agent using the same parameters in each instance.

Silent installation is a simple two-step process of generating a state file and then using that state file. To generate a state file, you record the installation process, entering all the required information that you would enter during a standard installation. Then you run the installation program with the state file as the input source.

You can perform the tasks for a silent installation through the GUI or through the command line as described in the respective sections that follow.

Solaris and Linux Systems: Silent Installation of a Web Agent in Policy Agent 2.2

The tasks that follow apply to Solaris systems and Linux systems.

Generating a State File for a Web Agent Installation on Solaris and Linux Systems

This section describes how to generate a state file for installing a web agent on Solaris systems and Linux systems. The description that follows provides an option of performing this task through the GUI and an option of performing this task through the command line.

Regardless of which type of installation you choose, GUI or command line, you need to initially issue one command for recording the information you will enter as you follow the agent installation steps. Enter all the necessary installation information in order to create a complete state file.

To Generate a State File for a Web Agent Installation on Solaris and Linux Systems

The following task describes how to generate a state file for a web agent installation on a Solaris system or a Linux system.

Change to the directory in which you unpacked the agent binaries.

This directory contains the setup program, which is used for installing a web agent and for performing other tasks.

Issue the command that applies as follows:
- To use the GUI installation, issue the following command:
```
# ./setup -saveState filename
```
- To use the command-line installation, issue the following command:
```
# ./setup -nodisplay -saveState filename
```
-saveState

An option that saves all of your responses to installation prompts in a state file.

filename

Represents the name that you choose for the state file.

Enter the installation information as described in this guide.

See the appropriate section of this guide, according to your installation needs:
- GUI installation on Solaris Systems
- Command-Line installation on Solaris Systems
- GUI installation on Linux Systems
- Command-Line installation on Linux Systems
Your answers to the prompts are recorded in the state file. When the installation is complete, the state file is created in the same directory where the installation program is located.

Note –
When generated, a state file will have read permissions for all users. However, because the state file contains clear text passwords, change the file permissions to restrict read and write access to the user root.

Using a State File for a Web Agent Silent Installation on Solaris and Linux Systems

This section describes how to use a state file for installing a web agent on Solaris systems and Linux systems.

To Install a Web Agent Using a State File on Solaris and Linux Systems

To perform a silent installation of a web agent using a state file, perform the following:

Change to the directory in which you unpacked the agent binaries.

At this point, this directory should contain, amongst other items, the setup program and the web agent installation state file.

Issue the following command:
```
# ./setup -nodisplay -noconsole -state filename
```
-state

An option that directs the installer to run in non-interactive mode as it obtains all responses to prompts from the named state file.

filename

Represents the name of the state file from which the installer obtains all responses.

The installation takes place hidden from view. After completion, the program exits automatically and displays the prompt.

Note –
Even though the silent installation does not validate the keys in the state file, avoid editing the values of the keys in the state file because the setupSDK script might report a corrupt state file when used during subsequent silent installations.

Windows Systems: Silent Installation of a Web Agent in Policy Agent 2.2

The tasks that follow apply to Windows systems.

Generating a State File for a Web Agent Installation on Windows Systems

This section describes how to generate a state file for installing a web agent on Windows systems. The description that follows provides an option of performing this task through the GUI and an option of performing this task through the command line.

To Generate a State File for a Web Agent Installation on Windows Systems

The following task describes how to generate a state file for a web agent installation on a Windows system.

Change to the directory in which you unpacked the agent binaries.

Issue the command that applies as follows:
- To use the GUI installation, issue the following command:
```
java agent_WINNT_domino -saveState filename
```
- To use the command-line installation, issue the following command:
```
java agent_WINNT_domino -nodisplay -saveState filename
```
-saveState

An option that saves all of your responses to installation prompts in a state file.

filename

Represents the name that you choose for the state file.

Enter the installation information as described in GUI Installation of Agent for IBM Lotus Domino 6.5.4 on Windows Systems

Your answers to the prompts are recorded in the state file. When the installation is complete, the state file is created in the same directory where the installation program is located.

Note –
When generated, a state file will have read permissions for all users. However, because the state file contains clear text passwords, change the file permissions to restrict read and write access to the user root.

Using a State File for a Web Agent Silent Installation on Windows Systems

This section describes how to use a state file for installing a web agent on Windows systems.

To Install a Web Agent Using a State File on Windows Systems

To perform a silent installation of a web agent using a state file, perform the following:

Change to the directory in which you unpacked the agent binaries.

At this point, this directory should contain the web agent installation state file.

Issue the following command:
```
java agent_WINNT_domino -nodisplay -noconsole -state filename
```
-state

An option that directs the installer to run in non-interactive mode as it obtains all responses to prompts from the named state file.

filename

Represents the name of the state file from which the installer obtains all responses.

The installation takes place hidden from view. After completion, the program exits automatically and displays the prompt.

Note –
Even though the silent installation does not validate the keys in the state file, avoid editing the values of the keys in the state file because the setupSDK script might report a corrupt state file when used during subsequent silent installations.