How to move a Domino server on IBM i from one system to another

Technote (FAQ)


Question

You wish to move a Lotus® Domino® server running on the IBM® i operating system (formerly i5/OS®) from one system to another.

Answer

Below is a procedure to assist you, based on the following assumption:

  • You will be using the same Domino server name and IP address(es) on the new system.




Preparations on the new system
1. Install the Domino code on the new system. We recommend that you use the same version of Domino as on your existing system; however, you may use a more recent version of Domino if needed.

2. Verify all required licensed program products and group PTFs have been applied to the new system.

3. Create the appropriate TCP/IP interfaces and host table entries. Use CFGTCP options 1 and 10 to complete these tasks or contact the i Support Center for assistance.



Steps to create a dummy server on the new Power system

1. On the new power system, configure the Domino server using the same server name, organization name, subsystem name and data directory path as the existing server. For example, from an i command line, use the command:


CFGDOMSVR SERVER(Server_Name) OPTION(*FIRST) DTADIR('/Notes/Data')
ORG(org) ADM(Last First *N (password)) SBS(Subsystem_Name)

Note: The vast majority of the settings will be overwritten when you restore the data directory so only the critical settings are shown in the example above.
    Note: If you have not created the actual IP interface on the system or the original system is running, you can use any IP address available on the new system at this time.
      Note: If you have multiple releases of the Domino program product installed on the new server, be sure to qualify the CFGDOMSVR command with the install library for the release level you desire. For example, if you have release 8.5.1 and release 8.0.2 installed on the server, and you wish to create a 8.0.2 server, qualify the CFGDOMSVR command as follows:
          QDOMINO802/CFGDOMSVR
      For more information about running multiple Domino releases on the same Power system or lpar, refer to the redpiece Lotus Domino 6 Multi-Versioning Support on the IBM iSeries Server

        2. Start the server on the new box to verify that it will start with the command:

        STRDOMSVR <Server_Name>

        3. End the server you just configured on the new system:

        ENDDOMSVR <Server_Name>

        4. Now that the server has been configured, you should now remove all of the data created for this new server. Do this by entering the following command:

        EDTF '/'
        Take option 9 next to the server's data directory to delete all subdirectories and files.

        5. Recreate the data directory on the new system using the CRTDIR command. For example, enter the following commands to create the directories (assuming a directory of /notes/data):

        CRTDIR '/notes'
        CRTDIR '/notes/data'

        6. You must now change the ownership of the data directory so it is owned by QNOTES. For example, enter the following commands:

        CHGOWN '/notes' NEWOWN(QNOTES) SUBTREE(*ALL)




        Steps to backup the original server & restore on the new system
        1. Create a backup of the original server. To do this, first you must end the Domino server.

        ENDDOMSVR <Server_Name>

        2. Back up your data directory. Data can be saved to tape or save file. To use a save file, you must create it with the following command:

        CRTSAVF <Library_Name>/<File_Name>

        To save the Domino data directory to a save file, from an i command line, type the following (replace /notes/data with your actual data directory path):

        SAV DEV('/QSYS.LIB/<Library_Name>.lib/<File_Name>.file') OBJ(('/notes/data'))

        To save the Domino data directory to a tape, use the following:

        SAV DEV('/QSYS.LIB/TAP01.DEVD') OBJ(('/notes/data'))

        Note: Replace TAP01 with the actual name of your tape device

        3. Verify the save was successful by reviewing your joblog. From a command line, type the following

        DSPJOBLOG

        4. Move the tape or save file to the new system. If you used a save file, you can use FTP to transfer the file to the new system and then use the following command to verify the save file contents on the new system:

        DSPSAVF <Library_Name>/<File_Name>

        5. Restore the Domino data on the new system using one of the following commands (replace /notes/data with the actual data directory path).

        To restore the Domino data directory from a save file, use the following:

        RST DEV('/QSYS.LIB/<Library_Name>.lib/<File_Name>.file') OBJ(('/notes/data'))

        To restore the Domino data directory from a tape, use the following:

        RST DEV('/QSYS.LIB/TAP01.DEVD') OBJ(('/notes/data'))

        Note: Replace TAP01 with the actual name of your tape device

        6. If you have not done so already, create the correct IP interface on this system. End the interface on the old system and start it on the new system. Also be sure that the host table has been modified on the new system to include this IP address. You can create the interface from CFGTCP option 1 and modify the host table from CFGTCP option 10.

        7. Once the interface is active, you can start the server on the new system:

        STRDOMSVR <Server_Name>.



        Removing the original server
        Note: As a precaution, it is recommended that you run your new server for at least a day before removing your original server.

        1. Remove your Domino server. At a command line, type

        CFGDOMSVR SERVER(<Server_Name>) OPTION(*REMOVE)

        Related information

        FTP Example for Transfering Save Files
        Configuring a TCP/IP Interface
        Customizing the Host Table
        Moving a Sametime Server from one system to another
        Lotus Domino 6 Multi-Versioning Support on the IBM iSer

        Historical Number

        194748

        Rate this page:

        (0 users)Average rating

        Add comments

        Document information


        More support for:

        IBM Domino

        Software version:

        8.0, 8.5, 9.0

        Operating system(s):

        OS/400, i5/OS

        Reference #:

        1092419

        Modified date:

        2010-06-04

        Translate my page

        Machine Translation

        Content navigation