Simscope Upgrade Flow
Simscope has periodic software update releases, to add new features or fix bugs.
Most of the updates are seamless, requiring just a download/untar. If configuration or database schema updates are required, these will be documented in the release info.
Standard Upgrade Procedure
For standard Simscope updates:
(terminal)Download and untar release file
# NOTE: this path comes from VerOps email
> wget SIMSCOPE-RELEASE.tar.gz
> tar zxf SIMSCOPE-RELEASE.tar.gz
(terminal)Change the latest symlink
> rm simscope-latest && ln -s SIMSCOPE-RELEASE simscope-latest
-
(Web Browser)Admin → Shutdown Simscope server -
(terminal)Start the new Simscope
Restart: Alternative if you are using Services
If you have configured Simscope to run as a Daemon/Service, you can run:
> sudo service simscoped restart
To restart the service.
Tunnel
Note: You can keep the Simscope Tunnel running while the Simscope server is stopped and being upgraded.
- Simscope and Tunnel services are independent of each other, and can be stopped/started independently.
- Data will be queued within RabbitMQ while either of the services are stopped, so you will not lose data.
Rollback
If the new Simscope version fails to run, you can rollback to a previous version, by re-symlinking the previous Simscope directory and starting it.