Project:Infrastructure/Developer Machines/sparc

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.

Hostnames
These are the current systems we have available. See machine specific notes at bottom for more details.

Console Access
You connect to the console over ssh. Ask infra@ for the user/pass. ssh dev.gentoo.org; ssh root@10.0.0.176

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.


 * - switch to the active software connected to the console (OpenBoot, SILO, Linux terminal)
 * - when connected to the console, escape back to ALOM
 * - request the system shut down gracefully and stay turned off
 * - hard power off the system
 * - power on the system and let it start booting
 * - 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
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)  (may need -f if stuck, but shutdown Gentoo first via e.g. SSH or something if it's running, if at all possible)
 * 2)  (allow us to choose what to boot from on next start!)

Once the console starts up, you should see the machine booting. Then type within OpenBoot (simply  should boot from the harddrive).

You'll then end up at a SILO prompt (see below for details). TL;DR: run. 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.

Common OpenBoot Commands
If the main system is broken, try booting from a livecd.


 * - boot the default target (usually the disk)
 * - boot the main hard drive
 * - boot the livecd
 * - show some machine details
 * - resume execution of main OS

Common SILO Commands
Once you see the  prompt, hit  to list all the available kernel images. You can even append kernel command line options here like  to get a recovery shell.

So to boot an old kernel whose image name is  (as specified in ), you can type.

catbus

 * Contact: support@osuosl.org
 * IPv4: ; netmask  ; gateway
 * IPv6:  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: 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 | 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