Using Domino® silent server setup with a profile

You can use a server setup profile to set up a Domino server silently without viewing the setup screens. You can do a silent setup at the server you are setting up or from a client system.

Before you begin

Complete the procedure Creating a server setup profile.
Complete any pending reboot actions.

To do a silent setup at the server

Procedure

Install the Domino® server program files on a server system but do not run the Domino® server setup program.
(UNIX only) Log on to the Domino system as the user you specified during Domino server installation. This is the same user you'll use to start the Domino server.
If the profile uses existing server, certifier, or administrator IDs that require passwords, create a text file that contains a <keyword>=<password> combination for each type of ID that requires a password. The following example shows the contents of a text file with each keyword used:
```
Server=passw0rd
AddServer=passw0rd
Certifier=passw0rd
OUCertifier=passw0rd
Administrator=passw0rd
```
Note: Put the .txt file in the Domino data directory. On a UNIX server, the Domino setup code requires read access to the file.
At the command prompt on the server, switch to the Domino data directory. (If you installed a partitioned server, switch to the data directory of the partition you are setting up.) Then, enter the following command:
```
<path_to_Domino_server_executeable> -silent <path_to_profile_file> =<path_to_partition_notes.ini> <path_to_txt_file> 
```
where
<path_to_Domino_server_executeable> is the full path to the Domino server executable.
<path_to_profile_file> is the path to the .pds profile file. If the profile file is not in the root directory, specify the full path to it.
<path_to_partition_notes.ini> is the path to the notes.ini file in the data directory of a partitioned server. Precede the path with an equal sign (=).
<path_to_txt_file> is the path to a .txt file that you created in the Domino server data directory to specify ID passwords.
Example on a Windows server (single server, no password txt file):c:\Domino\nserver.exe -silent c:\temp\Profile.pds
Example on a Windows server (partitioned server, password txt file):c:\Domino\nserver.exe -silent c:\temp\Profile1.pds =c:\Domino\Data1\notes.ini c:\Domino\Data1\password.txt
Example on a UNIX server (single server, no password txt file):/opt/hcl/domino/bin/server -silent /tmp/Profile.pds
Example on a UNIX server (partitioned server, password txt file):/opt/hcl/domino/bin/server -silent /tmp/Profile1.pds =/local/notesdata1/notes.ini /local/notesdata1/password.txt
Note: Entering nserver -help or server -help displays the parameters available for working with server setup profiles.
Check the errorlog.txt file in the Domino® data directory to confirm that the setup is complete or to view any error messages that were generated during setup.

To do a silent setup from a Windows™ client with Domino® Administrator

Procedure

Make sure that you selected Remote server setup when you installed Domino® Administrator on the client system.
Install the Domino® server program files on a server system, but do not run the Domino® server setup program.
(UNIX server only) Log on to the Domino system as the user you specified during Domino server installation. This is the same user you'll use to start the Domino server.
At the command prompt on the server, switch to the Domino data directory. (If you installed a partitioned server, switch to the data directory of the partition you are setting up.) Then, enter the following command, to put the server in listen mode:
```
<full_path_to_Domino_server_executeable> -listen
```
Example on a Windows™ server:
```
C:\Domino\nserver -listen
```
Example on a UNIX™ server:
```
 /opt/hcl/domino/bin/server -listen
```
Note: Entering nserver -help or server -help displays the parameters available for working with server setup profiles.
If the profile uses existing server, certifier, or administrator IDs that require passwords, create a text file on the Domino server that contains a <keyword>=<password> combination for each type of ID. The following example shows the contents of a text file with each keyword (ID type) used:
```
Server=passw0rd
AddServer=passw0rd
Certifier=passw0rd
OUCertifier=passw0rd
Administrator=passw0rd
```
Note: Put the .txt file in the Domino data directory. On a UNIX server, the Domino setup code requires read access to the file.
At the command prompt on the Windows client, switch to the Notes program directory, and enter the following command:
```
serversetup -silent <path_to_profile_file> <path_to_txt_file> -remote <serveraddress> =<path_to_partition_notes.ini> 
```
where

<path_to_profile_file> is the path to the .pds profile file on the Windows client. If the profile file is not in the root directory, specify the full path to it.
<path_to_txt_file> is the path to a .txt file that you created in the Domino server data directory to specify ID passwords.
<serveraddress> is the host name or network address of the server you are setting up.
<path_to_partition_notes.ini> is the path to the notes.ini file in the data directory of a partitioned server. Precede the path with an equal sign (=).

