Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Portal Server Secure Remote Access 6 2005Q1 Administration Guide 

Preface

This guide explains how to administer the Sun Java™ System Portal Server Secure Remote Access.

Sun Java System Portal Server Secure Remote Access (SRA) 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.

SRA runs on the Solaris™ 8.0 Operating System and higher and the Linux platform. This guide contains instructions for configuring and administering SRA.

This Preface includes the following sections:


Who Should Read This Book

This Administration Guide is intended for user that configure and administer SRA.

This Administration Guide assumes that you are a network or system administrator experienced in managing UNIX� systems and TCP/IP networks. You do not need root access to the required machines for installing the various components of SRA. You do need the required administrative privileges to carry out other operations such as configuring users and services.

Portal Server Secure Remote Access administrators should understand the following technology:

You also need the following to be able to write Rewriter rules:


How This Book is Organized

The following table summarizes the content of this book.

Table 1  How This Book is Organized

Chapter

Description

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

This chapter describes the SRA software and the relationship between the Portal Server and SRA software components. It also provides information on administering and configuring SRA software.

Chapter 2, "The Gateway"

This chapter describes Gateway related concepts and information required for the smooth running of the Gateway.

Chapter 3, "Proxylet and Rewriter"

This chapter describes Proxylet and Rewriter. For Rewriter, it provides sample rules and best practices.

Chapter 4, "NetFile"

Describes NetFile and explains its operation.

Chapter 5, "Netlet"

Describes how to use Netlet to run applications securely between users’ remote standard Portal Desktops and the servers running applications on your intranet.

Chapter 6, "Netlet With PDC"

Describes how to configure the client browser’s Java Plugin so that Netlet can be used with PDC.

Chapter 7, "Certificates"

Describes certificate management and explains how to install self-signed certificates or certificates from a Certificate Authority.

Chapter 8, "Configuring URL Access Control"

Describes how to allow or deny access to the end-user through the Gateway for specific URLs.

Chapter 9, "Configuring the Gateway"

Describes how to configure the Gateway attributes from the Access Manager administration console.

Chapter 10, "Configuring NetFile"

Describes how to configure NetFile from the Access Manager administration console.

Chapter 11, "Configuring Netlet"

Describes how to configure Netlet attributes from the Access Manager administration console.

Chapter 12, "Configuring Proxylet"

Describes how to configure Proxylet from the Access Manager administration console.

Chapter 13, "Configuring SSL Accelerators"

Describes how to configure various accelerators for Portal Server Secure Remote Access.

Appendix A, "Log Files"

This appendix lists all the Portal Server Secure Remote Accesslog files and their descriptions.

Appendix B, "Configuration Attributes"

Lists the attributes you set for Portal Server Secure Remote Access on the Access Manager administration console.

Appendix C, "Country Codes"

Lists the two-letter country codes that you need to specify during certificate administration.

Glossary 

Contains the link to the global glossary for the Sun Java System.


Conventions Used in This Book

The tables in this section describe the conventions used in this book.

Typographic Conventions

The following table describes the typographic changes used in this book.

Table 2  Typographic Conventions 

Typeface

Meaning

Examples

AaBbCc123
(Monospace)

API and language elements, HTML tags, web site URLs, command names, file names, directory path names, onscreen computer output, sample code.

Edit your.login file.

Use ls -a to list all files.

% You have mail.

AaBbCc123
(Monospace bold)

What you type, when contrasted with onscreen computer output.

% su
Password:

AaBbCc123
(Italic)

Book titles, new terms, words to be emphasized.

A placeholder in a command or path name to be replaced with a real name or value.

Read Chapter 6 in the User’s Guide.

These are called class options.

Do not save the file.

The file is located in the install-dir/bin directory.

Default Paths and File Names

The following table describes the default paths and file names used in this book.

Table 3  Default Paths and File Names

Path Name

Description

/etc/opt/SUNWps/platform.conf.default

location for all the platform.conf.* files

gateway-install-root/SUNWps/bin/gateway

location of gateway-instance names

/etc/opt/SUNWam/config/

location of AMConfig-instance-name.properties

portal-server-install-root/SUNWps/locale

location of srapGateway.properties

/var/opt/SUNWps/debug

location of gateway debug log files

/var/opt/SUNWam/debug

default debug directory for service logs when debug is turned on from the Access Manager administration console.

/var/opt/SUNWam/logs/srapNetFile

location of log files

/etc/opt/SUNWps/cert/default/gateway-profile-name

location of certificate related files

/opt/S1PS62/SUNWps/samples/config/netfile

MIME-types configuration file location


Using Linux

Sun Java™ System Portal Server supports RedHat 3.0 Linux platform, however, please note the differences between the Solaris and Linux platforms:

Limitations Using Linux

Configuration files, deployment, and Application Programming Interfaces are the same for Solaris and Linux.

Comparison of Solaris and Linux Path Names

Table 4  Comparison of Solaris and Linux Path Names

Solaris Path Name

Linux Path Name

/opt/SUNWps ( default)

/opt/sun/portal (default)

/etc/opt/SUNWps (config)

/etc/opt/sun/portal (config)

/var/opt/SUNWps (data)

/var/opt/sun/portal (data)


Related Information

The http://docs.sun.comSM web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject.

Books in This Documentation Set

The following table summarizes the books included in the Portal Server Secure Remote Access core documentation set

Book Title

Description

Portal Server Deployment Planning Guide

http://docs.sun.com/db/doc/817-7691

Describes how to plan for and deploy Portal Server software.

Portal Server Administration Guide

http://docs.sun.com/db/doc/817-7691

Describes how to administer Portal Server using the Access Manager administration console and the command line.

Portal Server Secure Remote Access Administration Guide

http://docs.sun.com/db/doc/817-7693

Describes how to administer Portal Server Secure Remote Access.

Portal Server Release Notes

http://docs.sun.com/db/doc/817-7699

Available after the product is released. Contains last-minute information, including a description of what is new in this current release, known problems and limitations, installation notes, and how to report issues with the software or the documentation.

Portal Server Technical Reference Guide

http://docs.sun.com/db/doc/817-7696

Provides detailed information on the Portal Server technical concepts (such as Display Profile, Rewriter), command line utilities, tag libraries (in the software), and files (such as templates and JSPs). This guide serves as a single source for such essential background information.

Other Portal Server Documentation

Other Portal Server books include:

Other Server Documentation

For other server documentation, go to the following:


Accessing Sun Resources Online

For product downloads, professional services, patches and support, and additional developer information, go to the following:


Contacting Sun Technical Support

If you have technical questions about this product that are not answered in the product documentation, go to http://www.sun.com/service/contacting.


Related Third-Party Web Site References

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun is not responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.


Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions.

To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the title of this book is Portal Server Secure Remote Access 2005Q1 Administration Guide, and the part number is 817-7693.



Previous      Contents      Index      Next     


Part No: 817-7693.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.