vos_interactive - Enters interactive mode
vos interactive [-force] [-cell] <cell name> [-noauth] [-auth] [-localauth] [-encrypt [<yes|no>]] [-verbose] [-noresolve] [-srcport <set UDP port number>] [-config <configuration file>] [-help]
The vos interactive command allows the user to enter an interactive mode, useful for running bulk commands like creating new volumes.
vos interactive uses the authentication state supplied on its command line to run all bulk commands. However, if a bulk command is supplied with authentication options such as -cell, -localauth, -noauth, -auth or -encrypt then that command will be run with those options.
Enables the command to continue executing as far as possible when errors or other problems occur, rather than halting execution at the first error.
Names the cell in which to run the command. Do not combine this argument with the -localauth flag. For more details, see vos(1).
Assigns the unprivileged identity anonymous to the issuer.
Do not combine this flag with the -localauth flag.
For more details,
see vos(1).
Obtains an authentication token using the server encryption key with the highest key version number in the local /etc/yfs/server/KeyFileExt file. The resulting token never expires and has Super User privileges. Do not combine this flag with the -cell argument or -noauth flag. For more details, see vos(1).
Use the calling user's tokens from the kernel or as obtained using the active Kerberos ticket granting ticket to communicate with the Volume Server and Location Service. This is the default if neither -localauth nor -noauth is given.
Since this option is the default, it is usually not useful for running single command line operations. However, it can be useful when running commands via vos_interactive(1) or vos_source(1), since otherwise it would be impossible to switch from, for example, -localauth back to using regular tokens during a bulk operation.
Produces on the standard output stream a detailed trace of the command's execution. If this argument is omitted, only warnings and error messages appear.
Enables or disables encrytion for the command so that the operation's results are not transmitted across the network in clear text.
Shows all servers as IP addresses instead of the reverse DNS lookup hostname.
-noresolve useful when troubleshooting no such volume and volume moved errors.
Set the location of the configuration file to be used. The default file is /etc/yfs/yfs-client.conf.
Set the source Rx UDP port to the numeric value specified. If the designated port is in use then a random port number will be assigned by the operating system.
Prints the online help for this command. All other valid options are ignored.
The output is the same as if each individual command were run from the command line.
Here is an example of a vos interactive session:
% vos interactive
root.cell
RWrite: 536871004 ROnly: 536871005
[128.220.70.76]:7005 /vicepa 536871004 RW On-line
MaxQuota 5000 K
Used 13 K
FileCount 12
Creation Sat Nov 23 19:21:39 2013
Copy Thu Mar 5 21:45:51 2015
Backup Never
Last Access Mon Jan 25 17:35:08 2016
Last Update Fri Sep 26 15:46:13 2014
0 accesses in the past day (i.e., vnode references)
number of sites -> 3
server [1.2.7.6]:7005 partition /vicepa RW Site
server [1.2.7.6]:7005 partition /vicepa RO Site
server [1.2.3.1]:7005 partition /vicepa RO Site
vos> help
vos: Commands are:
addsite add a replication site
apropos search by help text
backup make backup of a volume
backupsys en masse backups
changeloc Change a RW volume's location and update the location service
convertROtoRW convert a RO volume into a RW volume (after loss of old RW volume)
copy copy a volume
create create a new volume
delentry delist the volume from the location service
dump dump a volume
each General VLDB query interface
endtrans end a volserver transaction
examine everything about the volume
help get help on commands
interactive enter interactive mode
listfs list all file servers registered with the location service
listloc list volumes known to the location service
listmaxacl list the volume maximum access list
listpart list partitions
listseclevels list the volume security classes and levels
listvol list volumes on server (bypass the location service)
lock lock a volume
move move a volume
offline force the volume status to offline
online force the volume status to online
partinfo list partition information
quit exit program
release release a volume
remove delete a volume
removefs deregister a file server from the location service
remsite remove a replication site
rename rename a volume
restore restore a volume
setfields change volume info fields
setmaxacl set the volume maximum access list
setquota set the volume maximum quota
setseclevels set the volume security classes and levels
size obtain various sizes of the volume.
sleep pause for a bit
source read commands from file
splitvolume split a volume at a certain directory
status report on volser status
syncfs synchronize a file server with the location service
syncloc synchronize the location service with a file server
unlock release volume lock
unlockall unlock all locked volumes
zap delete the volume, don't contact the location service
vos> quit
%
The same privilege is required to run the command in interactive mode as is required to run the command by itself on the command line.
vos(1), vos_quit(1), vos_sleep(1), vos_source(1), vlserver(8)
Copyright AuriStor, Inc. 2014-2024. https://www.auristor.com/ All Rights Reserved.
"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)
"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)
The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).
"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).
"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.