Starting InterSystems IRIS for Maintenance

Starting InterSystems IRIS for Maintenance

During any restore procedure it is critical that no application activity occurs in the databases being restored until you are completely finished with the backup restore and journal restore, and you have completed any desired application-level validation. If you have in your application or operating environment, a mechanism to ensure that no user activity can occur when the database is started, then you can use that mechanism; for example, if your application is entirely web-based, shutting down the web servers may be sufficient to ensure that only administrators involved in the restore procedure have access to the system.

InterSystems IRIS provides a mechanism to let you start the system with limited access while maintenance is performed.

To start InterSystems IRIS for maintenance:

1. Start InterSystems IRIS in emergency access mode, specifying a unique username and password to be used for all maintenance activity; this username and password should not match any existing user:

   • On Windows, invoke the following command as administrator from the bin directory of your installation:

     iris start <db-instance-name> /EmergencyId=<username>,<password>
     

     

   • On UNIX®/Linux and macOS platforms, invoke the following command:

     iris start <db-instance-name> EmergencyId=<username>,<password>
     

     

   For more information, see Emergency Access.

2. Perform the remaining portions of the restore procedure as documented for your restore scenario.

3. After completing the restore procedure — including any journal restore, application validation, or other maintenance activities — make the system available to users as follows:

   1. Shut down the database.

   2. Start the database without the EmergencyId switch.