test

Sun Java System Portal Server 7.2 Administration Guide

Managing Mobile Devices

Sun Java System Portal Server Mobile Access 7.2 software uses Sun Java System Access Manager client detection module to identify and manage the various clients, or mobile devices, that portal site users employ to access a portal site.

This section provides information on the following topics:

Understanding Client Detection

Client detection determines the capabilities and characteristics of each mobile device that is used to access the portal site. To do this, it uses the composite capability and preference profiles (CC/PP) specification, UAProf, or preconfigured data. Mobile Access software requires that three properties be defined for every client. They are:

Mobile Access software also uses conditional properties to store and retrieve specific property values for client types. One example is the desktopContainer conditional property. The wireless desktop dispatcher reads this property to determine what the desktop container is for the requested client type.

Mobile Access software imports client type data from the file /var/opt/SUNWam/config/ldif/sunAMClient_data.ldif into the LDAP directory and uses Access Manager software APIs to identify clientType property matches. Matches are determined in the following order:

  1. An exactmatch

  2. A partialmatch

  3. A keywordmatch

You can also dynamically apply UAProf profile against your base profile. Users need to retain FEDIClientDetector and do one of the following:

Note –

To configure the proxy server to selectively access the public internet:

The JVM provides an option to specify proxy server details for an external connection from the web container using an external proxy. The JVM also allows you to specify the hosts that should not use the specified proxy. You can configure the Mobile Access system JVM to use a proxy server to access the public Internet.

Use the following JVM options in the web container:

Dhttp.proxyHost=your-proxy-server-host

Dhttp.proxyPort=your-proxy-server-port

Use the following option for bypassing proxy server for certain domains and hosts: Dhttp.nonProxyHosts="*.domain-name|hostname|localhost"

Using the Client Manager

The Access Manager administration console provides a Client Manager that enables you to manage properties for mobile devices.

This section explains the following types of information that the Client Manager provides about client types:

This section also explains how to create and customize the client type:

Markup Languages

Mobile Access software supports these markup languages used by mobile client browsers:

Styles

A Style is a set of properties for an associated group of devices for a markup language. For example, a Nokia Style is applied to all WML devices manufactured by Nokia.

At least one Style exists for each markup language. Some markup languages have multiple styles.

You cannot override Style properties. If you use an existing client as a template for a new devices when you create it, the new client inherits the existing client's Style properties.

Device Information

Device information is device-specific client type data that you can update.

When you change the device information for a default client type, you create a new and separate version of the default client type. This custom information is stored in the external library, while the default device information remains in the internal library. Two asterisks are added to the client type name of each custom device to differentiate it from devices in the internal library.

Filter Option

The Filter option is a search field that enables you to find and list groups of specific client types assigned to a specific Style.

Client Editor

The Client Editor enables you to create and customize a client type, and to manage client properties.

The Client Editor organizes properties in the following groups:

ProcedureTo Launch the Client Manager

  1. Log in to the Access Manager administration console as the administrator. By default, Identity Management is selected in the Header frame (the top horizontal frame) and Organizations is selected in the Navigation frame (the left vertical frame).

  2. Click the Service Configuration tab.

  3. From the Service Configuration frame on the left, under the Access Manager Configuration heading, click the arrow for Client Detection. The Client Detection global preferences appear in the Data frame on the right.

  4. Click the Edit link following the Client Types label. The Client Manager interface appears. Details about HTML devices are displayed by default.

