4 Normal Operation





This chapter describes procedures that you can use to perform system administration. After installation, Sun Prestoserve requires attention only when you need to change the system configuration.

4.1 Using the presto Command

To run Sun Prestoserve, use the presto command. There are several options available with this command.

4.1.1 Command Options

presto

Invoked with no options, the state of the Sun Prestoserve device is printed out.

presto -h hostname

Many of the functions that presto supports can be executed remotely by specifying the name of the remote host using the -h option with the presto command.

presto -u

Solaris 1.x

Activates the Sun Prestoserve driver. When Prestoserve is installed, the shell script /etc/rc.local is modified to include a presto -u command. This causes the driver to be broughtr into the UP state. /etc/rc.local is executed automatically when the system is brought up in the multi-user mode. The presto -u command actually performs two functions. First, it performs an ioctl on the /dev/pr0 device to bring the driver to the UP state. Second, it scans the /etc/fstab and the /etc/mtab files and enables Sun Prestoserve caching on each local device which is writable (in "rw" mode) and not files of type "swap".

Solaris 2.x

Activates the Sun Prestoserve driver. When Sun Prestoserve is installed, an entry is added to /etc/inittab file to force loading of the Presto driver during system initialization. The prestoserve shell script is copied into the /etc/rc2.d and /etc/rc0.d directories. This shell script automatically brings the Prestoserve driver up when the system is booted and brings the Prestoserve driver down when the system is shutdown.

Caution -

When using Prestoserve on a system running Solaris 2.x, you cannot accelerate the root filesystem. This filesystem cannot be accelerated because, while the system is booting the driver cannot be loaded until after the root filesystem is mounted. If the NVRAM contains dirty data associated with the root filesystem, flushing the data after the root filesystem is mounted could corrupt the root filesystem.

presto -l

Prints a list (in a mount-like format) of all the filesystems which are being accelerated by Sun Prestoserve.

presto -d

Sets the state of the Sun Prestoserve device to DOWN after flushing any dirty buffers.

presto -R

Similar to presto -d, but in the event that dirty data could not be flushed due to an error condition, it is discarded. This command can cause data to be lost, so it should only be used in unusual error situations (see "Serious Disk Failures" on page 5-5).

presto -p

Prints information about the state of the Sun Prestoserve hardware and accumulated statistics on read and write operations passing through Sun Prestoserve.

Note - The hit rate for writes gives an indication of how effective the Sun Prestoserve cache is, since each dirty hit represents a physical disk write that was avoided entirely. If you discover that the number of read operations is very high in proportion to the total count of read and write operations (say, 75% or more), you may find that increasing the amount of main memory on the server will help system performance. If the write cache efficiency is low (less than 60%), you may find that increasing the amount of NVRAM will improve system performance by increasing the write cache efficiency

4.2 Handling the Prestoserve Card

Use the information provided in this section to remove, transfer to a new system, or store the Prestoserve SBus or NVSIMM card.

Caution -

You should never reconfigure a system when the system is down and has dirty buffers. Of course the exception is if one of the disk drives failed.

4.2.1 Removing Sun Prestoserve Hardware

The Sun Prestoserve card should be thought of as a piece of your disks. If you experience a power outage, a system panic, or abort the machine the Sun Prestoserve driver cannot flush cached data to the disk. In this state, removing the card is like removing a piece of the disk. Shutdowns that leave valid data on the Prestoserve card are termed unclean shutdowns.

Caution -

Avoid removing a Prestoserve card that contains valid data. If you must move a card containing valid data, consult Chapter 5, "Abnormal Operations."

Follow these steps to remove a Prestoserve card:

    1. Run presto -Rd.

    To ensure that no valid data is contained on the Prestoserve card, make sure that Prestoserve is in the PRDOWN state by using the presto -d command, or halt the operating system as usual. Halting the operating system works because the Prestoserve driver ensures that dirty data is flushed from the cache when the system is shut down.

    2. If any disk errors were noted, fix these prior to continuing, then repeat step 1.
    3. Shutdown the system according to the instructions that came with your operating system.
    4. Turn off the power to the machine.
    5. Unplug the SBus card according to the instructions that came with your system or unplug the NVSIMM according to the SPARCstation 10/SPARCserver 10 and SPARCstation 20/SPARCserver 20 NVSIMM installation documentation.
    6. Put the Prestoserve card in the antistatic bag.
    7. Reassemble the server.

Bring the system back up by turning on the power and rebooting.

4.2.2 Disabling the Batteries

The SBus Prestoserve card has two permanently-mounted lithium batteries that maintain the non-volatile memory cache in case of power loss. These batteries last at least eight years in a running system, or in storage with the batteries disabled. The batteries last approximately two years in a powered down system or in storage with the batteries enabled.

