Project:Infrastructure/Developer Machines/sparc

From Gentoo Wiki
Jump to:navigation Jump to:search

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
catbus root (admin?)

Console Access

You connect to the console over ssh. Ask infra@ for the user/pass.

ssh; ssh root@

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).

ILO Commands

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 [1]:

  1. 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)
  2. set /HOST/bootmode script="setenv auto-boot? false" (allow us to choose what to boot from on next start!)
  3. start /System
  4. 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 3.6.17 init=/bin/bb.


Kernel Management

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 silo after making changes to kernels or silo.conf -- the boot loader will process on the fly.
  • Make sure to run silo after upgrading sys-boot/silo.
  • The bootable linux kernel is created at arch/sparc/boot/zImage (e.g. under /usr/src/linux/).
  • The make install shortcut should work OK.

Machine-specific Notes


  • Contact:
  • IPv4:; netmask; gateway
  • IPv6: 2001:470:ea4a:1:210:e0ff:fe3f:bed 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?)
Rough notes
<@mattst88> | for my future self: this is how you restart catbus:
<@mattst88> | start /System
<@mattst88> | start /HOST/console
<@mattst88> | and if it gets stuck for some reason
<@mattst88> |
<@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

See also