VOS_ONLINE(1)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💫 vos_online — bring that volume BACK online, bestie 💫

okay so this is vos_online(1), a page from the AFS Command Reference family. yes it's a whole reference, yes it's giving main character energy, and yes we're gonna read it together. 🫶

✨ NAME ✨

vos_online — Brings a volume online

like. that's it. that's the whole job. volume was offline, now it's not. iconic. 💅

🌸 SYNOPSIS 🌸

vos online -server <machine name>
    -partition <partition name>
    -id <volume name or ID>
    [-cell <cell name>]
    [-noauth] -localauth]
    [-verbose] [-encrypt] [-noresolve]
    [-config <config directory>]
    [-help]

vos on -s <machine name>
    -p <partition name>
    -i <volume name or ID>
    [-c <cell name>]
    [-noa] -l] [-v] [-e] [-nor]
    [-co <config directory>]
    [-h]

yes the second block is just the first block but ✨abbreviated✨ — vos on instead of vos online, and every long option gets its little shortie version. it's giving lazy-typing privilege and honestly? valid.

heads up, bestie: the brackets in that synopsis are printed exactly how they appear in the original page. no notes. don't touch them. 💖

🦋 DESCRIPTION 🦋

The vos online command brings an offline volume on line with the fileserver.

that's it. that's the plot. you had a volume sitting there all sad and offline, and now the fileserver ✨knows about it✨ again. slay.

💀 CAUTIONS 💀

None.

fr fr. zero warnings. no drama. a completely unproblematic command, which is RARE in this economy. 🌈

💅 OPTIONS 💅

okay bestie, here's the whole menu. every single one. nothing skipped. we do not gatekeep here. 🎀

  • -server <machine name> — tells it which file server machine the volume lives on. you can hand over the machine's IP address, or its host name — fully qualified OR an unambiguous abbreviation, your call. want the full tea? go read vos(1). ✨
  • -partition <partition name> — which partition on that machine (the one you named with -server) holds the volume. give the partition's complete name with the preceding slash, like "/vicepa", or use one of the three acceptable abbreviated forms. details live in vos(1). 💖
  • -id <volume name or ID> — the volume itself! either its complete name or its volume ID number. pick your fighter. 🌸
  • -cell <cell name> — names the cell to run the command in. ⚠️ do not combine this argument with the -localauth flag. more on that in vos(1). 🦋
  • -noauth — assigns the unprivileged identity "anonymous" to whoever's issuing the command. ⚠️ do not combine this flag with -localauth. again, vos(1) has the deets. 💜
  • -localauth — constructs a server ticket using a key from the local /etc/openafs/server/KeyFile file. the vos command interpreter then presents that ticket to the Volume Server and Volume Location Server during mutual authentication. ⚠️ do not combine this flag with the -cell argument or the -noauth flag. vos(1), as always. 🔥
  • -verbose — dumps a detailed trace of the command's execution onto the standard output stream. if you leave this out, only warnings and error messages show up. so if you're nosy (same), turn it on. 👑
  • -encrypt — encrypts the command so the operation's results don't go flying across the network in clear text. available in OpenAFS versions 1.4.11 or later and 1.5.60 or later. 🌟
  • -noresolve — shows all servers as IP addresses instead of the DNS name. very useful when the server address is registered as 127.0.0.1 or when you're dealing with multi-homed servers. available in OpenAFS versions 1.4.8 or later and 1.5.35 or later. 🧚
  • -config <configuration directory> — sets where the configuration directory lives. defaults to /etc/openafs — except if -localauth is specified, in which case the default is /etc/openafs/server. this option exists so you can point at alternative config locations for testing purposes. 🍓
  • -help — prints the online help for this command. and, crucially, all other valid options are ignored. so don't bother combining it with anything. 🙈

⭐ EXAMPLES ⭐

here's the moment you've been waiting for — bringing an offline volume back online:

% vos online -server sv7.example.org -partition /vicepb -id root.afs

ate. no crumbs. the volume is back, babe. 🔥

👑 PRIVILEGE REQUIRED 👑

The issuer must be listed in the /etc/openafs/server/UserList file on the machine specified with the -server argument and on each database server machine.

If the -localauth flag is included, the issuer must instead be logged on to a server machine as the local superuser "root".

so yeah — permissions check first, vibes second. 🌈

🦋 SEE ALSO 🦋

(the little posse. vos_offline does the opposite of this page, and bos_salvage is the one you call when things go sideways. iykyk. ✨)

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This man page was created by Steven Jenkins.

aaaand that's the whole page, bestie 💖 this was vos_online(1) from OpenAFS, dated 2026-07-27. go bring something back online. you got this. 🎀🫶✨

📦 where this page comes from