|
Size: 2363
Comment: Local Merge - 'FslDev'
|
Size: 3713
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 2: | Line 2: |
| An automated installer, `fsl_installer.sh` is available to carry out the installation of (or application of a patch to) FSL, configuring your environment to enable you to run FSL from your terminals. | The `fslinstaller.py` script carries out the installation of FSL, configuring your environment to enable you to run FSL from a terminal (`/Applications/Utilities/Terminal.app`) window. |
| Line 4: | Line 4: |
| On Mac OS platforms it will also install FSLView into `/Applications` and if you use Mathworks' MATLAB it will configure your `startup.m` file to allow you to use the FSL MATLAB functions. [[attachment:fsl_installer.sh]] - Version 1.6 09/02/2012 = Running the installer = The installer runs from within a terminal session, so you need to open a terminal: * Linux (Centos) . The Terminal application can be found in `Applications > System Tools > Terminal` menu * Mac . The Terminal application can be found in `/Applications/Utilities` In the terminal change to the folder containing the downloaded file and run it (for example if you downloaded to your Downloads folder): {{{#!highlight bash numbers=disable cd ~/Desktop sh fsl_installer.sh }}} Assuming that this folder also contains the FSL distribution tar file and you wish to install into `/usr/local` then just press Return when the installer asks a question, to accept the defaults. |
= Running the installer (on macOS or Linux) = |
| Line 27: | Line 8: |
| Installation into certain folders on your computer (eg `/usr/local`) may require administrative privileges. If this is the case, the installer will attempt to gain these privileges through the use of the `sudo` command, which will require you to enter your password for verification. If you don't have any rights to use `sudo` then the installer will fail and will need to be run as the `root` user. Should you install as `root` see the [[FslInstaller/ShellConfigure|configuring your account for FSL]] section for details on how to use the installer to setup your user account for FSL. | Installation into certain folders on your computer (e.g. the default, `/usr/local`) may require administrative privileges. If this is the case, the installer will attempt to gain these privileges through the use of the `sudo` command, which will require you to enter your password for verification. If you don't have permission to use `sudo` (an administration account on macOS) then the installer will fail and will need to either install into a folder belonging to your user or to run the installer as the `root` user. Should you install as `root` see the [[FslInstallation/ShellSetup|configuring your account for FSL]] section for details on how to use the installer to setup your user account for FSL. |
| Line 30: | Line 11: |
| == Installing as root user on Linux == If you need to install as the `root` user, you can do this using these commands (again assuming you downloaded to the your Desktop folder): |
The installer requires access to the internet to be able to download the FSL software appropriate for your platform and runs from within a terminal session, so you need to open a terminal: * Linux (Centos 7) . The Terminal application can be found in `Applications > Utilities > Terminal` menu * macOS . The Terminal application can be found in `/Applications/Utilities` In the terminal change to the folder containing the fslinstaller.py file and run it with python; assuming that you wish to install into `/usr/local` (the default) then just press the Return key when the installer asks where to install to. For example if you downloaded to your `Downloads` folder: |
| Line 33: | Line 21: |
| cd ~/Desktop su -c "sh fsl_installer.sh" |
cd ~/Downloads python fslinstaller.py |
| Line 36: | Line 24: |
| and entering the `root` account password. You should now configure your user account to enable FSL using the instructions in the following section. |
<<Anchor(python2_required)>> {{{#!wiki note The installer '''requires''' python 2.x to run which is the default on macOS and Centos 6 & 7, if you have installed python version 3 and made it the default when you run `python` then you will need to run it with a python 2 version, you can often find this as: * /usr/bin/python * python27 * python2.7 * python26 * python2.6 }}} Once the install completes Linux users should log out (`System (top right icon) > Log out`) and log back in to complete the FSL setup. If you are accessing the Linux computer via a remote SSH session then close the SSH session and re-login. Apple macOS users should open a new terminal window to begin using FSL. |
| Line 39: | Line 37: |
| For more information on controlling the installer, run it with the `-h` option. | if you use Mathworks' MATLAB it will configure your `startup.m` file to allow you to use the FSL MATLAB functions and on macOS platforms it will also install FSLEyes and FSLView into `/Applications`. == Advanced Options == The installer has some advanced options which may be of use, particularly when scripting installs. * -d specify folder to install FSL into (without 'fsl'), e.g. ''/usr/local'' * -e only configure your account for running FSL * -E configure FSL for all users (Linux) * -v print installer version number and exit * -c check for updated versions of FSL * -l list versions of FSL available for download * -V install specified version number e.g. ''5.0.10'' * -s download the source code for the current, or specified version of FSL * -f download the FEEDS data set for the current, or specified version of FSL * -q silence all messages * -p skip environment setup * -D switch on debug messages - use this option to generate logging that can be included when requesting installation support You can automate the installation process using the -q and -d options to prevent questions being asked and to specify the install location respectively. |
FSL Install Script
The fslinstaller.py script carries out the installation of FSL, configuring your environment to enable you to run FSL from a terminal (/Applications/Utilities/Terminal.app) window.
Running the installer (on macOS or Linux)
Administrative privileges may be required
Installation into certain folders on your computer (e.g. the default, /usr/local) may require administrative privileges. If this is the case, the installer will attempt to gain these privileges through the use of the sudo command, which will require you to enter your password for verification. If you don't have permission to use sudo (an administration account on macOS) then the installer will fail and will need to either install into a folder belonging to your user or to run the installer as the root user. Should you install as root see the configuring your account for FSL section for details on how to use the installer to setup your user account for FSL.
The installer requires access to the internet to be able to download the FSL software appropriate for your platform and runs from within a terminal session, so you need to open a terminal:
- Linux (Centos 7)
The Terminal application can be found in Applications > Utilities > Terminal menu
- macOS
The Terminal application can be found in /Applications/Utilities
In the terminal change to the folder containing the fslinstaller.py file and run it with python; assuming that you wish to install into /usr/local (the default) then just press the Return key when the installer asks where to install to. For example if you downloaded to your Downloads folder:
cd ~/Downloads
python fslinstaller.py
The installer requires python 2.x to run which is the default on macOS and Centos 6 & 7, if you have installed python version 3 and made it the default when you run python then you will need to run it with a python 2 version, you can often find this as:
- /usr/bin/python
- python27
- python2.7
- python26
- python2.6
Once the install completes Linux users should log out (System (top right icon) > Log out) and log back in to complete the FSL setup. If you are accessing the Linux computer via a remote SSH session then close the SSH session and re-login. Apple macOS users should open a new terminal window to begin using FSL.
if you use Mathworks' MATLAB it will configure your startup.m file to allow you to use the FSL MATLAB functions and on macOS platforms it will also install FSLEyes and FSLView into /Applications.
Advanced Options
The installer has some advanced options which may be of use, particularly when scripting installs.
-d specify folder to install FSL into (without 'fsl'), e.g. /usr/local
- -e only configure your account for running FSL
- -E configure FSL for all users (Linux)
- -v print installer version number and exit
- -c check for updated versions of FSL
- -l list versions of FSL available for download
-V install specified version number e.g. 5.0.10
- -s download the source code for the current, or specified version of FSL
- -f download the FEEDS data set for the current, or specified version of FSL
- -q silence all messages
- -p skip environment setup
- -D switch on debug messages - use this option to generate logging that can be included when requesting installation support
You can automate the installation process using the -q and -d options to prevent questions being asked and to specify the install location respectively.