Library

Version 13.08 and Above

1. If you have already set up your sync attributes, skip to step 2.
   Use the following steps to define sync attributes for the library:
   1. From the Robot HA Main Menu, select option 1 to display the Work with Synchronization Attributes panel.
   2. Press F6, Create, to add as many new library sync attributes as needed.
   3. When prompted, specify a journal and remote journal name. They should be the same and be similar to the library name.​​​​​​

Note: The recommended local journal library name is JRNLIB, and the recommended remote journal library name is RMTJRNLIB.

2. Once the sync attributes have been defined, enter option BT (Begin tape process) in front of your sync attribute. This option does the following:
   • Changes the journal receiver
   • Sets a manual *BEGIN sync point
   • Places the attribute on hold

Note: Swap Audits must be turned off while completing this process.

3. Save the library however you'd prefer (on a tape, save file, or DVD) and specify the following parameters on the IBM i SAVLIB command:
   1. Set 'Object pre-check' to *YES
   2. Set 'Save active' to *LIB
   3. Set 'Save access paths' to *YES
   4. If you want your private authorities saved with the library, set 'Private authorities' to *YES
4. Make sure the target library is empty or doesn't exist on the target system, then restore the library to the target system.
   1. If you saved private authorities, set 'Private authorities' to *YES on your restore command.
   2. Before you continue, ensure the library has been restored successfully.
