Sun Microsystems One Portal Server User Manual

Installation Guide

Sun™ ONE Portal Server, Mobile Access

V ersion6.2

816-6832-10
December 2003

Copyright © 2003 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved.
Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In

particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at
http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and in other countries.

THIS PRODUCT CONTAINS CONFIDENTIAL INFORMATION AND TRADE SECRETS OF SUN MICROSYSTEMS, INC. USE, DISCLOSURE
OR REPRODUCTION IS PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF SUN MICROSYSTEMS, INC.

U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and
applicable provisions of the FAR and its supplements.

This distribution may include materials developed by third parties.
Parts of theproduct may bederived from Berkeley BSD systems, licensed from theUniversity of California.UNIX is a registered trademark in the

U.S. and in other countries, exclusively licensed through X/Open Company, Ltd.
Sun, Sun Microsystems, the Sun logo, Java, Solaris, JDK, Java Naming and Directory Interface, JavaMail, JavaHelp, J2SE, iPlanet, the Duke logo,

the Java Coffee Cup logo, the Solaris logo, the SunTone Certified logo and the Sun ONE logo are trademarks or registered trademarks of Sun
Microsystems, Inc. in the U.S. and other countries.

All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other
countries. Products bearing SPARC trademarks are based upon architecture developed by Sun Microsystems, Inc.

Legato and the Legato logo are registered trademarks, and Legato NetWorker, are trademarks or registered trademarks of Legato Systems, Inc.
The Netscape Communications Corp logo is a trademark or registered trademark of Netscape Communications Corporation.

The OPEN LOOK and Sun(TM)Graphical User Interface was developedby Sun Microsystems, Inc. for its usersand licensees. Sun acknowledges
the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun
holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun's licensees who implement OPEN
LOOK GUIs and otherwise comply with Sun's written license agreements.

Products covered by and information contained in this service manual are controlled by U.S. Export Control laws and may be subject to the
export or importlaws in other countries. Nuclear,missile, chemical biological weapons ornuclear maritime end uses orend users, whether direct
or indirect, are strictly prohibited. Export or reexport to countries subject to U.S. embargo or to entities identified on U.S. export exclusion lists,
including, but not limited to, the denied persons and specially designated nationals lists is strictly prohibited.

DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
INCLUDING ANY IMPLIED WARRANTYOF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT,
ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.

_______________________________________________________________________________________________________________
Copyright © 2003 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, Etats-Unis. Tous droits réservés.
Sun Microsystems, Inc. détient les droits de propriété intellectuels relatifs à la technologie incorporée dans le produit qui est décrit dans ce

document. En particulier, et ce sans limitation, ces droits de propriété intellectuelle peuvent inclure un ou plus des brevets américains listés à
l'adresse http://www.sun.com/patents et un ou les brevets supplémentaires ou les applications de brevet en attente aux Etats - Unis et dans les
autres pays.

CE PRODUIT CONTIENT DES INFORMATIONS CONFIDENTIELLES ET DES SECRETS COMMERCIAUX DE SUN MICROSYSTEMS, INC.
SON UTILISATION, SA DIVULGATION ET SA REPRODUCTION SONT INTERDITES SANS L AUTORISATION EXPRESSE, ECRITE ET
PREALABLE DE SUN MICROSYSTEMS, INC.

Cette distribution peut comprendre des composants développés par des tierces parties.
Des parties de ce produit pourront être dérivées des systèmes Berkeley BSD licenciés par l'Université de Californie. UNIX est une marque

déposée aux Etats-Unis et dans d'autres pays et licenciée exclusivement par X/Open Company, Ltd.
Sun, Sun Microsystems, le logo Sun, Java, Solaris, JDK, Java Naming and Directory Interface, JavaMail, JavaHelp, J2SE, iPlanet, le logo Duke, le

logo Java Coffee Cup, le logo Solaris, le logo SunTone Certified et le logo Sun[tm] ONE sont des marques de fabrique ou des marques déposées
de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.

Toutes les marquesSPARC sont utilisées sous licenceet sont des marques defabrique ou desmarques déposées de SPARC International,Inc. aux
Etats-Unis et dans d'autres pays. Les produits portant lesmarques SPARC sont basés sur une architecture développée par Sun Microsystems,Inc.

Le logo Netscape Communications Corp est une marque de fabrique ou une marque déposée de Netscape Communications Corporation.
L'interface d'utilisation graphique OPEN LOOK et Sun(TM) a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun

reconnaît les efforts de pionniers de Xerox pour la recherche et le développement du concept des interfaces d'utilisation visuelle ou graphique
pour l'industrie de l'informatique. Sun détient une license non exclusive de Xerox sur l'interface d'utilisation graphique Xerox, cette licence
couvrant également les licenciés de Sun qui mettent en place l'interface d'utilisation graphique OPEN LOOK et qui, en outre, se conforment aux
licences écrites de Sun.

