Differences

This shows you the differences between two versions of the page.

--- public:lle [2017-05-03 06:36] – [Login scripts] Arno Schoenmakers
+++ public:lle [2017-05-30 10:47] – [Login scripts] Arno Schoenmakers
@@ Line 1: / Line 1: @@
 ====== The Lofar Login Environment (LLE) ======
-This page describes the standard login environment for new users on the LOFAR cluster nodes.
+This page describes the standard login environment for new users on the LOFAR cluster nodes like [[cep3:start|CEP3]].
 Existing accounts can be easily modified; see below for a manual to do this.
@@ Line 15: / Line 15: @@
 ===== What to do when you get an account =====
-==== (t)csh ====
+The CEP3 user creation system has been setup such that new accounts will have all needed files and links in ''$HOME'' in place already. So you do not have to chnage anything to work with the LLE.
-If you have chosen for the ''(t)csh'' shell, you do as follows:
-  * Log in to the frontend node ''lhn001'' or ''lfe001'' and go to your (empty) ''$HOME'' directory
-  * ''> ln -s /opt/cep/login/cshrc .cshrc''.
-  * Log out and login again; you should see a welcome message (and no errors...).
-==== bash ====
-If you have chosen for the ''bash'' shell, you do as follows:
-  * Log in to ''lhd002'' and go to your (empty) ''$HOME'' directory
-  * ''> ln -s /opt/cep/login/bashrc .bashrc''
-  * ''> ln -s /opt/cep/login/profile .profile''
-  * Log out and login again; you should see a welcome message (and no errors...).
 ===== How to transform existing accounts? =====
-To use the LLE in an existing account, rename your existing ''.cshrc'' or ''.bashrc'' in your ''$HOME'' and follow the instructions given above.
+To use the LLE in an existing account and ''$HOME'' dir, rename your existing ''.cshrc'', or ''.profile'' and ''.bashrc'', in your ''$HOME'' and follow the instructions given above.
-Make sure that possibly existing files ''$HOME/.login'', ''$HOME/.setenv'' and ''$HOME/.alias'' that you still want to use at login time are renamed to ''$HOME/.mylogin'', ''$HOME/.mysetenv'', ''$HOME/.myalias''.
 ===== The LLE scripts =====
 Some of the details are presented here.
-==== What is $APS_LOCAL ? ====
-The root directory for the scripts is provided in environment variable ''$APS_LOCAL'', whose value is set in the ''.cshrc'' and ''.bashrc'' scripts. The actual value is:
-  * CEP processing clusters (CEP1, CEP2, CEP3): ''/opt/cep''
 ==== Login scripts ====
-In directory ''${APS_LOCAL}/login'' are a number of default login scripts. The scripts ending with ''.bash'' are for the ''bash'' shell, the others for the ''(t)csh'' shell: \\
+In directory ''/opt/cep/login'' are a number of default login scripts. The scripts ending with ''.bash'' are for the ''bash'' shell, the others for the ''(t)csh'' shell: \\
-  * ''cshrc'' -> Sets APS_LOCAL and calls the other scripts for (t)csh environments
+  * ''cshrc'' -> login settings for (t)csh environments.
-  * ''bashrc'' -> Sets APS_LOCAL and calls the other scripts for bash environments
+  * ''bashrc'' -> login settings for non-interactive logins.
-  * ''profile'' -> Needed for bash users on Ubuntu systems; calls ''bashrc''.
+  * ''profile'' -> login settings for interactive logins.
-  * ''login'' -> Displays welcome message; no settings
+  * ''login'' -> Displays welcome message; no settings.
-  * ''setenv'' -> adds some items to $PATH, sets your prompt, etc.
+  * ''setpackages'' -> script to define packages to initialize at login-time.
-  * ''alias'' -> some default aliases to make life easy
-  * ''setpackages'' -> script to define packages to initialize at login-time
 \\