The NVSIMM has one permanently-mounted lithium battery that maintains the non-volatile memory cache in case of power loss. This battery lasts at least four years ina running system, or in storage with the battery disabled. The battery lasts approximately one year in a powered down system or in storage with the batteries enabled.

Note - Lighting the LED on the SBus card when running strictly on battery power can significantly reduce battery lifetime.

The Prestoserve driver monitors the state of the batteries, and a console message is displayed when the battery state changes. When the battery falls below nominal voltage levels, the Prestoserve driver disables its functions, and all subsequent disk requests are passed directly to the drivers.

If a battery fails, call your authorized Sun service provider.

Caution -

Do not attempt to replace the batteries yourself. The batteries are soldered to the card and are very sensitive to heat. There is a danger of explosion if the batteries are incorrectly replaced.

In some situations you may want to disable the batteries on the Prestoserve card. If you disable the batteries, the memory is lost and its contents are cleared.

To disable the batteries on the SBus card:

    1. Remove the Prestoserve card according to the instructions provided in this section.
    2. Move the SW1 slider in the direction of the faceplate of the Prestoserve card.
    3. If you need to clear the card state, make sure that the batteries are disabled for at least 5 minutes.

To disable the battery on the NVSIMM:

    1. Remove the NVSIMM according to the instructions that came with your hardware.
    2. Move the battery jumper to the OFF position.
    3. If you need to clear the card state, make sure that the batteries are disabled for at least 5 minutes.

4.2.3 Transferring Sun Prestoserve to a Different System

After you have removed the Prestoserve card, you can safely move the card to a different system. If you must move a card containing valid data, consult Chapter 5, "Abnormal Operations."

4.2.4 Data Security

If you need to remove a Prestoserve card containing live data and it is essential that no one have access to this data, the memory on the card can be cleared by disabling the batteries as described above.

4.3 Changing Server Configuration

This section identifies what actions need to be taken when the configuration of the server changes. These changes include adding or deleting accelerated filesystems, changing the hardware configuration (new disk, new CPU, removable disk packs), and new releases of operating system software.

4.3.1 Selecting Filesystems to Accelerate

When you are selecting filesystems to be accelerated with Sun Prestoserve, choose filesystems that receive synchronous write requests.

Note - Accelerating other file systems provides no significant benefit and may result in a minor overall performance degradation by burdening the Sun Prestoserve driver with additional data structures to maintain.

Local swap partitions and read-only filesystems do not generate synchronous writes and are not normally Presto-ized. Filesystems accessed via NFS receive the most significant benefit from Sun Prestoserve, since many requests for such files are synchronous. Similar performance gains can be realized on filesystems that are used heavily by applications that do synchronous I/O. Local filesystems can also benefit from Sun Prestoserve because operations such as creating or removing a file generate synchronous writes. Remote swapping done to NFS files benefits from Sun Prestoserve. In most cases, it should not be necessary to alter the default selection of accelerated filesystems.

To unaccelerate or reaccelerate a specific filesystem, the presto -d and presto -u commands may be issued with an argument that identifies the filesystem by naming its mount point or the block-special-file to be affected:

# presto -u filesystem

Caution -

When using Prestoserve on a system running Solaris 2.x, you cannot accelerate the root filesystem. This filesystem cannot be accelerated because, while the system is booting the driver cannot be loaded until after the root filesystem is mounted. If the NVRAM contains dirty data associated with the root filesystem, flushing the data after the root filesystem is mounted could corrupt the root filesystem.

4.3.2 Mounting New Filesystems

If you mount a local filesystem using the mount command after the system is running multi-user, it is necessary to run the presto -u command again to cause that filesystem to be accelerated by Prestoserve.

4.3.3 Changing Hardware Configuration

If you add or remove disks and controllers, or change CPU boards or ID PROMS, no special administration is needed as long as you ensure that the Prestoserve driver is in the DOWN state prior to reconfiguring your machine. This can be achieved by using the presto -d command, or by cleanly shutting down the operating system according the instructions provided with the software.

4.3.4 Removable Disk Pack

If you have removable disk packs, you must invoke the presto -d filesystem command before you run umount. Once this is complete, you can physically remove the disk pack. (Prestoserve does not need to be in the DOWN state).

4.3.5 Upgrading SunOS

If you upgrade from one version of SunOS 4.x to another version of SunOS 4.x, Sun Prestoserve should continue to work. However, if you upgrade from SunOS 4.x to Solaris 2.x a Prestoserve upgrade is required. Check with your Sun sales representative to confirm that a Prestoserve upgrade is required.

Before installing the new release, remove the current Prestoserve driver using the instructions in chapters 2 and 3. After installing the new operating system software follow the installation instructions that come with your Prestoserve kit. The Prestoserve card can be left in place.

Caution -

It is very important to flush dirty data from the NVRAM device before upgrading your Prestoserve or operating system software. Failure to do so could result in the loss of your data.