5. Use the following commands on the target system to disable any triggers and constraints in the library you just restored:

            CHGTRGRSF FILE(your_library/*ALL) STATE(*DISABLED)

            CHGCSTRSF FILE(your_library/*ALL) STATE(*DISABLED)

6. Once triggers and constraints are disabled, take option ET (End tape process) in front of the sync attribute. This option does the following:
   1. Sets a manual *END sync point
   2. Removes the hold from the sync attribute
7. Wait for the ET process to complete.
8. Once the previous job completes, start the replication as normal for the library. 

Version 13.07 and Below

If you do not want Robot HA to send your libraries over to the backup system, you can do it manually.

1. If you have already set up your sync attributes, skip to step 2.
   Use the following steps to define sync attributes for the library:
   1. From the Robot HA Main Menu, select option 1 to display the Work with Synchronization Attributes panel.
   2. Press F6, Create, to add as many new library sync attributes as needed.
   3. When prompted, specify a journal and remote journal name. They should be the same and be similar to the library name.

Note: The recommended local journal library name is JRNLIB, and the recommended remote journal library name is RMTJRNLIB.

2. Once the sync attributes have been defined, use the following command to change to a new, empty, journal receiver:

          CHGJRN JRN(JRNLIB/my_journal) JRNRCV(*GEN) SEQOPT(*RESET)
          Using this command helps save time whenever remote journaling starts and an attached receiver is sent from the operating system to the target system.

Note: Swap Audits must be turned off while completing this process.

3. Set a manual sync point for the library on the production system using the following steps:
   1. From the Robot HA Main Menu, select option 1 to display the Work with Sync Attributes panel.
   2. Enter option 8 beside the entry for the library you want to replicate. Then press F4 to prompt. The Synchronize Libraries panel displays.
   3. Press F10 to display additional parameters and page down.
   4. Define these parameters with the following options:
      • 'Full save: Option' to *MANUAL
      • 'Full save: Manual type' to *BEGIN
   5. ​​​​​​​Press Enter, then wait for the job to complete.
4. Save the library however you'd prefer (on a tape, save file, or DVD) and specify the following parameters on the IBM i SAVLIB command:
   1. Set 'Object pre-check' to *YES
   2. Set 'Save active' to *LIB
   3. Set 'Save access paths' to *YES
   4. If you want your private authorities saved with the library, set 'Private authorities' to *YES
5. Make sure the target library is empty or doesn't exist on the target system, then restore the library to the target system.
   1. If you saved private authorities, set 'Private authorities' to *YES on your restore command.
   2. Before you continue, ensure the library has been restored successfully.
6. Use the following commands on the target system to disable any triggers and constraints in the library you just restored:​​​​​​​​​​​​​​

            CHGTRGRSF FILE(your_library/*ALL) STATE(*DISABLED)

            CHGCSTRSF FILE(your_library/*ALL) STATE(*DISABLED)

7. Once triggers and constraints are disabled, use the following steps to remove the manual sync point from the library on the production system:
   1. ​​​​​​​From the Robot HA Main Menu, select option 1 to display the Work with Sync Attributes panel.
   2. Enter option 8 beside the entry for the library you want to replicate. Then press F4 to prompt. The Synchronize Libraries panel displays.
   3. Press F10 to display additional parameters and page down.
   4. Define these parameters with the following options:
      • ​​​​​​​​​​​​​​'Full save: Option' to *MANUAL
      • 'Full save: Manual type' to *END
   5. Press Enter, then wait for the job to complete. Message RSF7406 will be sent upon completion to the user associated with the job. 
8. Once the previous job completes, start the replication as normal for the library. 

IFS Directory

Version 13.08 and Above

1. If you have already set up your sync attributes, skip to step 2.
   Use the following steps to define sync attributes for the IFS directory:
   1. From the Robot HA Main Menu, select option 1 to display the Work with Synchronization Attributes panel.
   2. Press F11 to get to the IFS Sync Attributes.
   3. Press F6, Create, to add as many new IFS sync attributes as needed.
   4. When prompted, specify a journal and remote journal name. They should be the same and be similar to the library name.

2. Once the sync attributes have been defined, enter option BT (Begin tape process) in front of your sync attribute. This option does the following:
   • Changes the journal receiver
   • Sets a manual *BEGIN sync point
   • Places the attribute on hold

3. Save however you'd prefer (on a tape, save file, or DVD) and specify the following parameters on the IBM i SAV command:
   1. Set 'Object pre-check' to *YES
   2. Set 'Save active' to *SYNC
   3. If you want your private authorities saved with the library, set 'Private authorities' to *YES
   4. Set 'Asynchronous bring' to *YES​​​​​​​

Stand-Alone Tape Drive Example:

SAV DEV('/QSYS.LIB/TAPXX.DEVD') OBJ(('/MYDIR/*')) SAVACT(*SYNC) OUTPUT(*PRINT) SAVACTMSGQ(QSYSOPR) PRECHK(*YES) PVTAUT(*YES) ASYNCBRING(*YES)

4. Make sure the target IFS directory is empty or doesn't exist on the target system, then restore the directory to the target system.

Note: If you saved private authorities, set 'Private authorities' to *YES on your restore command.

5. Restore the IFS Folder from the SAV command to the target system:
   1. Delete the IFS directory from the target system.
   2. Run the restore command using the same settings as the save command.

Example:

RST DEV('/QSYS.LIB/TAPXX.DEVD') OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT)) CRTPRNDIR(*YES) OPTION(*NEW)

6. Confirm that the resotre completed successfully. Once the restore is complete take option ET (End tape process) in front of the sync attribute. This option does the following:
   1. ​​​​​​​Sets a manual *END sync point.
   2. Removes the hold from the sync attribute.
7. Wait for the ET process to complete.
8. Once the previous job completes, start the replication as normal for the directory. 

Version 13.07 and Below

1. If you have already set up your sync attributes, skip to step 2.
   Use the following steps to define sync attributes for the IFS directory:
   1. From the Robot HA Main Menu, select option 1 to display the Work with Synchronization Attributes panel.
   2. Press F11 to get to the IFS Sync Attributes.
   3. Press F6, Create, to add as many new IFS sync attributes as needed.
   4. When prompted, specify a journal and remote journal name. They should be the same and be similar to the library name.

2. Once the sync attributes have been defined, use the following command to change to a new, empty, journal receiver:

3. Set a manual sync point for the IFS directory on the production system using the following steps:​​​​​​​
   1. From the Robot HA Main Menu, select option 1 to display the Work with Sync Attributes panel.
   2. Press F11 to get to the IFS Sync Attributes.
   3. Enter option 8 beside the entry for the directory you want to replicate. Then press F4 to prompt.
   4. On the Synchronize Directories panel, press F10 to display additional parameters and page down.
   5. Define these parameters with the following options:
      • ​​​​​​​​​​​​​​'Full save: Option' to *MANUAL
      • 'Full save: Manual type' to *BEGIN
   6. ​​​​​​​Press Enter, then wait for the job to complete.
4. Save however you'd prefer (on a tape, save file, or DVD) and specify the following parameters on the IBM i SAV command:
   1. Set 'Object pre-check' to *YES
   2. Set 'Save active' to *SYNC
   3. If you want your private authorities saved with the library, set 'Private authorities' to *YES
   4. Set 'Asynchronous bring' to *YES​​​​​​​

Stand-Alone Tape Drive Example:

SAV DEV('/QSYS.LIB/TAPXX.DEVD') OBJ(('/MYDIR/*')) SAVACT(*SYNC) OUTPUT(*PRINT) SAVACTMSGQ(QSYSOPR) PRECHK(*YES) PVTAUT(*YES) ASYNCBRING(*YES)

5. Make sure the target IFS directory is empty or doesn't exist on the target system, then restore the directory to the target system.

Note: If you saved private authorities, set 'Private authorities' to *YES on your restore command.

6. Restore the IFS Folder from the SAV command to the target system:
   1. Delete the IFS directory from the target system
   2. Run the restore command using the same settings as the save command.

Example:

RST DEV('/QSYS.LIB/TAPXX.DEVD') OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT)) CRTPRNDIR(*YES) OPTION(*NEW)

7. Confirm that the restore completed successfully. Once the restore is complete, use the following steps to remove the manual sync point from the IFS directory on the production system:
   1. ​​​​​​​From the Robot HA Main Menu, select option 1 to display the Work with Sync Attributes panel.
   2. Press F11 to get to the IFS Sync Attributes. 
   3. Enter option 8 beside the entry for the directory you want to replicate. Then press F4 to prompt. 
   4. On the Synchronize IFS Directories panel, press F10 to display additional parameters and page down.
   5. Define these parameters with the following options:
      • ​​​​​​​​​​​​​​'Full save: Option' to *MANUAL
      • 'Full save: Manual type' to *END
   6. Press Enter, then wait for the job to complete. Message RSF7406 will be sent upon completion to the user associated with the job. 

8. Once the previous job completes, start the replication as normal for the directory.