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

To do a silent setup at the server

Procedure

  1. Install the Domino® server program files on a server system but do not run the Domino® server setup program.
  2. (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.
  3. 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.
  4. 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.
  5. 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

  1. Make sure that you selected Remote server setup when you installed Domino® Administrator on the client system.
  2. Install the Domino® server program files on a server system, but do not run the Domino® server setup program.
  3. (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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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

  1. Install the Domino® server program files on a server system, but do not run the Domino® server setup program.
  2. (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.
  3. 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.
  4. On the client system, install the Java runtime environment.
  5. 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
  6. 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

  7. 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.
  8. 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.
  9. Check the errorlog.txt file to confirm that the setup is complete, or to view any error messages that were generated during setup.
  10. 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