ProcedureTo View Style Properties

  1. Log in to the Access Manager administration console as the administrator. By default, Identity Management is selected in the Header frame (the top horizontal frame) and Organizations is selected in the Navigation frame (the left vertical frame). 2. 3. 4.5 6. 7. 8.

  2. Click the Service Configuration tab.

  3. From the Service Configuration frame on the left, under the Access Manager Configuration heading, click the arrow for Client Detection. The Client Detection global preferences appear in the Data frame on the right.

  4. Click the Edit link following the Client Types label. The Client Manager interface appears. Details about HTML devices are displayed by default.

  5. .From the tabs at the top, click the markup language for the device whose properties you want to examine (for example, WML). If client types using the markup language you selected are in the database, they appear in alphabetical order.

  6. From the Style pull-down menu, pick the style that you want (for example, Nokia). The list of client types already in the database appears for the selected style.

  7. Click the Current style properties link. The Edit style page appears. The Styles for General properties are displayed by default.

  8. From the Properties pull-down menu, click the properties type that you want to view (for example: Software Platform).

    Note –

    Properties type choices include General, Hardware Platform, Software Platform, Network Characteristics, BrowserUA, WapCharacteristics, PushCharacteristicsNames, and Additional Properties.

  9. To return to the Client Manager page, click Cancel.

Managing Client Type Data

You use the Client Manager in the administration console to manage client type data.

You can change client type properties, create new client types to accommodate new devices, set up client types with names and other properties that are customized for your site, and remove custom client types.

If you choose to create a new device based on an existing device, a process called inheriting, you must base the new device on either the styles or the properties of the existing device. Examine your new device and the existing device to decide which option—styles or properties—is preferable. Both choices require you to customize device definitions.

Note –

The client type database consists of internal and external libraries. When you change or add to default client type information in the internal library, your updates are stored in the external library. Two asterisks added to the client type name indicate that it is a customized client type.

This section provides instructions for completing the following tasks:

ProcedureTo Edit Client Types

  1. Log in to the Access Manager administration console as the administrator. By default, Identity Management is selected in the Header frame (the top horizontal frame) and Organizations is selected in the Navigation frame (the left vertical frame).

  2. Click the Service Configuration tab.

  3. From the Service Configuration frame on the left, under the Access Manager Configuration heading, click the arrow for Client Detection. The Client Detection global preferences appear appear in the Data frame on the right.

  4. Click the Edit link following the Client Types label. The Client Manager interface appears. Details about HTML devices are displayed by default.

  5. From the tabs at the top, click the markup language for the device you want to edit (for example, WML). If client types using the markup language you selected are in the database, they appear in alphabetical order.

  6. From the Style pull-down menu, pick the Style that you want (for example, Nokia). The list of client types already in the database appears for the selected style.

  7. From the Client Type list, scroll down to find the client that you want to edit (for example, Nokia6310i_1.0).

    Clients are listed in alphabetical order.

  8. To go directly to a specific client type, or to a group of client types, use the Filter option. In the Filter text box, type in the first character or first few characters of the client type you want to view and then click the Filter button. (For example: To find client types that start with the letter S, type in S*.)

  9. To go to specific pages, scroll to the bottom and use the arrows or the Go option.

  10. Click the Edit link in the Actions column for the client that you want to edit. The Edit client-type page is displayed. The General properties are displayed by default.

  11. From the Properties pull-down menu, select the type of properties you want to change (for example, Software Platform).

  12. Change or add values for each property you want to alter.

    Tip –

    To clear your changes and start over, click Reset. To return to the display of client types without making any changes, click Cancel.

  13. Click Save to make these changes.

    If you do not click Save, your changes are not made. You must change one property type at a time and save those changes before you change another property type.

    The properties for this device are now changed, and the list of client types for this style appears.

  14. To verify that its properties are changed, find your client type in the Client Type list. Two asterisks added to the client type name indicate that you have customized this client type.

    Note –

    Whenever you change a default client type, a Default link is added to the Actions column. The Default link points to the internal library.

    To remove your changes and reset the client type's properties to their default values, click this link. A prompt asking whether you want to complete this action is not provided.

