2.6 How to install USPEX

USPEX v.10.2 and higher versions are compiled using Matlab compiler in order to be used as a standalone code. Thus, there is NO need to install Matlab for using this version of the code. Instead, for running USPEX v.10.2, Matlab Runtime software (MCR-R2016b) must be installed on the target machine. The USPEX package contains proper version of MCR for running USPEX and the installation of both MCR and USPEX would be done together.

After you download the archive with USPEX, you need to unpack it and run the following command to install USPEX to a user’s or system-wide location:

    sh install.sh

The installer does not require root privileges, unless you want to install codes in the root partition. For installing USPEX v10.2 together with MCR-R2016b one needs four simple steps:

• Choose the method for installation (graphical or terminal installation)

• Accept terms and conditions of both USPEX and MCR user licenses.

• Select the installation directory of USPEX and MCR (If the installation directory was chosen to be in the root partition, the user needs to have root privilege).

• Setting up the information about environmental variables (it will be done automatically in terminal installation).

For the last step, if the terminal installation is selected, information about environmental variables will be added automatically to the .bashrc (bash shell system) or .cshrc ( C shell system). For graphical installation, you will be provided with information about environmental variables during the installation process, which must be set by the user, to make USPEX available in the system. For example:

   For Bash shell system, add these lines in ~/.bashrc or ~/.profile or /etc/profile:
        export PATH=/home/user/bin/USPEX/application/archive/:$PATH 
        export USPEXPATH=/home/user/bin/USPEX/application/archive/src 
        export MCRROOT=/usr/local/MATLAB/MATLAB_Runtime

   For C shell system, add these lines in ~/.cshrc or ~/.profile or /etc/profile:
        setenv PATH "/home/user/bin/USPEX/application/archive :$PATH" 
        setenv USPEXPATH "/home/user/bin/USPEX/application/archive/src"
        setenv MCRROOT “/usr/local/MATLAB/MATLAB_Runtime”

*** Please note that MCRROOT is the path before the folder “v91”.

*** It is essential to run the following command to avoid encountering errors when running USPEX examples and to make working with USPEX more pleasant.

   chmod +rw -R  /installation path of USPEX/application/archive/