Sun Crypto Accelerator 4000 Board Version 1.1 Installation and User's Guide

This chapter describes how to install the Sun Crypto Accelerator 4000 hardware and also how to install and remove the software with automated scripts. This chapter includes the following sections:

• Handling the Board
• Installing the Board
• Installing the Sun Crypto Accelerator 4000 Software
• Directories and Files

Once you have installed the hardware and software of the board, you need to initialize the board with configuration and keystore information. See Initializing the Board With vcaadm for information on how to initialize the board.

---

Handling the Board

Each board is packed in a special antistatic bag to protect it during shipping and storage. To avoid damaging the static-sensitive components on the board, reduce any static electricity on your body before touching the board by using one of the following methods:

• Touch the metal frame of the computer.
• Attach an antistatic wrist strap to your wrist and to a grounded metal surface.

Caution - To avoid damaging the sensitive components on the board, wear an antistatic wrist strap when handling the board, hold the board by its edges only, and always place the board on an antistatic surface (such as the plastic bag it came in).

---

Installing the Board

Installing the Sun Crypto Accelerator 4000 board involves inserting the board into the system and loading the software tools. The hardware installation instructions include only general steps for installing the board. Refer to the documentation that came with your system for specific installation instructions.

1. As superuser, follow the instructions that came with your system to shut down and power off the computer, disconnect the power cord, and remove the computer cover.

2. Locate an unused PCI slot (preferably a 64-bit, 66 MHz slot).

3. Attach an antistatic wrist strap to your wrist, and attach the other end to a grounded metal surface.

4. Using a Phillips-head screwdriver, remove the screw from the PCI slot cover.

Save the screw to hold the bracket in Step 5.

5. Holding the Sun Crypto Accelerator 4000 board by its edges only, take it out of the plastic bag and insert it into the PCI slot, and then secure the screw on the rear bracket.

6. Replace the computer cover, reconnect the power cord, and power on the system.

7. Verify that the board is properly installed by issuing the show-devs command at the OpenBoot PROM ok prompt:

ok show-devs

.

/chosen

/packages

/upa@8,480000/SUNW,ffb@0,0

/pci@8,600000/network@1

/pci@8,600000/SUNW,qlc@4

/pci@8,600000/SUNW,qlc@4/fp@0,0

.

In the preceding example, the /pci@8,600000/network@1 identifies the device path to the Sun Crypto Accelerator 4000 board. There is one such line for each board in the system.

To determine whether the Sun Crypto Accelerator 4000 device properties are listed correctly: from the ok prompt, navigate to the device path and type .properties to display the list of properties.

ok cd /pci@8,600000/network@1

ok .properties

assigned-addresses       82000810 00000000 00102000 00000000 00002000

                          81000814 00000000 00000400 00000000 00000100

                          82000818 00000000 00200000 00000000 00200000

                          82000830 00000000 00400000 00000000 00100000

d-fru-len                00 00 00 00

d-fru-off                00 00 e8 00

d-fru-dev                eeprom

s-fru-len                00 00 08 00

s-fru-off                00 00 e0 00

s-fru-dev                eeprom

compatible               70 63 69 38 30 38 36 2c 62 35 35 35 2e 31 30 38

reg                      00000800 00000000 00000000 00000000 00000000

                          02000810 00000000 00000000 00000000 00002000

                          02000814 00000000 00000000 00000000 00000100

                          02000818 00000000 00000000 00000000 00200000

                          02000830 00000000 00000000 00000000 00100000

address-bits             00 00 00 30

max-frame-size           00 00 40 00

network-interface-type   ethernet

device-type              network

name                     network

local-mac-address        00 03 ba 0e 99 ca

version                  Sun PCI Crypto Accelerator 4000 1000Base-T FCode

FCode 2.11.13 03/03/04

phy-type                 mif

board-model              501-6039

model                    SUNW,pci-vca

fcode-rom-offset         00000000

66mhz-capable

fast-back-to-back

devsel-speed             00000001

class-code               00100000

interrupts               00000001

max-latency              00000040

cache-line-size          00000010

max-latency              00000040

min-grant                00000040

subsystem-vendor-id      0000108e

subsystem-id             00003de8

revision-id              00000002

device-id                0000b555

vendor-id                00008086

---

Installing the Sun Crypto Accelerator 4000 Software

The Sun Crypto Accelerator 4000 software is included on the Sun Crypto Accelerator 4000 CD. You may need to download patches from the SunSolve web site. See Required Patches for more information.

There are two methods to install the software: manually or with the install script. This section describes how to install the software with the install script. To install the software manually, refer to Appendix B.

1. Insert the Sun Crypto Accelerator 4000 CD into a CD-ROM drive that is connected to your system.

• If your system is running Sun Enterprise Volume Manager, it should automatically mount the CD-ROM to the /cdrom/cdrom0 directory.
• If your system is not running Sun Enterprise Volume Manager, mount the CD-ROM as follows:

# mount -F hsfs -o ro /dev/dsk/c0t6d0s2 /cdrom

You see the following files and directories in the /cdrom/cdrom0 directory.

This installation script installs the required packages in a specific order and these packages must be installed before installing any optional packages. Once the required packages are installed, you can install and remove the optional packages in any order.

Install the optional SUNWkcl2a package only if you plan to use Apache as your web server.

Install the optional SUNWkcl2o package only if you plan to relink to another version of Apache Web Server.

Install the optional SUNWvcav package only if you plan to perform the SunVTS tests. You must have SunVTS 4.4 or later up to 5.x installed to install the SUNWvcav package.

2. Install the required software by typing:

# cd /cdrom/cdrom0

# ./install

The install script analyzes the system to determine which required patches need to be installed, installs those patches, installs the main software, and optionally installs the optional software. For example:

# ./install

This program installs the software for the Sun Crypto Accelerator

4000, Version 1.1.

*** Checking if Sun Crypto Accelerator support is already installed...

*** Checking for required OS patch(es):

 113146-01 112838-07 113068-04 113449-02 113453-04 114758-01

*** Checking for incompatible OS patch(es) ...

*** Checking for optional package dependencies...

Do you wish to install the optional Crypto IPsec Acceleration software

(SUNWkcl2i.u)?  [y,n,?,q] 

Do you wish to install the optional Crypto Apache Support (SSL) (SUNWkcl2a

SUNWkcl2o)?  [y,n,?,q] y

Do you wish to install the optional Crypto QA Tools (SUNWkcl2q SUNWvcaq)?

[y,n,?,q] n

Do you wish to install the optional VCA Crypto Accelerator/Gigabit Ethernet

SunVTS Diagnostics (SUNWvcav)?  [y,n,?,q] n

This script is about to take the following actions:

- Install Sun Crypto Accelerator 4000 support for Solaris 9

- Install Optional Crypto IPsec Acceleration software

- Install Optional Crypto Apache Support (SSL) software

To cancel installation of this software, press 'q' followed by a Return.

 **OR**

Press Return key to begin installation: 

*** Installing Sun Crypto Accelerator 4000 software for Solaris 9...

Installing required packages:

 SUNWkcl2r SUNWkcl2u SUNWkcl2m SUNWvcar SUNWvcau SUNWvcaa SUNWvcamn SUNWvcafw

Installation of <SUNWkcl2u> was successful.

Installation of <SUNWkcl2m> was successful.

Installation of <SUNWvcar> was successful.

Installation of <SUNWvcau> was successful.

Installation of <SUNWvcaa> was successful.

Installation of <SUNWvcamn> was successful.

Installation of <SUNWvcafw> was successful.

*** Installing selected optional software for Solaris 9...

Installing optional package(s):

 SUNWkcl2i.u SUNWkcl2a SUNWkcl2o

Installation of <SUNWkcl2i> was successful.

Checking operating environment requirements...

Determining package requirements...

Verifying required packages are installed...

All required packages installed.

Determining patch requirements...

Verifying required patches are installed...

Requirement for 113146-01 met by 113146-01.

All required patches installed.

Installation of <SUNWkcl2a> was successful.

Installation of <SUNWkcl2o> was successful.

*** Installation complete.

Choosing the Optional Packages to Install

To install only the optional packages that provide the SSL support for the Apache Web Server and the Sun Crypto Accelerator 4000 online manual pages, select SUNWkcl2a and SUNWkcl2m.

To install all of the optional software packages, select the following: SUNWkcl2a, SUNWkcl2m, SUNWvcamn, SUNWvcav, SUNWkcl2o, and SUNWkcl2i.u.

See TABLE 2-1 for a description of the package contents of the optional packages in the previous examples.

---

Directories and Files

TABLE 2-2 shows the directories created by the default installation of the Sun Crypto Accelerator 4000 software.

FIGURE 2-1 shows the hierarchy of these directories and files.

 FIGURE 2-1 Sun Crypto Accelerator 4000 Directories and Files

---

Removing the Sun Crypto Accelerator 4000 Software

There are three methods to remove the software: the remove script on the CD-ROM, the /var/tmp/crypto_acc.remove script on the server, or the pkgrm command. This section describes how to remove the software with the two removal scripts. For instructions on removing the software with the pkgrm command refer to Appendix B.

Use the remove script for software removal if you used the install script to install the software. Use the /var/tmp/crypto_acc.remove script if you installed the software manually (Appendix B).

Type the following with the Sun Crypto Accelerator 4000 CD-ROM inserted:

# cd /cdrom/cdrom0

# ./remove

A log of this installation can be found at:

 /var/tmp/crypto_acc.install.2003.10.13

Type the following:

# /var/tmp/crypto_acc.remove

Sun Crypto Accelerator 4000 Board Version 1.1 Installation and User's Guide

817-3693-10

Copyright © 2004, Sun Microsystems, Inc. All rights reserved.