ProcedureTo Create a New Device by Inheriting Styles

  1. Log in to the Access Manager administration console as the administrator. By default, Identity Management is selected in the Header frame (the top horizontal frame) and Organizations is selected in the Navigation frame (the left vertical frame).

  2. Click the Service Configuration tab.

  3. From the Service Configuration frame on the left, under the Access Manager Configuration heading, click the arrow for Client Detection. The Client Detection global preferences appear in the Data frame on the right.

  4. Click the Edit link following the Client Types label. The Client Manager interface appears. Details about HTML devices are displayed by default.

  5. From the tabs at the top, click the markup language for the device you want to set up (for example, WML). If client types using the markup language you selected are in the database, they appear in alphabetical order.

  6. From the Style pull-down menu, pick the Style that you want (for example, Nokia). The list of client types already in the database appears for the selected style.

  7. Click the New Device button to display the Create New Device page.

  8. Type in the Device User Agent value.

  9. Click Next. The Device User Agent value you provided appears in the Client TypeName and The HTTP user-agent string fields.

    If appropriate, change these values.

  10. Click OK to save these properties. Your new device is now defined, and the Edit Style page appears. Displayed here are default properties inherited from the parent Style you assigned.

  11. From the Properties pull-down menu, select the properties type that youwant to modify (for example: Software Platform).

    Note –

    Properties type choices includeGeneral,Hardware Platform, Software Platform, Network Characteristics, BrowserUA, WapCharacteristics, PushCharacteristicsNames, and Additional Properties.

  12. Click Save to save your changes to these values.

    Tip –

    To clear your changes and start over, click Reset. To return to the display of client types without making any changes, click Cancel.

  13. Search the Client Type list to verify that your client type is available. Two asterisks added to the client type name indicate that you have customized this client type.

    Note –

    Whenever you add a new client type, a Delete link is added to the Actions column. The Delete link points to the external library.

  14. To remove your new client type, click this link. A prompt asking whether you want to complete this action is not provided.

ProcedureTo Create a New Device by Inheriting Properties

  1. Log in to the Access Manager administration console as the administrator. By default, Identity Management is selected in the Header frame and Organizations is selected in the Navigation frame.

  2. Click the Service Configuration tab.

  3. From the Service Configuration frame on the left, under the Access Manager Configuration heading, click the arrow for Client Detection. The Client Detection global preferences appear in the Data frame on the right.

  4. Click the Edit link following the Client Types label. The Client Manager interface appears. Details about HTML devices are displayed by default.

  5. From the tabs at the top, click the markup language for the device you want to copy (for example, WML). If client types using the markup language you selected are in the database, they appear in alphabetical order.

  6. From the Style pull-down menu, pick the default Style that you want (for example, Nokia). The list of client types already in the database appears for the selected style.

  7. From the Client Type list, scroll down to find the specific client that you want to use as a template for a new client type (for example, Nokia6310i_1.0).

    Tip –

    Clients are listed in alphabetical order.

  8. To go directly to a specific client type, or to a group of client types, use the Filter option. In the Filter text box, type in the first character or first few characters of the client type you want to view and then click the Filter button. (For example: To find a client type that starts with the letter S, type in S*.)

  9. To go directly to specific pages, scroll to the bottom and use the arrows or the Go option.

  10. Click the Duplicate link in the Actions column for the client type that you want to use as a template for a new client type. The Duplicate Device page is displayed. The Client Type and Device User Agent properties for the device you are copying are displayed, with the prefix Copy_of_ added to its name. (For example, Copy_of_Nokia6310i_1.0)

  11. If appropriate, type in new names for these properties.

  12. Click Duplicate to make these changes. The Edit client-type page is displayed. The General properties are displayed by default. The values for all properties views available here are inherited from the client type that you used as the master for this new client type.

    Tip –

    To return to the display of client types without making any changes, click Cancel. From the Properties pull-down menu, select which type of properties you want to change (for example, Software Platform).

  13. Change or add values for each property you want to alter.

    Tip –

    To clear your values and start over, click Reset. To return to the display of client types without making any changes, click Cancel.

  14. Click Save to make these changes.

    Note –

    If you do not click Save, your changes are not made. You must change one property type at a time and save those changes before you change another property type. The properties for this device are now changed, and the list of client types for this style appears.

  15. Search the Client Type list to verify that your client type duplicate is available. Two asterisks added to the client type name indicate that you have customized this client type. (For example, Copy_of_Nokia6310i_1.0 **)

    Note –

    Whenever you add a new client type, a Delete link is added to the Actions column. The Delete link points to the external library.

  16. To remove your new client type, click this link. A prompt asking whether you want to complete this action is not provided.

