Backup and rebuilding procedure for the IRIS serverContestant
I have experienced that my iris server is gone due to upgrading the docker version when I have built IRIS server on docker container.
Based on this experience, I'd like to show you how to make a backup for the IRIS server before upgrading platform or docker, and the procedure for rebuilding the IRIS in a new environment.
IRIS server backup procedure
When you have finished building for the IRIS server, you need to make a backup.
I recommend you that you make a backup before upgrading if you have classes,routines and globals that you want to take over when you rebuild your environment.
This "{}" mark indicates an input parameter.
- Export user definisions.
Export all user settings defined on the IRIS server.
zn "%SYS"
write ##class(Security.Users).Export({output full path})
- Export application definitions.
Export all application settings defined on the IRIS server.
zn "%SYS"
write ##class(Security.Applications).Export({output full path})
- Stop the IRIS server.
Stop the IRIS server with running IRIS instance name as input parameter.
iris stop {instance name of IRIS server}
- Backup the iris.cpf.
iris.cpf is located in install directory.
Ex) /usr/irissys/iris.cpf
- Backup all databases.
Backup IRIS.DAT of all databases.
I recommend you back up each database directory.
- Start the IRIS server.
Start the IRIS server with IRIS instance name as input parameter.
iris start {instance name of IRIS server}
IRIS server rebuilding procedure
If you reinstall the IRIS server, you must rebuild it with the same configuration as when you backed it up.
-
Deploy the databases with the same configuration as when you backed them up.
Deploy IRIS.DAT to the same directory as when you backed it up. -
Install the IRIS server.
-
Stop the IRIS server.
Stop the IRIS server with IRIS instance name as input parameter.
iris stop {instance name of IRIS server}
-
Replace the iris.cpf to when you backed it up.
-
if necessary, change the permission of the iris.cpf.
If it doesn't work, you should try to change permission the file.
- Start the IRIS server.
Start the IRIS server with IRIS instance name as input parameter.
iris start {instance name of IRIS server}
- Import user definitions.
Import user definitions using the file when you exported it.
zn "%SYS"
write ##class(Security.Users).Import({full path of back up file})
- Import application definitions.
Import application definitions using the file when you exported it.
zn "%SYS"
write ##class(Security.Applications).Import({full path of back up file})
- if necessary, you recompile the classes and routines.
Recompilation may be necessary.
That's all for the procedures for rebuilding the IRIS server from backup files (not just IRIS.dat).