Preparing Your Account

Overview

Important Presumptions

• bash - All configuration settings and examples in this page work with bash and likely work with other bourne-compatible shells. C-shell can be made to work, but you'll need to figure out equivalent settings yourself if you choose to use it or other c-shell derived shells.

Obtain an iVec Account with "wastac" Group Membership

If you do not already have an iVec account, request an account by emailing help@ivec.org. Ensure that you request membership to the "wastac" unix group. This will enable you to login to the portal and provide access to the database.

If you already have an iVec account, check that you are already a member of the "wastac" unix group. You can do this by logging in to any iVec unix server and running "id -a". Below is an example confirming membership to the wastac group. If you are not already a member of the "wastac" unix group then request that you are made a member by emailing help@ivec.org.

hlynch@wastac-4240% id -a
uid=1368(hlynch) gid=11415(iu05) groups=11415(iu05),1053(remote),1111(wastac)

Confirm That You Can Login to wastac-4240

Once you have been granted "wastac" membership you should be able to login to wastac-4240.ivec.org. Use ssh to test login using any internet connected computer.

If you are not able to login to wastac-4240.ivec.org, confirm that you do have wastac group membership (login to cognac and run "id -a"), then email help@ivec.org to resolve.

Configure Your Login Environment On wastac-4240

You will need to configure several paths into your login environment in work effectively on wastac-4240. We recommend the example below be used as your login profile as this takes care of all necessary environment variable adjustments. Copy the following text and paste it into your "~/.profile" file on wastac-4240, replacing any text that was already there. To ensure you have not made an error in the file, start a second session before logging out

# Recommended steps for updating your .profile file
% cat > ~/.profile
<paste recommended .profile text from below>
^D
% ssh wastac-4240.ivec.org
Password:
yourname@wastac-4240$ <-- this prompt indicates success

Below is the recommended .profile file for wastac users on wastac-4240.

# Recommended $HOME/.profile file for wastac users on wastac-4240.ivec.org

#stty istrip

env_add_dir()
{
  b64=0
  for arg in $*
  do
    if [ "$arg" = "-64" ]
    then
      b64=1
      continue
    fi

    for dir in $arg/ucb $arg/bin $arg/sbin
    do
      if [ $b64 -eq 1 ] && [ -d $dir/64 ]
      then
        PATH=$dir/64:$PATH
      elif [ -d $dir ]
      then
        PATH=$dir:$PATH
      fi
    done

    [ -d $1/man ] && MANPATH=$1/man:$MANPATH
    [ -d $1/lib ] && LD_LIBRARY_PATH=$1/lib:$LD_LIBRARY_PATH
    MANPATH=`echo $MANPATH | sed -e 's/\/\/*/\//g'`
    PATH=`echo $PATH | sed -e 's/\/\/*/\//g'`

#    if [ -d $1/lib/python2.5/site-packages ]
#    then
#      LD_LIBRARY_PATH=$1/lib/python2.5/site-packages:$LD_LIBRARY_PATH
#      PYTHONPATH=$1/lib/python2.5/site-packages:$PYTHONPATH
#    fi
  done
}

# normal solaris paths
env_add_dir /                           # base solaris
env_add_dir /usr                        # "
env_add_dir /usr/X11                    # "
env_add_dir /usr/ccs                    # "
env_add_dir /usr/openwin                # "
env_add_dir /opt/csw                    # blastwave
env_add_dir /usr/sfw                    # solaris freeware
env_add_dir /opt/sfw                    # solaris freeware (more)
env_add_dir /usr/local/ssl              # openssl
env_add_dir /opt/sunstudio12.1          # sun proprietary compilers

# local compiles
env_add_dir /usr/local/geos-3.0.0
env_add_dir /usr/local/postgis-1.3.4
env_add_dir /usr/local/gdal-1.6.2
env_add_dir /usr/local/hdf4.2r2
env_add_dir /usr/local/proj-4.6.1
env_add_dir /usr/local/apache2

# heritage local
env_add_dir /usr/local

# wastac
env_add_dir /opt/wastac
env_add_dir /opt/wastac/local

env_add_dir /usr/postgres/8.3           # suns postgres
env_add_dir /usr/local/vim-7.2          # allows wide windows

env_add_dir /usr/perl5                  # suns perl

env_add_dir /usr/local/Python-2.5.2     # local default python

alias vi=vim
EDITOR=vim

export PATH MANPATH LD_LIBRARY_PATH PYTHONPATH EDITOR

PS1=$USER@`hostname | cut -d. -f1`'% '

Initialise Your Postgres Account Password

To use the portal database directly (or indirectly as a consequence of using many of the provided tools), you'll need to initialise the password of your postgres account on wastac-4240. A script is provided to do this for you. It will set your password to a random long password, then write that password into "$HOME/.pgpass" files for you on wastac-4240, cognac and pbstore. Once this is done, you'll never need to know what your postgres password is as authentication will appear to be automatic.

Note: The $HOME/.pgpass file will contain your password in clear text. Don't let other users read this file, or they'll be able to use your postgres account. If you suspect that someone knows your password, run through the steps in this section again to set a new password.

• Login to wastac-4240
• Run /usr/local/bin/wastacpgpasswd
• Enter your iVec account password when prompted (this will be used to scp your .pgpass file to the other hosts)

An example transcript is below;

hlynch@wastac-4240% /usr/local/bin/wastacpgpasswd

This script will
1. set a password for your postgres account
2. write the password into your $HOME/.pgpass file
3. copy the .pgpass file to iVec hosts

UPDATE 1
Updating /home/hlynch/.pgpass...
Enter your system password as prompted...
Pushing /home/hlynch/.pgpass to cognac.ivec.org:.pgpass ...
hlynch@cognac.ivec.org's password:
.pgpass              100% |*****************************|    55       00:00
Pushing /home/hlynch/.pgpass to pbstore.ivec.org:.pgpass ...
hlynch@pbstore.ivec.org's password:
.pgpass              100% |*****************************|    55       00:00
Complete!

hlynch@wastac-4240% psql -d wastac
Welcome to psql 8.3.3, the PostgreSQL interactive terminal.

Type:  \copyright for distribution terms
       \h for help with SQL commands
       \? for help with psql commands
       \g or terminate with semicolon to execute query
       \q to quit

wastac=>

Configuring Your cognac Account

TBA - this is necessary only for people wanting to use the processing framework.