If you already have RiskScape installed on your system, here’s how to upgrade the software to a more recent version.
To upgrade RiskScape you must first remove your current copy.
Simply extracting a new version of
riskscape.zip over the top of an
existing version may result in errors or unexpected behaviour.
We recommend you have Java version 17 (or higher) installed on your computer. The next RiskScape release (v1.5.0) will require a minimum of Java 17 installed in order to run.
Replace the old installation directory
First, work out the directory location where RiskScape is already installed. If you cannot remember the installation location, try one of the following:
If you have added
riskscapeto your system
PATH, then you can use:
get-command riskscape.baton Windows (PowerShell).
where riskscape.baton Windows (Command prompt).
which riskscapeon Linux or Mac.
C:\Users\demo> where riskscape.bat C:\RiskScape\riskscape\bin\riskscape.bat
Or, if you use a Windows shortcut (alternative) to run RiskScape, right-click on the shortcut and click ‘Edit’.
The RiskScape installation directory will be on the
Set-Aliasfor PowerShell). E.g.
doskey riskscape=C:\RiskScape\riskscape\bin\riskscape.bat $*
In these examples,
C:\RiskScape is our installation directory, and everything under that
was extracted from the
riskscape.zip file previously.
Rename the existing
riskscape directory, e.g. to
A good approach is to rename it
X.Y.Z matches the version number
in your current
riskscape --version output.
C:\Users\demo> cd C:\RiskScape C:\RiskScape> move riskscape riskscape-v0.5.5
Although you could simply delete the old
renaming it is better, as you can still run older versions of RiskScape
easily if needed. This ensures reproducibility of your model’s results,
i.e. you can regenerate results with exactly the same software as used
in a publication.
Install the new RiskScape Zip file
Download the latest RiskScape zip file
and extract the contents into your installation directory, e.g.
Open a terminal prompt and check that RiskScape still works, and is now the expected version. You may want to try the full executable path first, as a sanity-check. E.g.
C:\RiskScape\riskscape\bin\riskscape.bat --version riskscape --version
If the shorter
riskscape command does not work, your installation directory path
may have changed slightly.
If you are using a Windows shortcut script,
then check the installation path in it is correct (i.e. the
If you do not use a Windows shortcut, then check your
PATH environment variable
bin/ directory for the RiskScape installation.
echo %PATH%on Windows
echo $PATHon Linux or Mac
Refer to the installation instructions on how to set