The Linux Login Environment (LLE) for Astron, Wsrt and Lofar

This page describes the standard login environment for new linux-based accounts at ASTRON. Existing accounts can be easily modified; see below for a manual to do this.

The Linux Login Environment sets a few things for your account, and allows you to easily initialise often used packages and tools at login time. To this purpose we provide a few simple standardized login-scripts that we have tested on various Linux-based hosts at ASTRON, WSRT and LOFAR (RCG).

To be able to use the LLE environment you must use a (t)csh login shell (tcsh is the default shell for new accounts). We do not support scripts for bash or any other shells.

In all environments where we use the LLE, we use the same scripts and directory structure. The root directory for the scripts is provided in environment variable $APS_LOCAL, whose value is set in one of the scripts.

In directory $APS_LOCAL/login are a number of default login scripts:

• cshrc → sets APS_LOCAL and calls the other scripts
• login → Displays welcome message; no settings
• setenv → adds some items to $PATH, sets your prompt, etc.
• alias → some default aliases to make life easy
• setpackages → script to define packages to initialize at login-time

The $APS_LOCAL/cshrc-file must be copied to $HOME/.cshrc (mind the leading 'dot'!). When getting a new account, this must be done already, so don't worry. Do not modify this file.

The other files should not be copied into your $HOME as the cshrc-script (also) looks for them in directory $APS_LOCAL/login, unless you have a very good reason to have these in your $HOME.

Using the files from $APS_LOCAL/login makes it easier for us and you to stay updated whenever we change these files.

Personal command aliases can be added to a file $HOME/.myalias; The cshrc-script will source this file after the default $APS_LOCAL/login/alias, when it is found.

Personal extensions to $PATH, personal environment variables, or overloaded existing environment variables can be added to a file $HOME/.mysetenv. The cshrc-script will source this file after all other files if it is found.

There is one other important file in $APS_LOCAL/login, and it is called setpackages.

This file takes care of user definable default package activation at login time (e.g, AIPS++, LOFAR, Python, etc.). It modifies/sets environment variables like $PATH and, if applicable, it adds environment variables that are necessary for the chosen package.

To make this work, users must:

• Copy $APS_LOCAL/login/setpackages to $HOME/.setpackages
• Edit the file and add packages for default package activation.
• Logout and login again

To find out which packages can be added, make a list of directory $APS_LOCAL/scripts. This contains a list of files like doAIPS, doPython, etc. that contain code to initialize these packages. To activate, for instance, classic AIPS and AIPS++, change the $HOME/.setpackages file to contain the line:

setenv packages "AIPS AIPS++"

To find out which packages should have been initialized, type

echo $packages

This should give the list of packages as you defined in $HOME/.setpackages, and from packages added manually later on.

These are the files that you can find in $APS_LOCAL/scripts and their useage. Not all files may be present at all locations, as some only have use at a specific site (e.g., do TMS). The 'word' to add to the setenv packages in the $HOME/.setpackages file is given between brackets.

Sources the classic AIPS initialization file (/aips/LOGIN.CSH) so AIPS can be run. This also requires that are member of the group aipsgrp, otherwise you will not have access to AIPS-defined DATA disks. Contact Stefanie Muhle at JIVE for details about how to set up an AIPS session for the first time.

Version ATNF maintained by Tom Oosterloo. Calls doOosterloo and a scripts in Oosterloo's environment to initialize the wsrtMiriad version. Contact Tom Oosterloo or Rafaella Morganti if you plan to use Miriad.

Script to create an environment that can execute most of Tom Oosterloo's personal doXXXX scripts most notably the doWsrtMiriad and related scripts.

Initialization script of Karma Miriad visualization tools.

Version 4 of the BIMA/CARMA Miriad version.

Optimized version 4 provided by John Romein. Works only on the Adam cluster. Contact Adriaan Renting if you are interested in using this.

Calls doStableAIPS++ (see below) for the moment. Can be used (but only effective at WSRT, currently) to initialize a host-dependent version of AIPS++. Contact Arno Schoenmakers if you want to use AIPS++.

Initialization script for use of an old WSRT AIPS++ build (V19.1488). Works for Suse 8 and 9 32-bit systems, only.

Initialization script to use the ROOT package.

Initialization script to use the Python Pipeline environment with iPython and PyLab. Maintained by Adriaan Renting. Contact him if you plan on using this.

Initialization script to use the Cuisine pipeline scripts. Maintained by Adriaan Renting. Contact him if you plan on using this.

Initialization script to use the First-look WSRT data reduction pipeline. Uses WsrtMiriad, among others. Maintained by Adriaan Renting. Contact him if you plan on using this.

Sets the environment for TMS developers/users (only effective at the WSRT site). Contact Arno Schoenmakers for more information.

There are a few basic steps to perform to use the LLE in existing accounts:

• Make tcsh your default login shell; your system manager should be able to set this for you. Ask him to replace an existing $HOME/.cshrc with the default cshrc file.
• Copy $APS_LOCAL/login/setpackages to $HOME/.setpackages, and then edit this file to setup package activation.
• Try to login and see if the login went well.

If you need help, or have questions, or want to give any other comments, contact Arno Schoenmakers, Adriaan Renting or Henk Vosmeijer.