-Users should **NEVER** modify these default scripts. In their $HOME sthey should be symlinks to the versions in ''/opt/cep/login''. Personalization of your login is possible through other scripts like ''.myalias'' and ''.mysetenv''.
+Users should **NEVER** modify these default scripts. In their ''$HOME'' these should be symlinks to the versions in ''/opt/cep/login''. Personalization of your login is possible through other scripts like ''.myalias'' and ''.mysetenv'' (see below).
+If you like to read more on the files that play a role in the bash login, [[https://stackoverflow.com/questions/415403/whats-the-difference-between-bashrc-bash-profile-and-environment|here is a nice link]].
 ==== Personal command aliasses: .myalias ====
-Personal command aliases can be added to a file ''$HOME/.myalias''. When this file exists, the ''.cshrc'' or ''.bashrc'' script will read this file after reading the default ''${APS_LOCAL}/login/alias(.bash)''.
+Personal command aliases can be added to a file ''$HOME/.myalias''. When this file exists, the ''.cshrc'' or ''.bashrc'' script will read this file.
 ==== Personal environment settings: .mysetenv ====
@@ Line 78: / Line 51: @@
 ===== Package initialisation =====
-Many packages are available from the distribution of the Operating System. Several packages are added lateron. To activate these, environment variables like ''PATH'', ''LD_LIBRARY_PATH'', ''PYTHONPATH'' must be set correctly. To help you, we have created package initialization scripts that you can call to set these parameters correctly.
+Many packages are available from the distribution of the Operating System. Several packages are added lateron, see [[cep3:usersoftware|this page for CEP3 packages]]. To activate these, environment variables like ''PATH'', ''LD_LIBRARY_PATH'', ''PYTHONPATH'' must be set correctly. To help you, we have installed the environment module software (see [[cep3:usersoftware#using_packages_with_environment_modules|this section in the CEP3 user documentation]]).
-A list of packages available on the offline processing cluster can be found [[public:lofar_packages|on this page]].
-==== On the commandline ====
-To initialize a package, you must know the name of the initialization file. These can be found in directory ''${APS_LOCAL}/scripts''. An example of such a filename is ''doLofIm''. This file initializes the ''LofIm'' package. You can execute it by typing:<code>
-> use LofIm
-</code>
-It can be quite cumbersome to have to initialize all your required packages each time in each shell window you open. Therefore we have made available an option to initialize a list of packages at login time.
-For packages that are build daily and that have a version available for all days of the week (LUS, LofIm), you can also specify a day of week  on the commandline:
-<code>
-> use LofIm Tue
-</code>
 ==== .mypackages =====
-To initialize the use of installed packages at login time  you must create a file ''$HOME/.mypackages''. If this file exists, it is used by the LLE script ''setpackages''.
+To initialize the use of installed packages at login time you must create a file ''$HOME/.mypackages''. If this file exists, it is used by the LLE script ''setpackages''.
-In the directory ''${APS_LOCAL}/scripts'' you will find available package initialization scripts, named like ''do<package>'' (e.g., ''doCasa'', ''doLofIm''). Whenever you add a package to the file ''$HOME/.mypackages'', the associated script in ''$APS_LOCAL/scripts'' will be ''source'''d.
 The file ''$HOME/.mypackages'' can look like this example:
 <code>
-Casa
+casa
-LofIm
+lofim
 </code>
-Provide only one package per line. Also note the use of ''<package>'' and ''do<package>''; both are accepted. If an initialization script for a package cannot be found, it will be reported to the user.
+Provide only one package name per line.
 For packages that are build daily and that have a version available for all days of the week (LUS, LofIm), you can also specify a day of week in the ''.mypackages'' file:
 <code>
-LofIm Tue
+lofim Tue
 </code>
 ==== How to add a personal package ====
-Apart from the systemwide ''do<package>'' files provided in directory ''$APS_LOCAL/scripts'', users can add their personal ''do<package>'' files in their ''$HOME'' and have these run at login time. If there is a ''do<package>'' file both in ''$HOME'' and in ''$APS_LOCAL/scripts'', the version in ''$HOME'' has preference and will be executed. This can be used to test a different version of a package, etc... To add a new, personal, package, act as follows:
+Apart from the systemwide module initialization files provided in directory ''$APS_LOCAL/modulefiles'', users can add their personal modulefiles in their ''$HOME/modulefiles'' and have these run at login time. To add a new, personal, modulefile, act as follows:
   * Install the package
-  * Create a ''$HOME/do<package>'' initialization script (e.g., adding the installation directory to your ''$PATH'')
+  * Create a ''$HOME/modulefiles/<package>/<modulefile>'' environment module script (e.g., adding the installation directory to your ''$PATH''). See [[http://modules.sourceforge.net/man/modulefile.html|this manual for writing modulefiles yourself]].
   * Add <package> to the list of packages in file ''$HOME/.mypackages''
 ===== Starting X environment =====
@@ Line 142: / Line 91: @@
 ===== Help! =====
-If you need help, or have questions, or want to give any other comments, contact Arno Schoenmakers or Adriaan Renting.
+If you need help, or have questions, or want to give any other comments, contact Arno Schoenmakers or Reinoud Bokhorst.
-New ''do<xxxx>''-files can be added at any time if you have a new package that should be available systemwide. Contact Arno Schoenmakers or Adriaan Renting in this case.
+New module-files can be added at any time if you have a new package that should be available systemwide. Contact Arno Schoenmakers or Reinoud Bokhorst in this case.