The HSSYS Mirroring Utility

The HSSYS database stores configuration data, metadata, and system-level information that is vital for the overall functionality of InterSystems IRIS for Health, specifically including a list of tasks to be executed on the backup member of a mirrored system.

You can automatically mirror HSSYS using the HSSYS mirroring terminal utility. The assumption is that mirroring is configured and currently in a good state, with both machines running. The utility validates that HSSYS can be mirrored, confirming that the data is consistent on each of the mirror members. There are options to validate only or to validate and then complete the mirroring of HSSYS.

Follow these steps to validate and/or automatically mirror HSSYS using the HSSYS mirroring terminal utility:

1. On the backup member, switch to namespace HSLIB.

   NAMESPACE> ZN "HSLIB"
   

2. Execute Run() or RunValidate():

   • RunValidate does not make any system changes; it only validates, reporting whether the HSSYS data is consistent across the primary and backup members.

     HSLIB> Set return = ##class(HS.HC.SYS.Mirror).RunValidate("<ip_or_dn>",<server_port>,"HSLIB","<adm_user>","<adm_pwd>",<verbose>)
     

   • Run performs validation and then, if validation succeeds, performs the actual mirror setup on HSSYS.

     HSLIB> Set return = ##class(HS.HC.SYS.Mirror).Run("<ip_or_dn>",<server_port>,"HSLIB","<adm_user>","<adm_pwd>",<verbose>)
     

   • The following argument descriptions apply to both methods:

     ip_or_dn

     The IP address or fully qualified domain name of the current primary member.

     server_port

     The Super Server port number of the primary member.

     adm_user

     The username of a user with the administrative privileges necessary to set up mirroring.

     adm_pwd

     The privileged user’s password.

     verbose

     Specify 1 for verbose output, or 0 if verbose output is not desired.

3. You can view the output on the terminal screen or by looking at the return variable:

   HSLIB> ZW return
   

4. If validation fails, mirroring setup will also fail. The return value will include helpful messages indicating how to resolve the issues causing setup to fail. Correct the issues and repeat these steps.