HSI users can customize their .hsirc files to configure various options for each HPSS system to which they have access. For example, users may wish to define multiple HPSS sites in their .hsirc file to easily issue inter-HPSS commands.
The possible .hsirc options are listed below:
# This file is composed of "sections" in the following manner: # # global: (reserved section name) # global option 1 # global option 2... # site1: (HPSS sitename section) # site1 option 1 # site1 option 2... # site2: (HPSS sitename section) # site2 option 1 # site2 option 2... # # Options for "global" section are: # # autobackup = [on|off turns on "automatic backup" mode] # authmethod = [kerberos|dce|keytab] # columns = [display columns] # copies = [copies - ???] # drive = [default "drive" letter if no site specified] # enable_ipi3 = [on|off] # enable_san3 = [on|off] # enable_sharedmem = [on|off] # helpfile = [path to local helpfile?] # keytab = [path to keytab file if "authmethod" = "keytab"] # lines = [display lines] # netopt_path = [path to hpss_netopt.conf] # nologin_path = [path to nologin file; doesn't seem to work] # nwif_path = [path of "network interfaces" file; e.g., pftp.config] # promptlen = [max length of entire prompt string] # promptdirlen = [max length of directory part of prompt string] # PS1 = [main prompt string] # PS2 = [continuation prompt string] # principal = [principal name[,authmethods]] # pwfile = [password file; not sure how used?] # site = [default sitename section to use] # # Options for each site section are: # # authmethod = [kerberos|dce|keytab, must precede "principal" option] # credfile = [path to creds cache for the site] # drive = ["drive" letter to use for the site] # host = [name of host running the NDAPI daemon] # keytab = [path to keytab file if "authmethod" = "keytab"] # netmask = [netmask for "host"; why?] # port = [NDAPI daemon port number] # principal = [principal name[,authmethods]] # pwfile = [password file; not sure how used?] # # Format specifiers for the prompt strings are: # # %C = DCE cellname (only works for DCE version?) # %c = current connection ID # %d = current "drive letter" # %D = current date # %h = NDAPI daemon full hostname # %H = NDAPI daemon short hostname # %I = NDAPI daemon IP address # %W = current HPSS directory # %w = current HPSS directory truncated to last dirname (doesn't work?) # %% = literal quote for "%" character # %N = current command number # %T = current time of day |
Here is an example of a custom .hsirc file for a user with HPSS accounts at ORNL and NERSC (ORNL is the default):
global:
copies = 2
PS1 = "%d[%s]%w2->"
promptlen = 50
promptdirlen = 30
PS2 = "[more] "
autobackup = off
site = ORNL
drive = O:
ORNL:
authmethod = keytab
keytab = %H/.private/.ktb_user
principal = user,keytab
host = arm16.ccs.ornl.gov
port = 1217
NERSC:
authmethod = dce
principal = gleicher@dce.nersc.gov,dce
|
Using the .hsirc file above, the user will log into ORNL with keytab authentication by typing "hsi" from a command prompt. This user can also type "hsi -s ORNL" to log into ORNL with keytab authentication, or "hsi -s NERSC" to log into NERSC with dce authentication.
The following is a multi-HPSS session for the user with the .hsirc above (commands issued by the user are in red). In this example, the user first connects to the ORNL HPSS system (the default), then connects to the NERSC system, lists all active connections and logs out:
% hsi
Username: user UID: #### CC: 300 Copies: 2 [hsi.2.8 Tue Jul 22 08:47:42 EDT 2003]
O:[ORNL]/home/user->open -s NERSC
N:[NERSC]/home/user->lscon
List of Currently Active Connections
Current default connection handle: 2
Han- Remote Remote HSM Fire- I/O Ctl Data Port Cmd
Drive dle IP Address Hostname Level wall Mode Port Min Max Count
-------------------------------------------------------------------------------------------------
O: 1 160.91.199.58 arm16.ccs.ornl.gov 4.1.4 off normal 1217 0 65535 1
HomeDir: /home/user
pwd0: /home/user
->N: 2 128.55.128.138 heart-g0.nersc.gov 4.3.0 off normal 7597 0 0 1
HomeDir: /nersc/ccc/user
pwd0: /nersc/ccc//user
N:[NERSC]/nersc/ccc//user->bye
|
Note that in the session above, the user's HPSS prompt appears at it was configured in the .hsirc file (to display the active HPSS system and its active directory).
More information about inter-HPSS commands is available in Chapter 7 of the HSI documentation.