Sun Logo


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

817-3693-10



Contents

Tables

1. Product Overview

Product Features

Key Protocols and Interfaces

Key Features

Supported Applications

Supported Cryptographic Protocols

Diagnostic Support

Cryptographic Algorithm Acceleration

Supported Cryptographic Algorithms

IPsec Acceleration

SSL Acceleration

Bulk Encryption

Hardware Overview

Sun Crypto Accelerator 4000 MMF Adapter

LED Displays

Sun Crypto Accelerator 4000 UTP Adapter

LED Displays

Dynamic Reconfiguration and High Availability

Load Sharing

Hardware and Software Requirements

Required Patches

Apache Web Server Patch

Solaris 8 Patches

Solaris 9 Patches

2. Installing the Sun Crypto Accelerator 4000 Board

Handling the Board

Installing the Board

procedure iconsmall spaceTo Install the Hardware

Installing the Sun Crypto Accelerator 4000 Software

procedure iconsmall spaceTo Install the Software

Choosing the Optional Packages to Install

Directories and Files

Removing the Sun Crypto Accelerator 4000 Software

procedure iconsmall spaceTo Remove the Software With the remove Script

procedure iconsmall spaceTo Remove the Software With the /var/tmp/crypto_acc.remove Script

3. Configuring Driver Parameters

Ethernet Device Driver (vca) Parameters

Driver Parameter Values and Definitions

Advertised Link Parameters

Flow Control Parameters

Gigabit Forced Mode Parameter

Interpacket Gap Parameters

Interrupt Parameters

Random Early Drop Parameters

PCI Bus Interface Parameters

Setting vca Driver Parameters

Setting Parameters Using the ndd Utility

procedure iconsmall spaceTo Specify Device Instances for the ndd Utility

Noninteractive and Interactive Modes

Setting Autonegotiation or Forced Mode

procedure iconsmall spaceTo Disable Autonegotiation Mode

Setting Parameters Using the vca.conf File

procedure iconsmall spaceTo Set Driver Parameters Using a vca.conf File

Setting Parameters for All Sun Crypto Accelerator 4000 vca Devices With the vca.conf File

procedure iconsmall spaceTo Set Parameters for All Sun Crypto Accelerator 4000 vca Devices With the vca.conf File

Example vca.conf File

Enabling Autonegotiation or Forced Mode for Link Parameters With the OpenBoot PROM

Cryptographic and Ethernet Driver Operating Statistics

Cryptographic Driver Statistics

Ethernet Driver Statistics

Reporting the Link Partner Capabilities

procedure iconsmall spaceTo Check Link Partner Settings

IPsec In-Line Acceleration Statistics

Network Configuration

Configuring the Network Host Files

Configuring IPsec Hardware Acceleration

Enabling Out-of-Band IPsec Acceleration

Enabling In-Line IPsec Acceleration

procedure iconsmall spaceTo Enable In-Line IPsec Hardware Acceleration

4. Administering the Sun Crypto Accelerator 4000 Board

Using the vcaadm Utility

Modes of Operation

Single-Command Mode

File Mode

Interactive Mode

Logging In and Out With vcaadm

Logging In to a Board With vcaadm

Logging Out of a Board With vcaadm

Entering Commands With vcaadm

Getting Help for Commands

Quitting the vcaadm Utility in Interactive Mode

Initializing the Board With vcaadm

procedure iconsmall spaceTo Initialize the Board With a New Keystore

Initializing the Board to Use an Existing Keystore

procedure iconsmall spaceTo Initialize the Board to Use an Existing Keystore

Managing Keystores With vcaadm

Naming Requirements

Password Requirements

Populating a Keystore With Security Officers

Populating a Keystore With Users

Listing Users and Security Officers

Changing Passwords

Enabling or Disabling Users

Deleting Users

Deleting Security Officers

Backing Up the Master Key

Locking the Keystore to Prevent Backups

Managing Boards With vcaadm

Setting the Auto-Logout Time

Displaying Board Status

Loading New Firmware

Resetting the Board

Rekeying the Board

Performing a Software Zeroize on the Board

Using the vcaadm diagnostics Command

Using the vcad Command

vcad Configuration File

vcad Daemon Security

procedure iconsmall spaceTo Configure the vcad Daemon to Run as a Different Username

Using the vcadiag Utility

