Manually restore agent instances when the automatic restore fails
You are upgrading dynamic agents or fault-tolerant agents using either the centralized agent update method or the twsinst script, but the update process fails and starts the automatic restore process. If the automatic restore process fails, you need to manually restore the old agent instances.
Cause and solution
The automatic restore process might fail for several causes,
for example, the automatic process does not have the necessary space
to perform the operation. If you want to manually restore the old
agent instance, complete the following steps:
- On the workstation where the agent is installed, go to the temporary
directory, where the selfupdate script backs up
the agent installation directory. The default temporary directory
value is:
- Centralized agent update method
- On Windows operating systems:
- %TEMP%\backupTWS\date
- On UNIX operating systems:
- /tmp/backupTWS/date
- twsinst script upgrade method
- On Windows operating systems:
- <working_dir>>\backupTWS\date
- On UNIX operating systems:
- <working_dir>>/backupTWS/date
- Locate the agent_instance_backup_dir backup directory for your agent instance.
- Copy the content of the following directory to the TWS_agent_inst_dir agent
installation directory:
- Centralized agent update method
- On Windows operating systems:
- %TEMP%\backupTWS\date\agent_instance_backup_dir
- On UNIX operating systems:
- /tmp/backupTWS/date/agent_instance_backup_dir
- twsinst script upgrade method
- On Windows operating systems:
- <working_dir>\backupTWS\date\agent_instance_backup_dir
- On UNIX operating systems:
- <working_dir>/backupTWS/date/agent_instance_backup_dir
- In the TWS_agent_inst_dir directory, re-create the stdlist directory.
- Manually delete the following lock file:
- Centralized agent update method
- On Windows operating systems:
- %TEMP%\twsselfupdate.lock
- On UNIX operating systems:
- /tmp/twsselfupdate.lock
- twsinst script upgrade method
- On Windows operating systems:
- <working_dir>\twsselfupdate.lock
- On UNIX operating systems:
- <working_dir>/twsselfupdate.lock
- Restart the agent instance.