Usage

Globus Configuration options

f a firewall is used and globus is only allowed a particular port-range, setting ot the GLOBUS_TCP_PORT_RANGE variable is required. If the globus-software is installed in some non-common place, glogin will not start due to shared libraries not being found. Both problems can be solved by exporting the required environment varibles, but it is neccessary to tell the globus-gatekeeper to do so. The required configration directives have to be put into $GLOBUS_LOCATION/etc/globus-job-manager.conf, which look like this:

    -globus-tcp-port-range "40000 40500"

Put in the port range you are using instead of the 40000 40500. If you aren't using a port range, remove this line.

Another useful configuration option is:

    -extra-envvars LD_LIBRARY_PATH

You should add this option to to globus-job-manager.conf if your $GLOBUS_LOCATION

is *NOT* in your /etc/ld.so.conf. If you have neither configured the job-manager, nor the dynamic linker, binaries on the grid-node which are linked against globus cannot be executed (well, there's a way to get around this via RSL, but do your users a favour and save them from that extra work).

Environment variables

Currently, glogin sets two environment variables: GSH_CONNECTION and GSH_TTY. GSH_CONNECTION specifies the TCP 4-tuple in the form remote IP remote port local IP local port

GSH_TTY contains the name of the pseudo terminal (if there is any) related to the login shell.

For example, put this in your .bash_profile:

 set | grep ^GSH
 
 if [ "$GSH_TTY" != "" ]; then
   export PS1="gsh:$PS1"
 fi

Command line parameters

 Usage: glogin [options] [host]
   -l filename	glogin expect itself to be located at /opt/cg/bin/glogin
 			by default on the grid node. -l allows to specify an 
 			alternate location.
   -p port-number	by default, glogin uses dynamic port-binding. -p overrides 
 			this by specifying a fixed port.
   -r			remote-flag. tells glogin to act as if invoked by the 
 			globus-gatekeeper. usually, you need not specify this flag, 
			since it is set automatically.
 			manually setting -r is probably only useful when debugging 
 			glogin.
   -s rsl-string      allows passing an additional rsl-string to glogin. this is 
                      useful for e.g. setting the LD_LIBRARY_PATH: specify
                      -s '(libraryPath=$(HOME)/some/lib)' (or any other rsl, 
                      of course, too) 
   -x                 disables X11 forwarding
   -X                 enables X11 forwarding (default)
   -h			displays an (obsolete) usage-screen.
   (NOTE: the -H option is obsolete and has been removed)
   -H			turn off port-hijacking-detection. unfortunately, hijacking-
 			detection does not work with 'pooled accounts' now, so until 
 			it works, it's possible specify -H if otherwise glogin doesn't 
			allow you to log in.
   -c command		tells glogin to execute the specified command. if no command 
 			is specified, glogin will execute the user's shell by default. 
 			arguments to a command have to be enclosed in " ".
   -t			allocate a pty, even if a command is specified. 
                      useful for invocation of pppd.
   -L listen-port:host:port    Forward local port to host:port via remote node
   -R listen-port:host:port    Forward remote port to host:port via local node
                               multiple local and remote port fowarders may be used.

 Example:
   glogin -H -l/home/site/herp/glogin -t -c "top -d 5" ce100.fzk.de
   glogin -L 2023:zeus:23 -L 2025:zeus:25 -R 2022:pan:22 hydra