BOS_RESTART(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💅 BOS_RESTART 💅

okay bestie, this is the man page for bos restart — it lives in section 8 of the AFS Command Reference, and it's literally the "stop it and start it again" button for AFS server processes. no cap. 🦋

✨ NAME ✨

bos_restart — restarts a server process 🔄

🌸 SYNOPSIS 🌸

bos restart -server <machine name> [-instance <instances>+]
    [-bosserver] [-all] [-cell <cell name>] [-noauth]
    [-localauth] [-help]

bos res -s <machine name> [-i <instances>+] [-b]
    [-a] [-c <cell name>] [-n] [-l] [-h]

💖 DESCRIPTION 💖

so the way that bos restart works is: it stops server processes on the machine you named with the -server argument and then immediately restarts them. like no chill, no gap, straight back up. ✨

to tell it which process(es) to restart, you pick one of these three vibes:

  • the -instance argument names each AFS server process to stop and restart immediately, regardless of its status flag</> in the /etc/openafs/BosConfig file. 🚨 do not put bosserver in the list of processes — use the -bosserver flag for that instead, bestie, i'm begging you.
  • the -bosserver flag stops all AFS server processes running on the machine, including the BOS Server. a new BOS Server starts immediately, and it starts a new instance of each process that's marked with the "Run" status flag in the BosConfig file. 👑
  • the -all flag stops all AFS server processes running on the machine, except the BOS Server, and immediately restarts the processes marked with the "Run" status flag in the BosConfig file. 🌈
ngl important: this command does not change a process's status flag in the BosConfig file. it restarts, it does not rewrite. periodt. 💅

🎀 OPTIONS 🎀

  • -server <machine name> — tells you which server machine to restart each process on. you identify the machine by IP address or its host name (fully-qualified or abbreviated unambiguously, obviously). for the deets, see bos(8). 🖥️
  • -instance <instances>+ — names each process to stop and then restart immediately, regardless of its status flag setting. use the process name you assigned with the -instance argument to the bos create command. the output from the bos status command lists the names, iykyk. provide this flag or one of the -bosserver or -all options, but do not combine them. 🚫
  • -bosserver — stops all AFS server processes running on the machine, including the BOS Server. a new BOS Server instance immediately starts, and starts all processes marked with the "Run" status flag in the BosConfig file. provide this flag or one of the -instance or -all options, but do not combine them. 🔥
  • -all — stops all AFS server processes running on the machine other than the BOS Server, and immediately restarts the processes marked with the Run status flag in the BosConfig file. provide this flag or one of the -instance or -bosserver options, but do not combine them. ✨
  • -cell <cell name> — names the cell in which to run the command. do not combine this argument with the -localauth flag. for more details, see bos(8). 🌐
  • -noauth — assigns the unprivileged identity "anonymous" to the issuer. do not combine this flag with the -localauth flag. for more details, see bos(8). 🙈
  • -localauth — constructs a server ticket using a key from the local /etc/openafs/server/KeyFile or /etc/openafs/server/KeyFileExt file. the bos command interpreter presents the ticket to the BOS Server during mutual authentication. do not combine this flag with the -cell or -noauth options. for more details, see bos(8). 🔑
  • -help — prints the online help for this command. all other valid options are ignored. (it's giving "i only have eyes for help" 😌)

🦋 EXAMPLES 🦋

this one stops and restarts all processes running on the machine "fs3.example.com", including the BOS Server:

% bos restart -server fs3.example.com -bosserver

this one stops and restarts all processes running on the machine "fs5.example.com", excluding the BOS Server:

% bos restart -server fs5.example.com -all

and this one stops and restarts the Protection Server and Volume Location (VL) Server processes on the machine "db3.example.com":

% bos restart -server db3.example.com -instance ptserver vlserver

👑 PRIVILEGE REQUIRED 👑

the issuer must be listed in the /etc/openafs/server/UserList file on the machine named by the -server argument, or must be logged onto a server machine as the local superuser "root" if the -localauth flag is included. like, you gotta have the receipts. 🫶

🌈 SEE ALSO 🌈

BosConfig(5), KeyFile(5), KeyFileExt(5), UserList(5), bos(8), bos_create(8), bos_status(8)

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

This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.

okay that's the whole thing, bestie — this page is from OpenAFS, dated 2026-07-27, and it slayed. go restart something (responsibly). 💅✨🎀

📦 where this page comes from