sparc Admin Notes
These are various notes mainly targeted at people administrating Gentoo dev machines, although most things are probably generally useful. These are not general "how do I administrate a Gentoo box" notes.
These are the current systems we have available. See machine specific notes at bottom for more details.
|Machine Name||IP||DNS Hostnames||Console Server||Console Account|
You connect to the console over ssh. Ask infra@ for the user/pass.
ssh dev.gentoo.org; ssh firstname.lastname@example.org
You can use this to:
- Interact with the Advanced Lights Out Management (ALOM) -- the software that can control the system
- Interact with OpenBoot -- the software that launches SILO (the bootloader)
- Interact with SILO -- the software that boots the kernel
- Log in directly to recover
- Boot alternative media
Common ALOM Commands
Once you're interacting with ALOM, here's some commands you'll use a lot. Note that ALOM stays running even if the main system is powered off/locked up/whatever. You can also talk to ALOM w/out interrupting the main system.
console- switch to the active software connected to the console (OpenBoot, SILO, Linux terminal)
#.- when connected to the console, escape back to ALOM
poweroff- request the system shut down gracefully and stay turned off
poweroff -f- hard power off the system
poweron- power on the system and let it start booting
break- suspend the current OS and break into OpenBoot; the system must be powered on
Note that the system is often slow during early boot up.
See the ALOM Manual for more details (publication code 819-7991-10).
When logging into the console, you'll first land at the ILO.
To escape the console: press the #. (Hash+Dot) keys.
Booting to cdrom
May need to run the setenv part inside the OpenBoot console instead ("ok ..." prompt)? See Oracle docs.
There should be an admincd already in the box. If there isn't, we'll need to ask someone nicely to put one in.
Adapted from the Oracle docs :
- stop /System (may need -f if stuck, but shutdown Gentoo first via e.g. SSH or something if it's running, if at all possible)
- set /HOST/bootmode script="setenv auto-boot? false" (allow us to choose what to boot from on next start!)
- start /System
- start /HOST/Console
Once the console starts up, you should see the machine booting. Then type boot cdrom within OpenBoot (simply boot should boot from the harddrive).
You'll then end up at a SILO prompt (see below for details). TL;DR: run boot gentoo. The admincd will then start and land you at a prompt.
Once you're all done, exit the console (get back to ILO), and run set /HOST/bootmode script="setenv auto-boot? true".
Common OpenBoot Commands
See the ILO commands section for how to get to this point.
If the main system is broken, try booting from a livecd.
boot- boot the default target (usually the disk)
boot disk- boot the main hard drive
boot cdrom- boot the livecd
banner- show some machine details
go- resume execution of main OS
Common SILO Commands
Once you see the
boot: prompt, hit Tab to list all the available kernel images. You can even append kernel command line options here like
init=/bin/bb to get a recovery shell.
So to boot an old kernel whose image name is
3.6.17 (as specified in /etc/silo.conf), you can type
sparc systems use the silo tool from the sys-boot/silo package to manage booting of kernels. Things to remember:
- Make updates to /etc/silo.conf.
- No need to run
siloafter making changes to kernels or silo.conf -- the boot loader will process on the fly.
- Make sure to run
siloafter upgrading sys-boot/silo.
- The bootable linux kernel is created at arch/sparc/boot/zImage (e.g. under /usr/src/linux/).
make installshortcut should work OK.
- Contact: email@example.com
2001:470:ea4a:1:214:4fff:fe2d:5584/64; gateway 2001:470:ea4a:1::1/64(check?)
- System: Oracle SPARC T5-2 server
- Memory: 506GB
- CPU: UltraSparc T5
- Disks: ~550GB (check?)
<@mattst88> | for my future self: this is how you restart catbus: https://docs.oracle.com/cd/E28853_01/html/E28855/z40010af1440299.html <@mattst88> | start /System <@mattst88> | start /HOST/console <@mattst88> | and if it gets stuck for some reason <@mattst88> | https://docs.oracle.com/cd/E35078_01/html/E29502/z40003881439665.html <@mattst88> | reset [-f] /System <iamben> | mattst88: i have wandered around those docs a while and this is the best one-page reference ive found-- this is for t4-1 but should be the same for catbus https://docs.oracle.com/cd/E22985_01/html/E22986/z40004eb1395746.html