Unicog Wiki | Main / InstructionsForInstallingMatlab

Instructions for installing Matlab

There are several types of Matlab licenses:

- NNU (Network Named User): The user having a license of this type, can use Matlab from any computer connected to the intranet of NeuroSpin.

- SNU (Standalone Named User): With this kind of license, Matlab can be installed on 4 different machines by the same user

- Concurrent: Any user do not having his/her own license can use concurrent licenses when he/she is connected to the network in NeuroSpin. There are only 4 Matlab concurrent licenses for all NeuroSpin. To check the availability of these licenses, the command matlab-license-check can be used.

- DC (Designated Computer): This type of license is installed on one computer and can be used by any user logged in this machine.

Similar rules are applied to toolboxes licenses.

In order to use your SNU license, you have to "activate" it on the computers you want to use it. When a change of type of license is done from NNU to SNU, an e-mail with the title "MathWorks Account Information" is sent to you from access@mathworks.com. This e-mail contains a login (your CEA e-mail address) and a password which will be necessary for the activation. Have this e-mail with you when you start the activation process.

On Linux workstations:

1) Execute script: /neurospin/local/matlab/bin/activate_matlab.sh

2) Follow the instructions on the different windows and push on "Next". Select "Install automatically using the Internet (recommended)". Here, your e-mail address and your password will be asked for (see the e-mail you have received from access@mathworks.com). Follow the instructions.

3) Select the license marked as SNU (usually it is the only one) and then follow the instructions again.

4) If you are working on Linux in the NeuroSpin network, SPM is automatically usable once Matlab is installed (and activated).

IMPORTANT : If the activation process does not work, call MathWorks Support (Paris - Sales and Service: +33.1.41.14.8801) and ask specifically for Damien BEREST who knows well this problem. The problem will be solved in 2 minutes.

Détails

For any SNU license bought or transferred after the release of version N of Matlab, the first activation has to be done with version N. After one successful activation on one computer, it is possible to activate version N-1 or N-2 on other computers.

For instance, after the release R2008b, the first license activation works only with R2008b. Posterior activations will work with R2008a.

It is possible to circumvent the bug by calling The MathWorks, they will correct the problem on their servers for each license, whereas a final solution is not found. Alternatively, manual activation also works, but it is more tiring...

Some explanations (from The MathWorks) in English: When new licenses are purchased, they are set to the current release. This allows them to be activated for that current release, however, a prior release cannot be activated for the first time from the Activation Client. For example, a new R2008b license will not show up in the R2008a Activation Client unless an R2008a activation has occurred in the License Center or through MathWorks Customer Support. This explains why these licenses did not appear in the Activation Client while you were logged into the correct MathWorks Account. Our development team is looking to update the Activation Client to better handle this scenario, but until then, any user who encounters this issue in the Activation Client will need to activate in the License Center or contact Customer Support.

On Windows workstations and (Windows or Linux) laptops:

1) Log in The MathWorks webpage: http://www.mathworks.fr (Log in). It is necessary to have an account (see the e-mail you have received from access@mathworks.com)

2) Once you are connected, in "My Account/Mon compte", click on "Download now" (under the name of the last release -for example "R2009b"-), then click on the link "Download" and follow all the instructions:

Step 1: Choose release --> Current Release

Step 2: Choose platform/OS combinations --> Windows or Linux depending on your particular case

Step 3: Choose product versions --> Typical

Push on "Continue"

3) Open or copy-and-execute file "download_agent": choose the target directory and then push button "Download". Wait for the end of the download. Check "Start Installer" and then push on "Finish". Wait for the end of the installation.

If the installation does not start automatically, go to the directory where you have copied everything and, in one terminal/console, execute these commands (instructions are detailed in file inst_doc.pdf, section for "Standalone Environment"):

tar -xf boot.ftp

./install

Next, select "Install automatically using the Internet (recommended)". Follow the instructions. If you do not have an account yet, you will have to create it.

4) Select the license marked as SNU (usually it is the only one) and follow the instructions.

5) At the end of the installation, by default, "Activate Matlab" is checked. Let it be and proceed to the installation. Put your CEA login in "Windows User Name" (ex. am985309).

Note 1: The activation can also be done from The MathWorks web page, "My Licenses", tab "Activation and Installation". In order to have the "Host ID" follow instructions.

Note 2: If on Linux you cannot execute Matlab from anywhere (not possible to create a symbolic link from /usr/local/bin), you can add the following line into your .bashrc file (path to the place where Matlab is installed):

PATH=$PATH:~/programs/matlab_R2008b/unix/bin

and you will be able to launch Matlab with command "matlab" on a terminal/console.

SPM5 installation (if necessary)

a) Download SPM5 (spm5.tar.gz) from the webpage: http://www.fil.ion.ucl.ac.uk/spm/software/download.html or directly from: http://www.fil.ion.ucl.ac.uk/cgi-bin/uncgi/spmreg

b) Also download the last updates (Updates_XXXX.tar.gz): ftp://ftp.fil.ion.ucl.ac.uk/spm/spm5_updates/ (at present Updates_3381.tar.gz)

c) Decompress file spm5.tar.gz (into C:\Program files\SPM, for example) and do the same thing with Updates_XXXX.tar.gz (into directory C:\Program files\SPM\spm5 this time, replacing the existing files). Be careful: before doing this, you have to deactivate option "Conversion CR/LF" if you are working on Windows (in WinZip --> Options --> tab Divers/Miscellaneous, then Autres/Others -2nd line-).

d) Finally, if working on Windows, in Matlab directory "work" -create it if it does not exist- (ex. C:\Program Files\MATLAB\R2008a\work), create a file named "startup.m" and write inside the following line: addpath('C:\Program Files\SPM\spm5') Next, it is possible to run Matlab and then SPM5 with command "spm" (you can verify Matlab "paths" with command "editpath").

If this does not work (with Linux on a laptop, for instance), once in Matlab, execute command "editpath" and then add directory C:\Program Files\SPM\spm5 (or the one you have chosen in Linux) and push button "Save".

Updated January 15th 2010