Example on a Windows server (single server, no password txt file):
serversetup -silent C:\Profile.pds -remote mail2.renovations.com
Example on a Windows server (partitioned server, password txt file):
serversetup -silent C:\Profile1.pds C:\password.txt -remote mail2.renovations.com =C:\Domino\Data1\notes.ini
Example on a UNIX server (single server, no password txt file):serversetup -silent C:\Profile.pds -remote mail2.renovations.com
Example on a UNIX server (partitioned server, password txt file):serversetup -silent C:\Profile1.pds /local/notesdata/password.txt -remote mail2.renovations.com =/local/notesdata1/notes.ini
Note: Entering nserver -help or server -help displays the parameters available for working with server setup profiles.
Check the errorlog.txt file in the Notes® data directory to confirm that the setup is complete, or to view any error messages that were generated during setup.
After setup is complete, switch to the Notes program directory on the client and enter the following command to stop the listener on the Domino server:
```
serversetup -q <serveraddress>
```
For example:
```
serversetup -q mail2.renovations.com
```

To do a silent setup from a Windows™ client without Domino® Administrator or from a UNIX™ workstation

Procedure

Install the Domino® server program files on a server system, but do not run the Domino® server setup program.
(UNIX server only) Log on to the Domino system as the user you specified during Domino server installation. This is the same user you'll use to start the Domino server.
At the command prompt on the server, switch to the Domino data directory. (If you installed a partitioned server, switch to the data directory of the partition you are setting up.) Then, enter the following command, to put the server in listen mode:
```
<full_path_to_Domino_server_executeable> -listen
```
Example on a Windows™ server:
```
C:\Domino\nserver -listen
```
Example on a UNIX™ server:
```
/opt/hcl/domino/bin/server -listen
```
Note: Entering nserver -help or server -help displays the parameters available for working with server setup profiles.
On the client system, install the Java™ runtime environment.
Create a temporary directory on the client system. For example, enter the following at the command prompt:
- On a Windows™ client:
```
mkdir c:\temp
```
- On a UNIX™ workstation:
```
mkdir /temp
```
Do one of the following:
- From a Windows™ client, copy the remote setup files cfgdomserver.jar, jhall.jar, and remotesetup.cmd from the server to the directory you created on the client system. These files are in C:\<Domino program directory> on the server.
- From a UNIX™ workstation, copy the remote setup files cfgdomserver.jar, jhall.jar, and remotesetup from the server to the directory you created on the workstation. These files located in the following directories:
  /<Domino program directory>/notes/latest/ibmpow/ on an IBM® AIX® server
  /<Domino program directory>/notes/latest/linux/ on a Linux™ server
If the profile uses existing server, certifier, or administrator IDs that require passwords, create a text file on the Domino server that contains a <keyword>=<password> combination for each type of ID. The following example shows the contents of a text file with each keyword (ID type) used:
```
Server=passw0rd
AddServer=passw0rd
Certifier=passw0rd
OUCertifier=passw0rd
Administrator=passw0rd
```
Note: Put the .txt file in the Domino data directory. On a UNIX server, the Domino setup code requires read access to the file.
At the command prompt on the client, switch to the Notes program directory, and enter the following command:
```
remotesetup -silent <path_to_profile_file> <path_to_txt_file> -remote <serveraddress> =<path_to_partition_notes.ini> 
```
where

<path_to_profile_file> is the path to the .pds profile file on the client. If the profile file is not in the root directory, specify the full path to it.
<path_to_txt_file> is the path to a .txt file that you created in the Domino server data directory to specify ID passwords.
<serveraddress> is the host name or network address of the server you are setting up.
<path_to_partition_notes.ini> is the path to the notes.ini file in the data directory of a partitioned server. Precede the path with an equal sign (=).

Example on a Windows server (single server, no password txt file):
remotesetup -silent C:\myprofile.pds -remote mail2.renovations.com
Example on a Windows server (partitioned server, password txt file):
remotesetup -silent C:\Profile1.pds C:\password.txt -remote mail2.renovations.com =C:\Domino\Data1\notes.ini
Example on a UNIX server (single server, no password txt file):remotesetup -silent c:\myprofile.pds -remote mail2.renovations.com
Example on a UNIX server (partitioned server, password txt file):remotesetup -silent c:\Profile1.pds /local/notesdata1/password.txt -remote mail2.renovations.com =/local/notesdata1/notes.ini
Note: Entering nserver -help or server -help displays the parameters available for working with server setup profiles.
Check the errorlog.txt file to confirm that the setup is complete, or to view any error messages that were generated during setup.
After setup is complete, switch to the Notes program directory on the client and enter the following command to stop the listener on the Domino server:
```
serversetup -q <serveraddress>
```
For example:
```
serversetup -q mail2.renovations.com
```