Installation Guide Sun™ ONE Portal Server, Mobile Access Version 6.
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.
Contents About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 What You Need to Know . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How This Book Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Conventions Used in This Guide . . . . . . . . . . . . . .
2 Sun ONE Portal Server, Mobile Access 6.
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.
How This Book Is Organized • Sun™ ONE Portal Server, Secure Remote Access 6.
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.
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.
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.
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.
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.
Patch 116441-01 or Higher 10 Sun ONE Portal Server, Mobile Access 6.
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.
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.
Installing the Software TIP 8. These passwords were assigned with Identify Server software and Directory Server software were installed. 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.
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. TIP The default URL is http://server:port/portal.
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.
Enabling Multi-Server Instances TIP 2. To do this, use these commands: cp -R aml , cp -R wml , cp -R xml , and cp -R vxml . 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.
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.
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.
Appendix A Patch 116441-01 Reference Sun™ ONE Portal Server 6.2 Patch 116441-01 corrects a number of Portal Server bugs that affect how Sun™ ONE Portal Server, Mobile Access 6.2 functions. See Chapter 1, “Planning Mobile Access Software Installation,” for details about installing this patch. This appendix provides Table A-1, a two-column table that lists fixed bugs related to Mobile Access software. The first column contains the bug number. The second column provides a brief description of the bug.
Table A-1 Portal Server Bugs Fixed by Patch 116441-01 Bug Number Description 4947897 Rendering for the calendar application fails to combine contents and generate a More link. 4951756 Changing a recurring event in Lotus Notes calendar deletes all instances of the event except for the current one. 4951664 The repeatOn rule does not work in Lotus Notes calendar for This week. It follows the rule correctly from next week. 4940688 Recurrence with repeatUntilDate fails in Lotus Notes.
