Configuring manually with dominstall

A manual dominstall configuration uses user-specified input to configure the Domino Server to operate within your Data Protection for HCL Domino, and Domino Server single or multiple partition environment.

Before you begin

This procedure reflects a Data Protection for HCL Domino installation on a Linux x86_64 operating system. Directory structures and file names differ among UNIX, and Linux systems.

Procedure

  1. Log in with the user ID setup to run the Domino server.
  2. Use the su root command to switch to the root user ID.
  3. Change to the Data Protection for HCL Domino installation directory:# cd /opt/tivoli/tsm/client/domino/bin64
  4. Run the dominstall program by entering the ./dominstall command.
    To run the dominstall configuration again with the current Domino server setup, record your responses to a dominstall configuration file. Enter the following command ./dominstall dominstall.response.
    Note:
    • When the dominstall program is used and dominstall.response exists, the contents of that file is used to run a silent dominstall configuration.
    • When the dominstall program is used and dominstall.response does not exist, your responses are recorded to dominstall.response. That file can be used to run the dominstall program on other partitions without user interaction.
    For more information, see Configuring in silent mode with dominstall.
  5. Verify the directory location of the Data Protection for HCL Domino executable file:Using the Data Protection for Lotus Domino client, domdsmc, installed in /opt/tivoli/tsm/client/domino/bin. Is that correct?. (Yes (Y)/No (N))
  6. Verify the location of the Domino executable directory:Using the Domino, libnotes.so, installed in /opt/lotus/notes/latest/linux. Is that correct?. (Yes (Y)/No (N))
    • The path for Linux on x86_64: /opt/ibm/domino/notes/latest/linux.
    • The path for Linux on System z: /opt/ibm/lotus/notes/latest/linux.
    • The path for AIX: /opt/ibm/lotus/notes/latest/ibmpow.
    If multiple releases of the Domino server are installed on the system, run dominstall multiple times and specify the appropriate Domino executable directory during each invocation of dominstall.
  7. Specify the directory where the notes.ini file is stored and press Enter:
  8. Verify the directory location where the IBM Storage Protect API is stored:
    • Linux on System x: Using the IBM Storage Protect Api, libApiDS.so, installed in /usr/tivoli/tsm/client/api/bin64/libApiTSM64.a. Is that correct?. (Yes (Y)/No (N))
    • Linux on System z: Using the IBM Storage Protect Api, libApiDS64.so, installed in /usr/lib64. Is that correct? (Yes (Y)/No (N)).
  9. The dominstall program sets Notes as the owner for the Data Protection for HCL Domino executable files:Setting notes as owner for the Data Protection for Domino executables.
  10. You are prompted to configure the IBM Storage Protect web client GUI, with the following question:Do you want to configure the IBM Storage Protect Web Client? (Yes (Y)/No (N))
    • If you do not plan to use the IBM Storage Protect web client GUI, enter N and proceed to Step 11.
    • If you plan to use the IBM Storage Protect web client GUI, enter Y and follow Steps a to c.
    1. Verify the directory where the IBM Storage Protect client system options file dsm.sys is stored:
      Using the IBM Storage Protect client system options file, dsm.sys,
      installed in /opt/tivoli/tsm/client/ba/bin. Is that correct?.
      (Yes (Y)/No (N))
    2. Select the IBM Storage Protect server to be used by the web client:
      Choose the server entry used by the IBM Storage Protect Web client.
      0 serverA
      1 serverB
      2 serverC
    3. Specify a server and press Enter. The following information is shown for the selected server, serverA:
      SERVERNAME  serverA
      TCPSERV serverA.xyzcompany.com
      COMMMETH tcpip
      TCPPORT 1500
      NODENAME CADlinux
      PASSWORDACCESS generate
      PASSWORDDIR /opt/tivoli/tsm/client/ba/bin/CADpasswords
      MANAGEDSERVICES webclient
      
      Is that correct?
       (Yes (Y)/No (N))
      Enter Y to select this server entry. Enter N to select a different server entry. You are prompted to select another IBM Storage Protect server. Specify a server and press Enter. The following information is shown for the selected server, serverB:
      SERVERNAME  serverB
      TCPSERV serverB.xyzcompany.com
      COMMMETH tcpip
      TCPPORT 1500
      NODENAME linuxps
      PASSWORDACCESS generate
      
      Is that correct?
       (Yes (Y)/No (N))
      Enter Y to select this server entry, or N to select a different server entry.
  11. The dominstall program creates these symbolic links:
    Created symbolic link /opt/lotus/notes/latest/linux/domdsmc to 
    /opt/tivoli/tsm/client/domino/bin64/domdsmc.
    
    Created symbolic link /opt/lotus/notes/latest/linux/domdsmp to 
    /opt/tivoli/tsm/client/domino/bin64/domdsmp.
    
    Created symbolic link /opt/lotus/bin/domdsmc to tools/startup.
    The dominstall program continues to set notes as owner and creates symbolic links:
    Setting notes as owner for the Data Protection for Domino executable
    /opt/tivoli/tsm/client/domino/bin64/domdsmc_notes/domdsmc.
    
    Created symbolic link /opt/lotus/notes/latest/linux/domdsmc_notes to 
    /opt/tivoli/tsm/client/domino/bin64/domdsmc_notes/domdsmc.
    
    Created symbolic link /opt/lotus/bin/domdsmc_notes to tools/startup.
    ************************************************
    * Make the suggested changes to the dsm.sys file
    /opt/tivoli/tsm/client/ba/bin/dsm.sys.
    *
    * Register the node notes to the Tivoli Storage Managemer server.
    *
    * Then issue the following command to complete the setup for this 
    Domino server
    
    domdsmc query adsm -configfile=/opt/tivoli/tsm/client/domino/bin64/
    domdsmc_notes/domdsm.cfg2 
    -adsmpwd=
    ******************************************************************
  12. Verify whether the Domino server enabled for DB2:
    Is the Domino server DB2 enabled?
    (Yes (Y)/No (N))
    Enter Y if the Domino server is enabled for DB2 and enter the DB2 user name. Enter N if the Domino server is not enabled for DB2 and proceed to the next step.
  13. You are prompted to specify the directory where you want to place your profile:
    Installing profile in directory /opt/tivoli/tsm/client/domino/bin64
    
    Is that correct?.
     (Yes (Y)/No (N))
    Enter Y if the directory listed is where you want to place your profile. Enter N if the directory listed is not where you want to place your profile. You are prompted for the directory where you want to place your profile. Specify the directory and press Enter. The dominstall program continues to set notes as owner, and creates symbolic links. The following output shows the sequence:
    Setting notes as owner for the Data Protection for Domino executable
    /opt/tivoli/tsm/client/domino/bin64/domdsmc_notes/domdsmc.
    
    Created symbolic link /opt/lotus/notes/latest/linux/domdsmc_notes to 
    /opt/tivoli/tsm/client/domino/bin64/domdsmc_notes/domdsmc.
    
    Created symbolic link /opt/lotus/bin/domdsmc_notes to tools/startup.
    ************************************************
    * Make the suggested changes to the dsm.sys file
    /opt/tivoli/tsm/client/ba/bin/dsm.sys.
    *
    * Register the node notes to the Tivoli Storage Managemer server.
    *
    * Then issue the following command to complete the setup for this 
    Domino server
    
    domdsmc query adsm -configfile=/opt/tivoli/tsm/client/domino/bin64/
    domdsmc_notes/domdsm.cfg2 
    -adsmpwd=
    ******************************************************************
  14. At this stage your Data Protection for HCL Domino environment is configured and you are prompted to configure another Domino server partition:
    Reply with the next notesdata partition or a NULL line (enter key)
    To configure another Domino server partition, specify the Domino data directory where the notes.ini file is installed for that partition. Proceed to Step 7 of this procedure and follow the instructions. Then, complete steps 12, 13 and 14. To exit the dominstall program, press Enter. The following message is displayed:
    Data Protection for Domino installation process has successfully completed.