Sun logo      Previous      Contents      Next     

Sun[tm] ONE Portal Server, Mobile Access 6.2 Installation Guide

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

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:

    2. http://www.sun.com/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.

Note

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.

To Install the Software

  1. Make sure that Sun™ ONE Directory Server software and Portal Server software are running.
  2. Become superuser with the su command.
  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:

    5. ./setup [-nodisplay]

  5. Review the Sun ONE Portal Server welcome information, and click the Next button.
  6. Review the Software License Agreement.

    7. 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.

    8. Tip

    These passwords were assigned with Identify Server software and Directory 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.)

    9. 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 installation, click the Details button.

    11. The summary report in the /var/sadm/install/logs directory 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.

    2. Tip

    The default URL is http://server:port/amconsole.

  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.
  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.

    12. Tip

    The default URL is http://server:port/portal.

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 vxml subdirectories 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/auth/default.

    2. Tip

    To do this, use these commands: cp -R aml <destination-directory>, cp -R wml <destination-directory>, cp -R xml <destination-directory>, and cp -R vxml <destination-directory>.

  2. Make a back-up copy of this file: identity-server-installation-root/SUNWam/web-apps-new-instance-name/services/WEB-INF/web.xml
  3. Make a copy of this file: web-server-installation-root/https-second-instance/config/server.xml
  4. Copy the classpath definition in the server.xml file from the first instance server to the new instance.

    5. 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.types file with these definitions:

    6.  

    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 vxml subdirectories 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/auth/default.

    2. Tip

    To do this, use these commands: cp -R aml <destination-directory>, cp -R wml <destination-directory>, cp -R xml <destination-directory>, and cp -R vxml <destination-directory>.

  2. Make a back-up copy of this file: identity-server-installation-root/SUNWam/web-apps-new-instance-name/services/WEB-INF/web.xml
  3. Find the filter definition in this file: identity-server-installation-root/SUNWam/web-apps/services/WEB-INF/web.xml

    4. 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.



Previous      Contents      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.