About This Guide


This guide explains how to administer the Sun ONE Portal Server, Secure Remote Access.

The Sun ONE™ Portal Server, Secure Remote Access enables remote users to securely access their organization's network and its services over the Internet. Additionally, it gives your organization a secure Internet portal, providing access to content, applications, and data to any targeted audience—employees, business partners, or the general public.

Secure Remote Access runs on the Solaris™ 8.0 Operating Environment. This guide contains instructions for configuring and administering the Secure Remote Access.

This Preface includes the following sections:

• Who Should Read This Guide

• What You Need to Know

• How This Book is Organized

• Document Conventions Used in This Guide

• Where to Find Related Information

• Where to Find This Guide Online

Who Should Read This Guide

---

This guide assumes that you are a network or system administrator experienced in managing UNIX® systems and TCP/IP networks. You are responsible for installing, configuring and administering Sun ONE Portal Server, Secure Remote Access.

You need root access to the required machines for installing the various components of Sun ONE Portal Server, Secure Remote Access. You also need the required administrative privileges to carry out other operations such as configuring users and services.

What You Need to Know

---

Before you administer Sun ONE Portal Server, Secure Remote Access, you need to be familiar with the following:

• Basic Solaris administrative procedures

• LDAP

• Sun ONE Directory Server

• iPlanet Directory Server Access Management Edition

• Sun ONE Web Server

• Sun ONE Portal Server

How This Book is Organized

---

This book contains the following chapters and appendices:

About This Guide (this chapter)

Chapter 1, "Introduction to Sun ONE Portal Server, Secure Remote Access

This chapter introduces you to the Secure Remote Access and describes the various components.

Chapter 2 "Administering the Gateway

This chapter describes the gateway admin console and how to configure the gateway attributes.

Chapter 3 "Configuring the Netlet

This chapter describes how to administer the Netlet service.

Chapter 4 "Configuring NetFile

This chapter describes how to administer the NetFile service.

Chapter 5 "Configuring the Rewriter

This chapter describes the Rewriter and provides sample rules and best practices.

Chapter 6 "Working With Certificates

This chapter provides information on certificate management, and tells you how you can install self-signed certificates, or certificates from a Certificate Authority.

Chapter 7 "Errors and Troubleshooting

This chapter lists some common errors that you may run into, and tells you how to troubleshoot such problems.

"Configuring the SSL Accelerator

This chapter describes how you can configure the SSL Accelerator for the Secure Remote Access.

Appendix B "Country Codes

This appendix lists the two-letter country codes that you need to specify during certificate administration.

Document Conventions Used in This Guide

---

Monospaced Font

Monospaced font is used for any text that appears on the computer screen or text that you should type. It is also used for file names, distinguished names, functions, and examples.

Bold Monospaced Font

Bold monospaced font is used to represent text within a code example that you should type. For example, you might see something like this:

./pssetup
*******************************************************************

Sun ONE(TM) Portal Server (6.0 release)

*******************************************************************

Installation log at /var/sadm/install/logs/pssetup.13343/install.log

This product will run without a license. However, you must either purchase a Binary Code License from, or accept the terms of a Binary Software Evaluation license with, Sun Microsystems, to legally use this product.

Do you accept? yes/[no] Starting install wizard in graphical mode

In this example, ./pssetup is what you would type from the command line and the rest is what would appear as a result.

Italicized Font

Italicized font is used to represent text that you enter using information that is unique to your installation (for example, variables). It is used for server paths and names and account IDs.

Square or Straight Brackets

Square (or straight) brackets [] are used to enclose optional parameters. For example, in this document you will see the usage for the xx command described as follows:

xx [options] [action] [component]

The presence of [options], [arguments], and [component] indicates that there are optional parameters that may be added to the xx command.

Command-Line Prompts

Command-line prompts (for example, % for a C-Shell, or $ for a Korn or Bourne shell) are not displayed in the examples. Depending on which operating system environment you are using, you will see a variety of different command-line prompts. However, you should enter the command as it appears in the document unless specifically noted otherwise.

Where to Find Related Information

---

Other documents in the Sun ONE Portal Server, Secure Remote Access 6.0 documentation set are:

• Sun ONE Portal Server, Secure Remote Access 6.0 Installation Guide

• Sun ONE Portal Server, Secure Remote Access 6.0 Attribute Reference Guide

  (This online help is available from the administration console when you click the Documentation link, and then the SRAP link).

• Sun ONE Portal Server, Secure Remote Access 6.0 Netlet Online Help

• Sun ONE Portal Server, Secure Remote Access 6.0 NetFile Java1 Online Help

• Sun ONE Portal Server, Secure Remote Access 6.0 NetFile Java2 Online Help

Where to Find This Guide Online

---

The docs.sun.com web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. The URL is docs.sun.com.