Installing a new AFS server
installing a new AFS server is fairly straightforward and will hopefully become even more so when the new AFS component comes into service. For the moment the procedure is:
- Add the line
afs.server true
to the new server's profile
- Copy the contents of the
/usr/afs/etc
directory on an existing server to the new server in the most secure manner you can envisage.
- On the new server run the afs-server init script
/etc/init.d/afs-server start
- Run
bos status <newservername>
on any DICE machine. If it returns without any error messages, bosserver has successfully started on the new server
What happens next depends on whether you are installing a new file server or database server
File Server
- On any dice machine using your AFS admin credentials, run the following command to start up the file server:
bos create -server <newservername> -instance fs -type fs -cmd \
"/usr/afs/bin/fileserver -L -p 23 -rxpck 400 -busyat 600 -s 1200 -l 1200 -cb 65535 -b 240 -vc 1200 -allow-dotted-principals" \ "/usr/afs/bin/volserver -p 16 -allow-dotted-principals" \
"/usr/afs/bin/salvager -parallel all5"
- run
bos status <newservername>
once more. it should return:
Instance fs, currently running normally.
Auxiliary status is: file server running.
- Mount the storage to be used by the new file server as /vicepa, /vicepb etc. On any Dice machine, run the command
bos restart <
server name> -all
This will restart the file server and get it to recognise the new storage.
vos listpart <
server name>
to make sure the new storage has been recognised
Database Server
- On any dice machine using your AFS admin credentials, run the following command to start up the ptserver
bos create <
dbserver> ptserver simple '/usr/afs/bin/ptserver -allow-dotted-principals' -cell inf.ed.ac.uk
- Check the ptserver is running, and has cast its yes vote with the command
udebug <
server name> 7002
- Once it's voted, make sure that the database versions between the new server, and an existing one match
- Add the vlserver using
bos create <
server name> vlserver simple '/usr/afs/bin/vlserver -allow-dotted-principals' -cell inf.ed.ac.uk
- Check that the vlserver is running, and has correctly synced databases as before:
udebug <
server name> 7003
--
CraigStrachan - 07 Oct 2009