Using the pk11export Utility

Using the iplsslcfg Script

procedure iconsmall spaceTo Use Option 1 of the iplsslcfg Script for Sun ONE Web Server 4.1

procedure iconsmall spaceTo Use Option 1 of the iplsslcfg Script for Sun ONE Web Server 6.0

procedure iconsmall spaceTo Use Option 2 of the iplsslcfg Script

procedure iconsmall spaceTo Use Option 3 of the iplsslcfg Script

procedure iconsmall spaceTo Use Option 4 of the iplsslcfg Script

Using the apsslcfg Script

procedure iconsmall spaceTo Use Option 1 of the apsslcfg Script

Using Option 2 of the apsslcfg Script

procedure iconsmall spaceTo Generate a Keypair and Request a Certificate for Apache

procedure iconsmall spaceTo Export Apache (PEM Encoded X.509) Keys to PKCS#12 Format

procedure iconsmall spaceTo Import Keys From PKCS#12 Format to Apache (PEM encoded X.509)

Assigning Different MAC Addresses to Multiple Boards Installed in the Same Server

procedure iconsmall spaceTo Assign Different MAC Addresses From a Terminal Window

procedure iconsmall spaceTo Assign Different MAC Addresses From the OpenBoot PROM Level

5. Installing and Configuring Sun ONE Server Software

Administering Security for Sun ONE Web Servers

Concepts and Terminology

Tokens and Token Files

Token Files

Enabling and Disabling Bulk Encryption

Configuring Sun ONE Web Servers

Passwords

Populating a Keystore

procedure iconsmall spaceTo Populate a Keystore

Overview of Enabling Sun ONE Web Servers

Configuring Sun ONE Web Servers to Start Up Without User Interaction on Reboot

procedure iconsmall spaceTo Create an Encrypted Key for Automatic Startup of Sun ONE Web Servers on Reboot

Installing and Configuring Sun ONE Web Server 4.1

procedure iconsmall spaceTo Install Sun ONE Web Server 4.1

Configuring Sun ONE Web Server 4.1

procedure iconsmall spaceTo Create a Trust Database

procedure iconsmall spaceTo Register the Board With the Web Server

procedure iconsmall spaceTo Generate a Server Certificate

procedure iconsmall spaceTo Install the Server Certificate

procedure iconsmall spaceTo Enable the Web Server for SSL

Installing and Configuring Sun ONE Web Server 6.0

procedure iconsmall spaceTo Install Sun ONE Web Server 6.0

Configuring Sun ONE Web Server 6.0

procedure iconsmall spaceTo Create a Trust Database

procedure iconsmall spaceTo Register the Board With the Web Server

procedure iconsmall spaceTo Generate a Server Certificate

procedure iconsmall spaceTo Install the Server Certificate

procedure iconsmall spaceTo Enable the Web Server for SSL

Installing and Configuring Sun ONE Application Server 7

procedure iconsmall spaceTo Install Sun ONE Application Server 7

procedure iconsmall spaceTo Install the Sun ONE Application Server Add-Ons Software

Configuring Sun ONE Application Server 7

procedure iconsmall spaceTo Create a Trust Database

procedure iconsmall spaceTo Register the Board With the Application Server

procedure iconsmall spaceTo Generate a Server Certificate

procedure iconsmall spaceTo Install the Server Certificate

procedure iconsmall spaceTo Enable the Application Server for SSL

Installing and Configuring Sun ONE Directory Server 5.2

Installing Sun ONE Directory Server 5.2

procedure iconsmall spaceTo Install Sun ONE Directory Server 5.2

Configuring Sun ONE Directory Server 5.2

procedure iconsmall spaceTo Create a Trust Database

procedure iconsmall spaceTo Register the Board With the Directory Server (32-Bit)

procedure iconsmall spaceTo Register the Board With the Directory Server (64-Bit)

Generating and Installing a Server Certificate

procedure iconsmall spaceTo Generate a Server Certificate

procedure iconsmall spaceTo Install the Server Certificate

Viewing and Installing Root CA Certificates

procedure iconsmall spaceTo View Root CA Certificates Known to the Directory Server

procedure iconsmall spaceTo Install Root CA Certificates

procedure iconsmall spaceTo Enable the Directory Server for SSL

Installing and Configuring Sun ONE Messaging Server 5.2