ProcedureTo Remove a Custom Device

If you set up a custom device incorrectly and do not want to modify it, you can use these steps to remove it entirely.

  1. Log in to the Access Manager administration console as the administrator. By default, Identity Management is selected in the Header frame (the top horizontal frame) and Organizations is selected in the Navigation frame (the left vertical frame).

  2. Click the Service Configuration tab.

  3. From the Service Configuration frame on the left, under the Access Manager Configuration heading, click the arrow for Client Detection. The Client Detection global preferences appear in the Data frame on the right.

  4. Click the Edit link following the Client Types label. The Client Manager interface appears. Details about HTML devices are displayed by default.

  5. From the tabs at the top, click the markup language for the device you want to delete (for example, WML). If client types using the markup language you selected are in the database, they appear in alphabetical order.

  6. From the Style pull-down menu, pick the Style that you want (for example, Nokia). The list of client types already in the database appears for the selected style.

  7. From the Client Type list, scroll down to find the customized client that you want to remove (for example, Copy_of_Nokia6310i_1.0).

    Tip –

    Clients are listed in alphabetical order

  8. To go directly to a specific client type, or to a group of client types, use the Filter option. In the Filter text box, type in the first character or first few characters of the client type you want to view and then click the Filter button. (For example: To find a client type that starts with the letter S, type in S*.)

  9. To go directly to specific pages, scroll to the bottom and use the arrows or the Go option.

  10. In the Actions column for the customized client that you want to remove, click the Delete link. The revised list of client types for this style is displayed.

  11. Search the Client Type list to verify that your client type is no longer available.

ProcedureTo Identify Selected Client Types for a Portal User From the Portal Server Console

  1. Log in to Portal Server administration console as the administrator. By default, the Common Tasks tab is selected and the Common Administrative Tasks page is displayed.

  2. Click the Portals tab. The Portals page is displayed. The available portals are displayed in the Portals table.

  3. Click on the name of the portal, which you want to manage. The Desktop Tasks and Attributes page is displayed. This page lists the Portal Server desktop tasks and attributes that you can edit.

  4. From the SelectDNoptions, choose the username (User) DN. If the username (User)DNoption is not available, you need to add this DN to the SelectDNlist. Follow the steps to add the username (User)DN.

    1. Click the Add DNs button. The Add to DNs list window appears.

    2. From the Search for options, choose the User option.

    3. Type the user name in the text box after the User option.

    4. Click Search. If the user name is available, it will be displayed in the Found table.

    5. Select the check box preceding to the user name you want to add and click Add The username (User)DN is added to the SelectDNoptions.

  5. From the list of Tasks, click the Manage Containers & Channels. The Manage Containers & Channels: Portal name page is displayed. The left frame in this page displays the available View Types and the right frame displays the properties of the selected View Type.

  6. From the ViewType options, choose the WirelessDesktopDispatcher option. The WirelessDesktopDispatcher Tasks and Properties are displayed in the right frame.

  7. In the Properties table, select the check box preceding to the selectedClients property.

  8. Click the Table Preferences button if you need to change the client type and locale settings. Client type settings are necessary to set a client type for the portal, and the locale settings are necessary to set the language attributes.

    The Table Preferences box appears at the top of the Properties table.

  9. In the Client Type and Locale fields, type the appropriate client type and locale information.

  10. Click OK.

  11. Click Save.

    The client type is added in the Value column.