Installation Guide
Sun™ ONE Portal Server, Mobile Access
Version6.2
816-6832-10
December 2003
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
Access software extends the services and capabilities of Portal Server platform to
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)
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 fontis 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.
4
Sun ONE Portal Server, Mobile Access 6.2 • Installation Guide • December 2003
Conventions Used in This Guide
Bold Monospaced Font
Bold monospaced fontis 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 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, ./pssetupis what you would type from the command line. The
rest is what would appear as a result.
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
dpadmincommand described as follows:
dpadmin list|modify|add|remove [command-specific options]
The presence of [command-specific]indicates that optional parameters can be
added to the dpadmincommand.
About This Guide
5
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
supplementary information for administrators as well as documentation for
developers.
Use the following URL to view all the Portal Server documentation:
Additional documents that are available include:
•
•
•
•
Sun™ ONE Portal Server, Mobile Access Release Notes
Sun™ ONE Portal Server, Mobile Access Administrator’s Guide
Sun™ ONE Portal Server, Mobile Access Developer’s Manual
Sun™ ONE Portal Server, Mobile Access Tag Reference Library
Check the Mobile Access documentation web site at
Access documentation.
NOTE
Where to Find This Guide Online
You can find the Sun™ ONE Portal Server, Mobile Access 6.2 Installation Guide online
in PDF and HTML formats. This book can be found at the following URL:
6
Sun ONE Portal Server, Mobile Access 6.2 • Installation Guide • December 2003
Chapter 1
Planning Mobile Access Software
Installation
meet the system requirements for this product, and you must decide whether you
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 software installed.
Portal Server must be installed and operating correctly before you begin installing
Mobile Access software.
For details on Sun ONE Portal Server 6.2 software, including installation
instructions, refer to documentation for Sun™ ONE Portal Server 6.2 software.
Table 1-1 provides hardware and software requirements for this release of Portal
Server, Mobile Access software. Each hardware or software component is listed in
the first column, and its related requirement is listed in the second column.
Table 1-1
System Requirements for Mobile Access 6.2 Installation
Component
Requirement
Operating system
Solaris™ 8 Operating System or Solaris 9 Operating System
7
Patch 116441-01 or Higher
Table 1-1
System Requirements for Mobile Access 6.2 Installation (Continued)
Component
CPU
Requirement
Dual CPU class system
512 Mbytes
1 Gbyte
RAM
Disk space
Swap space
Web container
1 Gbyte
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, VoiceXML,
and WML
Several bugs in the Portal Server 6.2 software adversely affect how Lotus Notes
and Microsoft Exchange address book, calendar, and mail applications function.
Patch 116441-01 or higher for Portal Server 6.2 software provides fixes for these
defects. See Appendix A, “Patch 116441-01 Reference,” for details about these bugs.
Installing this patch for Portal Server 6.2 is strongly recommended if you plan to
offer these applications to your mobile portal users now or in the future. This patch
is available on the Mobile Access 6.2 software CD-ROM and is also available for
download at http://www.sun.com
.
To Install Portal Server Patch
1. Become superuser with the sucommand.
2. Stop Portal Server.
3. Change the current directory to the location where the patch is:
cd /tmp_patchdir
4. Use the patchadd command:
/usr/sbin/patchadd 116441-01
8
Sun ONE Portal Server, Mobile Access 6.2 • Installation Guide • December 2003
Patch 116441-01 or Higher
5. When the installation is finished, see /var/sadm/patch/116441-01/logto 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 sucommand.
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 1 Planning Mobile Access Software Installation
9
Patch 116441-01 or Higher
10 Sun ONE Portal Server, Mobile Access 6.2 • Installation Guide • December 2003
Chapter 2
Installing Mobile Access Software
server where Sun™ ONE Portal Server software is installed.
Use the installation wizard that is provided with the software to install Portal
through the installation process:
•
•
•
Downloading the Software
Installing the Software
Enabling Multi-Server Instances
Before you start, be sure that you have already verified that you can satisfy the
system requirements for Mobile Access software and that you have already
installed Patch 116441-01 for Portal Server software.
CAUTION
Downloading the Software
Use the Sun ONE Portal Server, Mobile Access software CD-ROM to install the
software. If you wish, you can download and access the Mobile Access software as
described below.
To Download the Software
1. You can use the Sun ONE Portal Server, Mobile Access 6.2 software CD-ROM
or download the software at the following web site:
11
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 unzipcommand (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
Mobile Access software installer will install the sample mobile portal. Otherwise,
the Mobile Access installer will install only the core Mobile Access software.
NOTE
To Install the Software
1. Make sure that Sun™ ONE Directory Server software and Portal Server
software are running.
2. Become superuser with the sucommand.
3. Change directory to the location where the Mobile Access software has been
downloaded and uncompressed.
4. Type the following command to launch the installation wizard:
./setup[-nodisplay]
5. Review the Sun ONE Portal Server welcome information, and click the Next
button.
6. Review the Software License Agreement.
Click the Yes button to accept the license agreement and to continue with your
installation. (If you are not ready to proceed, click Exit.)
7. Provide passwords for the Sun™ ONE Identity Server administrator and for
the Directory Server directory manager. Click Next to continue.
12 Sun ONE Portal Server, Mobile Access 6.2 • Administrator’s Guide • December 2003
Installing the Software
These passwords were assigned with Identify Server software and Directory
Server software were installed.
TIP
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 Installedappears in the Status column.
10. To view other information about your installation, click the Details button.
The summary report in the /var/sadm/install/logsdirectory is displayed.
Click OK to close the window.
11. Click Close to close the installation wizard.
12. Restart your web container.
To Verify Your Installation
1. Log on to the Sun™ ONE Identity Server administration console as amadmin.
The default URL is http://server:port/amconsole
.
TIP
2. Click the Service Configuration tab.
3. Under the Service name heading in the left pane. verify that the Mobile
Application Configuration service is present and that the address book, mail
and calendar applications are listed.
4. Under the Service name heading in the left pane. under the Identify Server
heading, click the arrow for Client Detection to display Client Detection
information in the right pane.
5. Click the Edit link following the Client Types label to launch the Client
Manager.
6. Verify that tabs for HDML, JHTML, VoiceXML, WML, XHTML, cHTML, and
iHTML are present.
7. Close the Client Manager.
Chapter 2 Installing Mobile Access Software 13
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 is http://server:port/portal
.
TIP
Enabling Multi-Server Instances
When you install Mobile Access software, authentication pages and the servlet
filter definition are not configured correctly. To configure these, you must
complete additional steps after you have installed Mobile Access software.
The steps you should follow depend on whether multi-server instances existed
before you installed Mobile Access software, or whether you want to enable new
multi-server instances after you install Mobile Access software.
To Enable Existing Multi-Server Instances
1. Copy the aml wml, xml, and vxmlsubdirectories from the
,
identity-server-installation-root/SUNWam/web-apps/services/config/auth/default
directory to this directory:
identity-server-installation-root/SUNWam/web-apps-new-instance-name/services/config/aut
h/default
.
To do this, use these commands: cp -R aml <destination-directory
wml <destination-directory cp -R xml <destination-directory , and cp -R
vxml <destination-directory
>
,
cp -R
TIP
>
>
,
>
.
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. Make a copy of this file:
web-server-installation-root/https-second-instance/config/server.xml
14 Sun ONE Portal Server, Mobile Access 6.2 • Administrator’s Guide • December 2003
Enabling Multi-Server Instances
4. Copy the classpathdefinition in the server.xmlfile 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" envclasspathignored=
.
.
.
This example divides the definition string into separate lines for readability
purposes. Line breaks preceding each /opt/have been added.
5. Update the web-server-installation-root/https-new-instance-name/config/mime.typesfile
with these definitions:
type=text/vnd.wap.wml
exts=wml
type=image/vnd.wap.wbmp
exts=wbmp
6. Restart the Web Server instance.
To Enable New Multi-Server Instances
1. Copy the aml wml, and vxmlsubdirectories from the
,
identity-server-installation-root/SUNWam/web-apps/services/config/auth/default
directory to this directory:
identity-server-installation-root/SUNWam/web-apps-new-instance-name/services/config/aut
h/default
.
Chapter 2 Installing Mobile Access Software 15
Enabling Multi-Server Instances
To do this, use these commands: cp -R aml <destination-directory
wml <destination-directory cp -R xml <destination-directory , and cp -R
vxml <destination-directory
>
,
cp -R
TIP
>
>
,
>
.
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:
<filter>
<filter-name>mapcontroller</filter-name>
<filter-class>com.sun.portal.wireless.services.filter.MAPController
</filter-class>
</filter>
<filter-mapping>
<filter-name>mapcontroller</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
4. Add this filter definition before the first <servlet>definition in this file:
identity-server-installation-root/SUNWam/web-apps-new-instance-name/services/WEB-INF/web.
xml
5. Restart the Web Server instance.
16 Sun ONE Portal Server, Mobile Access 6.2 • Administrator’s Guide • December 2003
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
Directory Server installation that supports your Mobile Access installation.
To Uninstall the Software
1. Become superuser with the sucommand.
2. Change directory to portal-server-installation-root directory (for example, cd
/opt).
3. Type the following command to launch the wizard for uninstalling Mobile
Access software:
./uninstallmap [-nodisplay]
4. Review the information that welcomes you to the Sun ONE Portal Server
unistallation program, and click Next.
5. Provide the password for the Sun™ ONE Identify Server administrator click
Next to continue.
6. Leave the check box as checked to uninstall the Mobile Access software. Click
Next.
17
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 Uninstalledappears 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/logsdirectory is displayed.
Click OK to close the window.
10. Click the Close button to close the wizard.
11. Enter /opt/SUNWps/bin/deploy
12. Restart Portal Server.
.
13. Restart your web container.
a. Change directory to /etc(for example, cd /etc).
b. Enter ./init.d/amserver start
.
18 Sun ONE Portal Server, Mobile Access 6.2 • Administrator’s Guide • December 2003
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
4925784
4874929
4913727
4935543
4935554
4944166
4946722
4948012
4937477
CacheManagershould be able to POST to the resulting URL even if a
query is too long.
AML needs a previoustag to allow user to return to the previous screen in
the user interface flow.
A More option (to specify pagination) is needed at the end of text so that the
user does not have to return to the Menu to select more content.
Nokia 3650 devices show that a single content channel is selected, even
though multiple content channels are selected.
The Sony Ericsson T62u device browser requires all input fields to be filled
out when composing a mail message.
Rendered pages on Nokia40 simulator do not have text specified with the
AmlTexttag.
Windows CE clients need a new search rule to allow all Windows CE
devices to default to the cHTML file path.
Login using Nokia7110 device through rendering results in a pagecannot
bedisplayederror.
PimTask.getDueDateor getSummarythrows exception.
19
Table A-1
Portal Server Bugs Fixed by Patch 116441-01
Bug Number
Description
4947897
4951756
4951664
Rendering for the calendar application fails to combine contents and
generate a More link.
Changing a recurring event in Lotus Notes calendar deletes all instances of
the event except for the current one.
The repeatOnrule does not work in Lotus Notes calendar for This week. It
follows the rule correctly from next week.
4940688
4953089
Recurrence with repeatUntilDatefails in Lotus Notes.
The repeatOnrule in Microsoft Exchange calendar creates the wrong
number of instances.
4950943
4939263
The Updated Recurring Event in Lotus Notes calendar creates problem.
A task that is complete cannot be created using Lotus Notes.
For a complete list of all bugs fixed by this patch, see the readmefile for the patch.
20 Sun ONE Portal Server, Mobile Access 6.2 • Installation Guide • December 2003
|