SCV25UK13713

Sierra Engineering, 4 April 2003.



This patch contains changes to scfsmgr and pfsmgr to provide troubleshooting

capabilities at the mount/unmount level.



PTR IPMT Abstract

================================================================

153-1-3713 LANL mount-unmount patch

================================================================



You should not need to reboot any nodes to install this patch nor do you need to

build and deploy new kernels.



Summary of Changes:



1. Modifications made to scfsmgr which provide two new subcommands: try_mount and try_unmount.



2. Modifications made to pfsmgr which provide two new subcommands: try_mount and try_unmount.



3. Creation of new files to handle new functionality.



Prerequisites:

==============



You must install the AlphaServer SC V2.5 Update Kit 1 patch. Please follow the

installation instructions for the UK1 patch carefully and complete all steps before

attempting to install this patch.



LANL only: for purposes of this patch, UK1 is same as CD









Kit checksum:

=============



# cksum SCV25UK13713.tar.gz

2092804683 22709 SCV25UK13713.tar.gz







Instructions:

=============



SCV25UK13713 is provided as a setld installable kit. Unpack it

into a directory that is NFS mounted on all domains e.g.

/usr/kits/SCV25UK13713 and install it as follows.



# cd /usr/kits/SCV25UK13713

# scrun -d all setld -l /usr/kits/ SCV25UK13713 SCV25UK13713



There is no need to build or deploy kernels or reboot any nodes.



Installation is complete at this point.



================================================================



To remove SCV25UK13713 use the following commands:



# scrun -d all setld -d SCV25UK13713





Notes:



When executing “pfsmgr try_mount or try_unmount options” on domains

with large number of nodes. The command might appear to hang, even

though it is executing normally. The output of the command is displayed

after all mounts/unmounts finish their execution. This is a side effect of

the commands being serialized throughout the domain.



Have in mind that this command is for troubleshooting purposes; and as

a way to preserve the original state of the mount points, the “online” and

“offline” states are not modified in the database. As a result certain

actionsor commands like “scfsmgr sync” might trigger a change on the

state of themounting points based on the information associated with

them in the database.



Commands Notation



Usage: try_mount <domain_name|node_name> <fs_name>

where:

<domain_name> specifies the domain where to perform the mount

<node_name> specifies the node where to perform the mount

<fs_name> specifies the SCFS mount point or the

filesystem name in <domain#filesystem> format



Usage: try_mount [-f] <domain_name|node_name> <fs_name>



where:

<-f> forces the unmount

<domain_name> specifies the domain where to perform the unmount

<node_name> specifies the node where to perform the unmount

<fs_name> specifies the SCFS mount point or the

filesystem name in <domain#filesystem> format



Usage: pfsmgr try_mount domain_name|node_name name|mountpoint

where:

domain_name indicates the domain where to do the unmount

node_name indicates the node where to do the unmount

name identifies the PFS to unmount by its pfs_set name

mountpoint identifies the PFS to unmount by its mountpoint





Usage: pfsmgr try_unmount [-f] domain_name|node_name name|mountpoint

where:

[-f] force the unmount action

domain_name indicates the domain where to do the unmount

node_name indicates the node where to do the unmount

name identifies the PFS to unmount by its pfs_set name

mountpoint identifies the PFS to unmount by its mountpoint

================================================================



SCV25UK13713

Sierra Engineering, 4 April 2003.