Healthcare Mirroring

Healthcare mirroring assumes a stable base mirror configuration:

• Confirm that your mirror set, failover members, and any DR async members are configured according to the general mirroring procedures in Configuring Mirroring.

• Verify that mirroring and journaling are functioning normally on all members.

All mirror members must meet the InterSystems IRIS instance compatibility requirements. These include version alignment, locale and character-width compatibility, and consistent database block size settings.

For details, see InterSystems IRIS Instance Compatibility.

Before performing any healthcare-specific setup, verify that all mirrored databases report a Caught Up or Synchronized status in the Mirror Monitor of all backup failover and async mirror members.

If mirror members are not fully synchronized, follow the Activate and Catch Up the Mirrored Database procedure in Restore a Mirrored Database from Backup. Ensure that all members are fully synchronized before proceeding with healthcare-specific mirroring steps.

The HS_Services user provides the credentials used by interoperability components in mirrored healthcare systems. The user must be enabled and synchronized across all mirror members.

To enable the user and update its password, follow the procedure below on the primary mirror member:

1. Open the Management Portal and switch to the HSSYS namespace.

2. Navigate to System Administration > Security > Users.

3. Find the HS_Services user in the list of user definitions.

4. Click the Profile option in the HS_Services user row.

5. In the HS_Services user profile, select Edit User and navigate to the General tab.

6. Select Enter new password and set a secure password.

7. Select the User enabled option.

8. Click Save to update the user definition.

After completing these steps on the primary member, repeat the procedure on all other mirror members, setting the password to match the one configured on the primary.

Once the HS_Services user is enabled and synchronized with a secure password on all mirror members, update the associated interoperability credential on the primary mirror member:

1. Verify that the current namespace is HSSYS.

2. Navigate to Interoperability > Configure > Credentials in the Management Portal.

3. Locate and select the HS_Services credential.

4. Confirm that the User Name is HS_Services.

5. Enter the same password defined for the HS_Services user account. The HS_Services user definition password and interoperability credential must match.

6. Click Save to apply the changes.

For more information, see Defining Credentials.

The Mirror Monitor Agent synchronizes configuration data stored in IRISSYS between the primary and non-primary mirror members. Scheduling this task ensures that application-generated configuration changes, such as updates to roles, resources, mappings, and CSP applications, remain consistent across all members.

The Mirror Monitor Agent replicates only changes made by the InterSystems IRIS for Health or Health Connect applications. It does not synchronize manual modifications made directly through the Management Portal (for example, user-created roles or CSP applications).

Information about the Mirror Monitor Agent can be viewed from the Health menu in the top banner, next to the Installer Wizard. This interface displays details about configuration steps that have been run. To ensure the displayed information remains accurate, a virtual IP (VIP) must be configured and operational. The VIP allows backup and DR members to notify the primary member of completed steps, ensuring the dashboard remains synchronized. For more information about VIPs, see Network Host Name Configuration.

To automatically configure and schedule this task, as well as mirror the HSSYS database, use the HSSYS Mirroring Utility.

Alternatively, manually schedule the task on each mirror member:

1. Open the Terminal.

2. Switch to the HSSYS namespace:

   ZN "HSSYS"
   

   

3. Schedule the Mirror Monitor Agent task by running:

   do ##class(HS.Util.Mirror.Task).Schedule("HSSYS")
   

   

4. Confirm that the task is scheduled to run every five minutes.

To verify the task:

1. In the Management Portal, navigate to System Operation > Task Manager > Task Schedule on each member.

2. Verify that the Task Schedule lists a task named Mirror Monitor Launch Task configured to run every five minutes in the HSSYS namespace.

3. Check that the next scheduled run time is within the expected interval.

To add the HSSYS database to the mirror configuration, follow this procedure on the primary member:

1. Open the Management Portal and navigate to System Administration > Configuration > System Configuration > Local Databases.

2. Choose Add to Mirror, select HSSYS, and then click Add.

3. Verify that the HSSYS database now appears in the list of mirrored databases.

After adding HSSYS to the mirror on the primary member, follow the standard procedures for making mirrored databases available on other members, activating, and catching up.

See Copying an Existing Mirrored Database to Additional Members for the supported methods.

If required, after completing your chosen method, mount and synchronize the HSSYS database following the standard mirrored database procedures described in Restore a Mirrored Database from Backup.

On each mirror member:

1. In the Management Portal, navigate to System Operation > Mirror Monitor.

2. Confirm that the HSSYS database appears in the mirrored database list.

3. Verify that its mirror status shows Caught Up.