This guide explains how to manage the administration functions of Sun JavaTM System Portal Server Mobile Access 7.1 (formerly known as Sun™ ONE Portal Server, Mobile Access) software. This chapter includes the following sections:
You should review this book if you are Portal Server administrator or system administrator responsible for managing Mobile Access software at your site.
Identify the audience. Use this text to promote the features of the document that are particularly useful to the target audience. If other books cover similar information for a different audience, direct the reader to those books. For example, if this document is targeted for entry-level users, indicate the books that developers might want to read for more in-depth information. The audience description might include the following information:
Required knowledge, such as a specific programming language
Required experience or familiarity with the Solaris operating environment or a hardware platform
Definition of the type of user or functional responsibility, such as applications programmer, system administrator, or field engineer
Terms that relate to the tasks the user might perform
Example:
This Sun Java System Portal Server Mobile Access 7.1 Administration Guide is intended for use by administrators and software developers who implement an integrated identity management and web access platform using Sun Java System servers and software.
Portal Server Mobile Access administrators and software developers should already understand the following technologies:
Lightweight Directory Access Protocol (LDAP)
Java technology
JavaServer Pages™ (JSP™) technology
Hypertext Transfer Protocol (HTTP)
Hypertext Markup Language (HTML)
Extensible Markup Language (XML)
Before you administer Mobile Access, you must be familiar with the following concepts:
Basic SolarisTM administration procedures
Basic UNIX® administration procedures
LDAP (lightweight directory access protocol)
Markup languages used to create portal content appropriate for mobile and voice environments, such as HTML, cHTML, and VoiceXML
SolarisTM 8 Operating System (SPARC® Platform Edition) or Solaris 9 Operating System (SPARC Platform Edition) or Solaris Operating System (x86 Platform Edition)
Sun JavaTM System Directory Server (formerly Sun ONE Directory Server)
Sun JavaTM System Access Manager (formerly Sun ONE Identity Server, and Sun Java System Identity Server)
Sun JavaTM System Portal Server 7
Sun JavaTM System Portal Server Secure Remote Access 7
Depending on the Web container that you are using, you should be familiar with one or more of the following:
Sun JavaTM System Web Server (formerly Sun ONE Web Server)
Sun JavaTM System Application Server
BEA WebLogic ServerTM 8.1 SP2/SP4
IBM WebSphere® 5.1
If the reader must be familiar with other books before reading this book, list those books here.
Example:
Portal Server Mobile Access is a component of Sun Java Enterprise System, a software infrastructure that supports enterprise applications distributed across a network or Internet environment. You should be familiar with the documentation provided with Sun Java Enterprise System, which can be accessed online at http://docs.sun.com/coll/entsys_04q4.
Because Sun Java System Directory Server is used as the data store in an Portal Server Mobile Access deployment, you should be familiar with the documentation provided with that product. Directory Server documentation can be accessed online at http://www.docs.sun.com.
This book contains the following chapters and appendixes:
Chapter 1, Overview describes the key features of the Mobile Access software, as well as Mobile Access functions and Portal Server desktop, the primary end user interface.
Chapter 2, Managing Mobile Devices provides information about identifying and managing mobile devices, managing the client database, and using Sun Java System Access Manager client detection interface to manage client type data.
Chapter 3, Configuring Mobile Authentication describes authentication modules that can be useful to portal sites offering mobile access.
Chapter 4, Managing the Mobile Portal Desktop provides an overview of the wireless desktop dispatcher and the mobile Portal desktop properties.
Chapter 5, Configuring Mobile Applications provides an overview on how you can manage the application preferences
Chapter 6, Configuring Voice Access explains Mobile Access software’s support for voice access to portal sites.
A glossary and an index are also provided.
Check that the meaning of the symbols in the following table are accurate for your product or platform. For more information, see “Documenting Multiple Keystrokes” in Chapter 2 of the Sun Editorial Style Guide.
Example
Table P–1 Default Paths and File Names
Term |
Description |
---|---|
IdentityServer-base |
Represents the base installation directory for Identity Server. The Identity Server 2004Q2 default base installation and product directory depends on your specific platform: Solaris systems: /opt/SUNWam |
DirectoryServer-base |
Represents the base installation directory for Sun Java System Directory Server. Refer to the product documentation for the specific path name. |
ApplicationServer-base |
Represents the base installation directory for Sun Java System Application Server. Refer to the product documentation for the specific path name. |
WebServer-base |
Represents the base installation directory for Sun Java System Web Server. Refer to the product documentation for the specific path name. |
The guide uses typographical conventions to represent types of information presented.
Monospaced font is 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.
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 Java™ System 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, ./pssetup is what you would type from the command line. The rest is what would appear as a result.
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 [] are used to enclose optional parameters. For example, in Portal Server software documentation, you will see the usage for the dpadmin command 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 dpadmin command.
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.
List titles of Sun product documentation that are related to the content of this book. Also list related third-party book titles (with author and publisher) which are mentioned in the text or that readers might find useful.
The http://docs.sun.comSM web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject.
The following table summarizes the books included in the Portal Server Mobile Access core documentation set.
Book Title |
Description |
---|---|
Sun Java System Portal Server Mobile Access Deployment Planning Guide |
Describes how to plan for and deploy Sun Java System Portal Server Mobile Access software. |
Sun Java System Portal Server Mobile Access Administration Guide |
Describes how to administer Sun Java System Portal Server Mobile Access 7 using the administration console and the command line. |
Sun Java System Portal Server Release Notes |
Available after the product is released. Contains last-minute information, including a description of what is new in this current release, known problems and limitations, installation notes, and how to report issues with the software or the documentation. |
Sun Java System Portal Server Mobile Access Developer’s Guide |
Describes a developers perspective of the mobile access software. It also provides information about three mobile applications that is shipped with the software: Calendar, Address Book, and Mail, all of which can be fully customized by developers. |
Sun Java System Portal Server Mobile Access Developer’s Reference Guide |
Provides reference to developers on how they can customize the three mobile application that is shipped along with the software: Calendar, Address Book, and Mail. |
Sun Java System Portal Server Mobile Access Tag Reference Library |
Provides detailed information on the Sun Java System Portal Server Mobile Access tag libraries (in the software). |
The following table summarizes the books included in the Portal Server Mobile Access core application documentation set.
Table P–2 Books in This Documentation Set
Book Title |
Description |
---|---|
Identity Server Technical Overview http://www.docs.sun.com |
Provides a high-level overview of how Identity Server components work together to consolidate identity management and to protect enterprise assets and web-based applications. Explains basic Identity Server concepts and terminology. |
Identity Server Administration Guide http://www.docs.sun.com |
Describes how to use the Portal Server Mobile Access console as well as manage user and service data via the command line. |
Identity Server Developer’s Guidehttp://www.docs.sun.com |
Offers information on how to customize Identity Server and integrate its functionality into an organization’s current technical infrastructure. Contains details about the programmatic aspects of the product and its API. |
Identity Server Release Noteshttp://www.docs.sun.com |
Available after the product is released. Contains last-minute information, including a description of what is new in this current release, known problems and limitations, installation notes, and how to report issues with the software or the documentation. |
Other Portal Server books include:
Sun Java System Portal Server 7.1 Deployment Planning Guide
Sun Java System Portal Server 7.1 Developer’s Guide
Sun Java System Portal Server 7.1 Administration Guide
Sun Java System Portal Server 7.1 Secure Remote Access Administration Guide
Sun Java System Portal Server 7.1 Technical Reference Guide
Sun Java System Portal Server 7.1 Installation Guide
Sun Java System Portal Server 7.1 Command Line Reference
Use the following URL to view all the Sun Java System Portal Server 7.1 documentation:
Directory Server documentation http://www.docs.sun.com
Web Server documentation http://www.docs.sun.com
Application Server documentation http://www.docs.sun.com
Web Proxy Server documentation http://www.docs.sun.com
For product downloads, professional services, patches and support, and additional developer information, go to the following:
Download Center http://httP://www.sun.com
Professional Services http://www.sun.com
Sun Enterprise Services, Solaris Patches, and Support http://sunsolve.sun.com/
Developer Information http://developers.sun.com
Download Center http://www.sun.com
Professional Services http://www.sun.com
Sun Enterprise Services, Solaris Patches, and Support http://sunsolve.sun.com
Developer Information http://developers.sun.com
If you have technical questions about this product that are not answered in the product documentation, go to http://www.sun.com.
Include related third-party URLs in this section.
Keep this section in your preface even if your book does not contain third-party URLs at this time. This section is required in all prefaces and contains exact wording that comes from Sun Legal.
Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.
Sun is interested in improving its documentation and welcomes your comments and suggestions.
To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the document title and part number. The part number of this guide is 820-1051 and can be found on the title page of this book or at the top of the document. For example, the title of this book is Sun Java System Portal Server Mobile Access 7.1 Administration Guide, and the part number is 820-1051.