Installing Sun ONE Messaging Server 5.2

procedure iconsmall spaceTo Install Sun ONE Messaging Server 5.2

Configuring Sun ONE Messaging Server 5.2

procedure iconsmall spaceTo Create a Trust Database

procedure iconsmall spaceTo Register the Board With the Messaging Server

procedure iconsmall spaceTo Generate a Server Certificate

procedure iconsmall spaceTo Install the Server Certificate

procedure iconsmall spaceTo Enable the Messaging Server for SSL

Installing and Configuring Sun ONE Portal Server 6.2

Installing Sun ONE Portal Server 6.2

procedure iconsmall spaceTo Install Sun ONE Portal Server 6.2

Configuring Sun ONE Portal Server 6.2

procedure iconsmall spaceTo Register the Board With the Portal Server

Generating and Installing a Server Certificate

procedure iconsmall spaceTo Generate a Server Certificate

procedure iconsmall spaceTo Install the Server Certificate

Viewing and Installing Root CA Certificates

procedure iconsmall spaceTo View Root CA Certificates Known to the Portal Server

procedure iconsmall spaceTo Install Root CA Certificates

procedure iconsmall spaceTo Enable the Portal Server for SSL

6. Installing and Configuring Apache Web Server Software

Configuring Apache Web Server 1.3x

procedure iconsmall spaceTo Configure Apache Web Server

procedure iconsmall spaceTo Generate a Server Certificate

procedure iconsmall spaceTo Install the Server Certificate

Building and Configuring Apache Web Server 2.x

Building Apache 2.x Web Server

procedure iconsmall spaceTo Build Apache 2.x

Configuring Apache Web Server 2.x

procedure iconsmall spaceTo Generate a Server Certificate

procedure iconsmall spaceTo Install the Server Certificate

procedure iconsmall spaceTo Enable SSL

Configuring the Apache Web Server to Start Up Without User Interaction on Reboot

procedure iconsmall spaceTo Create an Encrypted Key for Automatic Startup of Apache Web Server on Reboot

Configuring the Sun Crypto Accelerator 1000 for Use With Apache After the Sun Crypto Accelerator 4000 Software is Installed

7. Diagnostics and Troubleshooting

SunVTS Diagnostic Software

Installing SunVTS netlbtest and nettest Support for the vca Driver

Using SunVTS Software to Perform vcatest, nettest, and netlbtest

procedure iconsmall spaceTo Perform vcatest

Test Parameter Options for vcatest

vcatest Command-Line Syntax

procedure iconsmall spaceTo Perform netlbtest

procedure iconsmall spaceTo Perform nettest

Using kstat to Determine Cryptographic Activity

Using the OpenBoot PROM FCode Self-Test

procedure iconsmall spacePerforming the Ethernet FCode Self-Test Diagnostic

Troubleshooting the Sun Crypto Accelerator 4000 Board

show-devs

.properties

watch-net

8. PKCS#11 Interface

General Issues

Administering the Board to Use PKCS#11

Installing and Administering Applications That Use Cryptographic Services

PKCS#11 and FIPS Mode

Hardware Acceleration and Sensitive Keys

Developing Applications to Use PKCS#11

A. Specifications

Sun Crypto Accelerator 4000 MMF Adapter

Connectors

Physical Dimensions

Performance Specifications

Power Requirements

Interface Specifications

Environmental Specifications

Sun Crypto Accelerator 4000 UTP Adapter

Connectors

Physical Dimensions

Performance Specifications

Power Requirements

Interface Specifications

Environmental Specifications

B. Installing the Software Without the Installation Script

Installing the Software Manually

procedure iconsmall spaceTo Install the Software Manually

Installing the Optional Packages

Directories and Files

Removing the Software Manually

procedure iconsmall spaceTo Remove the Software Manually

C. SSL Configuration Directives for Apache Web Servers

D. Configuring Custom Applications to Use the Board

Configuring Custom Applications to Use the Board

procedure iconsmall spaceTo Configure Custom Applications to Use the Board

E. Software Licenses

Third Party License Terms

F. Manual Pages

G. Zeroizing the Hardware

Zeroizing the Sun Crypto Accelerator 4000 Hardware to the Factory State

procedure iconsmall spaceTo Zeroize the Sun Crypto Accelerator 4000 Board With a Hardware Jumper