Les produits qui font l'objet de ce manuel d'entretien et les informations qu'il contient sont regis par la legislation americaine en matiere de
controle des exportations et peuvent etre soumis au droit d'autres pays dans le domaine des exportations et importations. Les utilisations finales,
ou utilisateurs finaux, pour des armes nucleaires, des missiles, des armes biologiques et chimiques ou du nucleaire maritime, directement ou
indirectement, sont strictement interdites. Les exportations ou reexportations vers des pays sous embargo des Etats-Unis, ou vers des entites
figurant sur les listes d'exclusion d'exportation americaines, y compris, mais de maniere non exclusive, la liste de personnes qui font objet d'un
ordre de ne pas participer, d'une facon directe ou indirecte, aux exportations des produits ou des services qui sont regi par la legislation
americaine en matiere de controle des exportations et la liste de ressortissants specifiquement designes, sont rigoureusement interdites.

LA DOCUMENTATION EST FOURNIE "EN L'ETAT" ET TOUTES AUTRES CONDITIONS, DECLARATIONS ET GARANTIES EXPRESSES
OU TACITES SONT FORMELLEMENT EXCLUES, DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT
TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L'APTITUDE A UNE UTILISATION PARTICULIERE OU A
L'ABSENCE DE CONTREFACON.

Contents

About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

What You Need to Know . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

How This Book Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Conventions Used in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Where to Find Related Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Where to Find This Guide Online . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Chapter 1 Planning Mobile Access Software Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Patch 116441-01 or Higher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

To Install Portal Server Patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

To Uninstall Portal Server Patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Chapter 2 Installing Mobile Access Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Downloading the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

To Download the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

To Uncompress the File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

To Install the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

To Verify Your Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Enabling Multi-Server Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

To Enable Existing Multi-Server Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

To Enable New Multi-Server Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Chapter 3 Uninstalling Mobile Access Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

To Uninstall the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Appendix A Patch 116441-01 Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

1

2 Sun ONE Portal Server, Mobile Access 6.2 • Installation Guide • December 2003

About This Guide

This guide explains how to install Sun™ ONE Portal Server, Mobile Access 6.2
software, which is available for Sun™ ONE Portal Server6.2 software. Mobile
Access software extends the services and capabilities of Portal Server platform to
mobile devices, such as mobile phones and personal digital assistants. It also
provides a framework for voice access.

This preface includes the following sections:

• What You Need to Know

• How This Book Is Organized

• Conventions Used in This Guide

• Where to Find Related Information

• What You Need to Know
You should read this book if you are portal administrator or system administrator

responsible for managing Sun ONE Portal Server, Mobile Access software at your
site.

What You Need to Know

What you need to know will vary with the characteristics of your site.
Understanding of the following is recommended:

• Your Web container, such as Sun™ ONE Application Server 7.0 Platform
Edition, Update 2, or Sun™ ONE Web Server 6.1

• Sun™ ONE Identity Server 6.1

• Sun™ ONE Portal Server 6.2

3

How This Book Is Organized

• Sun™ ONE Portal Server, Secure Remote Access 6.2

• Solaris™ 8 Operating System (SPARC® Platform Edition) or Solaris™ 9
Operating System (SPARC® Platform Edition)

• Basic UNIX® administrative procedures

• Markup languages used to create portal content appropriate for mobile and
voice environments, such as HTML, cHTML, and VoiceXML

• LDAP (lightweight directory access protocol)

How This Book Is Organized

This book contains the following chapters and appendixes:

• Chapter 1, “Planning Mobile Access Software Installation” explains what you
need to do before installing the Mobile Access product.

• Chapter 2, “Installing Mobile Access Software” provides step-by-step
instructions for installing the Mobile Access product.

• Chapter 3, “Uninstalling Mobile Access Software” describes how to uninstall
the Mobile Access product.

• Appendix A, “Patch 116441-01 Reference” provides information related to
Patch 116441-01.

Conventions Used in This Guide

The guide uses several typographical conventions to represent types of
information presented.

Monospaced Font

Monospaced font

that you should type. It is also used for file names, distinguished names, functions,
and examples.

4 Sun ONE Portal Server, Mobile Access 6.2 • Installation Guide • December 2003

is used for any text that appears on the computer screen or text

Bold Monospaced Font

Conventions Used in This Guide

Bold monospaced font

should type. For example, you might see something like this:

./pssetup

*******************************************************************
Sun(TM) ONE Portal Server
*******************************************************************
Installation log at
/var/sadm/install/logs/ipsinstall.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]

In this example,
rest is what would appear as a result.

is used to represent text within a code example that you

./pssetup

is what you would type from the command line. The

Italicized Font

An 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 Portal Server software documentation, you will see the usage for the

dpadmin
dpadmin list|modify|add|remove [command-specific options]

The presence of
added to the

command described as follows:

[command-specific]

dpadmin

command.

indicates that optional parameters can be

About This Guide 5