Summary of the content on the page No. 1
Installation Guide
Sun™ ONE Portal Server, Mobile Access
Version6.2
816-6832-10
December 2003
Summary of the content on the page No. 2
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
Summary of the content on the page No. 3
Contents About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 What You Need to Know . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 How This Book Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Conventions Used in This Guide . . . . . .
Summary of the content on the page No. 4
2 Sun ONE Portal Server, Mobile Access 6.2 • Installation Guide • December 2003
Summary of the content on the page No. 5
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 Gui
Summary of the content on the page No. 6
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: • Chapt
Summary of the content on the page No. 7
Conventions Used in This Guide 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(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
Summary of the content on the page No. 8
Where to Find Related Information Command-Line Prompts Command-line prompts (for example,% for a C-Shell, or$ for a Korn or Bourne shell) are not displayed in 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 In addition to this guide, this Mobile Access software release provides
Summary of the content on the page No. 9
Chapter 1 Planning Mobile Access Software Installation Before you install Sun™ ONE Portal Server, Mobile Access 6.2 software, you must meet the system requirements for this product, and you must decide whether you need to install a patch for Sun™ ONE Portal Server 6.2 software. This chapter provides the information you need to review before installing the software: • System Requirements • Patch 116441-01 or Higher System Requirements Be sure that you already have Sun™ ONE Portal Server 6.2 sof
Summary of the content on the page No. 10
Patch 116441-01 or Higher Table 1-1 System Requirements for Mobile Access 6.2 Installation (Continued) Component Requirement CPU Dual CPU class system RAM 512 Mbytes Disk space 1 Gbyte Swap space 1 Gbyte Web container Sun™ ONE Web Server 6.1 Sun™ ONE Application Server 7.0, Platform Edition, Update 2 Sun ONE Application Server 7.0, Standard Edition software Web browser Netscape™ Communicator 6.2x or higher Microsoft Internet Explorer 5.5 or 6.0 Clients using cHTML, iHTML, JHTML, XHTML, HDML, Voi
Summary of the content on the page No. 11
Patch 116441-01 or Higher 5. When the installation is finished, see /var/sadm/patch/116441-01/log to view detailed information about your installation. 6. Enter /opt/SUNWps/bin/deploy . 7. Restart Portal Server. To Uninstall Portal Server Patch 1. Become superuser with the su command. 2. Stop Portal Server. 3. Change the current directory to the location where the patch is: cd /tmp_patchdir/116441-01 4. Enter patchrm 116441-01. 5. Enter /opt/SUNWps/bin/deploy . 6. Restart Portal Server. Chapter
Summary of the content on the page No. 12
Patch 116441-01 or Higher 10 Sun ONE Portal Server, Mobile Access 6.2 • Installation Guide • December 2003
Summary of the content on the page No. 13
Chapter 2 Installing Mobile Access Software You must install Sun™ ONE Portal Server, Mobile Access 6.2 product on each server where Sun™ ONE Portal Server software is installed. Use the installation wizard that is provided with the software to install Portal Server, Mobile Access. This chapter covers the following topics to guide you through the installation process: • Downloading the Software • Installing the Software • Enabling Multi-Server Instances Before you start, be sure that you have a
Summary of the content on the page No. 14
Installing the Software 2. Follow the instructions provided. To Uncompress the File 1. Change directory to the location in which the software has been downloaded. 2. Uncompress the Mobile Access file with the unzip command (for example, unzip filename.zip). Installing the Software This section describes how to install the Sun ONE Portal Server, Mobile Access 6.2 software. If the sample portal was installed during Portal Server software installation, the NOTE Mobile Access software installer will
Summary of the content on the page No. 15
Installing the Software These passwords were assigned with Identify Server software and Directory TIP Server software were installed. 8. Review the Ready to Install information and click Next to start the Mobile Access installation. (If you are not ready to proceed, click Exit.) The progress of your installation is displayed. After your installation is completed, an Installation Summary is displayed. 9. Verify that Installed appears in the Status column. 10. To view other information about your
Summary of the content on the page No. 16
Enabling Multi-Server Instances 8. Click the Identity Management tab. 9. From the View menu in the location pane, select Services. 10. Verify that the Mobile Application Configuration heading is present and that the address book, mail and calendar applications are listed. 11. Log on to your portal site using a mobile device. The default URL ishttp://server:port/portal. TIP Enabling Multi-Server Instances When you install Mobile Access software, authentication pages and the servlet filter definit
Summary of the content on the page No. 17
Enabling Multi-Server Instances 4. Copy the classpath definition in the server.xml file from the first instance server to the new instance. This can be something like this: /IS_CLASSPATH_END_DELIM::: /opt/IS/SUNWam/lib/wireless_services.jar: /opt/IS/SUNWam/lib/wireless_utils.jar: /opt/IS/SUNWam/lib/wireless_rendering.jar: /opt/IS/SUNWam/lib/wireless_rendering_util.jar: /opt/IS/SUNWam/lib/ccpp.jar: /opt/IS/SUNWam/lib/ccpp-ri.jar:/opt/IS/SUNWam/lib/jena-1.4.0.jar: /opt/IS/SUNWam/lib/rdffilter.jar"
Summary of the content on the page No. 18
Enabling Multi-Server Instances To do this, use these commands:cp -R aml ,cp -R TIP wml ,cp -R xml , andcp -R vxml . 2. Make a back-up copy of this file: identity-server-installation-root/SUNWam/web-apps-new-instance-name/services/WEB-INF/we b.xml 3. Find the filter definition in this file: identity-server-installation-root/SUNWam/web-apps/services/WEB-INF/web.xml Here is the fragment:
Summary of the content on the page No. 19
Chapter 3 Uninstalling Mobile Access Software Use the uninstallation wizard that is provided with the software to remove the Sun™ ONE Portal Server, Mobile Access 6.2 software. This chapter describes how to uninstall the Portal Server, Mobile Access software. Before you begin, make a back-up copy of the files you customized or created within your installation before you remove the software. Depending upon your requirements, you should also consider creating an LDIF dump of the Sun™ ONE Directo
Summary of the content on the page No. 20
7. After reviewing the Ready to Uninstall Information, click Uninstall Now. (If you are not ready to proceed, click Exit.) The progress of your uninstallation is displayed. When removal of Mobile Access software is completed, an Uninstallation Summary is displayed. 8. Verify that Uninstalled appears in the Status column. 9. To view detailed information about your uninstallation, click the Details button to launch the uninstallation log. The summary report in the /var/sadm/install/logs directory
