Differences between revisions 1 and 4 (spanning 3 versions)
Revision 1 as of 15:06:45 13-08-2012
Size: 2363
Comment: Local Merge - 'FslDev'
Revision 4 as of 16:12:22 06-09-2012
Size: 2165
Editor: FslAdmin
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 your terminals.
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. if you use Mathworks' MATLAB it will configure your `startup.m` file to allow you to use the FSL MATLAB functions and on OS X platforms it will also install FSLView into `/Applications`.
Line 6: Line 6:
[[attachment:fsl_installer.sh]] - Version 1.6 09/02/2012 = Running the installer (on Mac or Linux) =
{{{#!wiki warning
'''Administrative privileges may be required'''
Line 8: Line 10:
= Running the installer =
The installer runs from within a terminal session, so you need to open a terminal:
Installation into certain folders on your computer (eg 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 any rights to use `sudo` (an administration account on OS X) 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.
}}}

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:
Line 16: Line 20:
In the terminal change to the folder containing the downloaded file and run it (for example if you downloaded to your Downloads folder): In the terminal change to the folder containing the downloaded file and run it; 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 19: Line 23:
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.

{{{#!wiki warning
'''Administrative privileges may be required'''

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.
cd ~/Downloads
python fslinstaller.py
Line 30: Line 27:
== 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):
{{{#!highlight bash numbers=disable
cd ~/Desktop
su -c "sh fsl_installer.sh"
}}}
and entering the `root` account password.
You should now configure your user account to enable FSL using the instructions in the following section.

For more information on controlling the installer, run it with the `-h` option.
Once the install completes Linux users should log out (`System > 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 OS X users should open a new terminal window to begin using FSL.

FSL Install Script

The fslinstaller.py script carries out the installation of FSL, configuring your environment to enable you to run FSL from your terminals.

if you use Mathworks' MATLAB it will configure your startup.m file to allow you to use the FSL MATLAB functions and on OS X platforms it will also install FSLView into /Applications.

Running the installer (on Mac or Linux)

Administrative privileges may be required

Installation into certain folders on your computer (eg 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 any rights to use sudo (an administration account on OS X) then the installer will fail and will need to be run 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)
    • 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; 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

Once the install completes Linux users should log out (System > 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 OS X users should open a new terminal window to begin using FSL.

 

FslInstallation/FslInstaller (last edited 11:05:41 04-08-2023 by PaulMcCarthy)