5
Administering Users

5.2.1 Listing Users and User Groups

To get a list of Users, click the Users tab in the Mobile Server Control Center and then select the Users radio button in the left panel. Enter your search criteria in the search field and click Go. As Figure 5-1 illustrates, a list of users that matches your search criteria, displaying their Display Names and User Names, appears in the right panel. Near the top of the page in the right panel, the "Number of Users found" is displayed.

You can determine how many users are shown per each display screen by setting the following parameter in webtogo.ora (anywhere in the WEBTOGO section):

ROWS_PER_PAGE_IN_ADMIN_TOOL

For example, to display the list of users on the screen in groups of 20 users per display page, you set this parameter to 20 as follows:

ROWS_PER_PAGE_IN_ADMIN_TOOL=20

The default value is 25. If you set this parameter to zero, the rows will appear on one long scrollable page, instead of being grouped on each display page.

From the list of users, you can easily delete one or more users. In the Delete column, select the checkboxes of the users you want to delete, then click the hyperlink Delete. This permanently deletes the selected users from the system.

To get a list of User Groups, click the Users tab and then select User Groups. Enter your search criteria in the search field and click Go. A list of user groups with a group name matching your search criteria appears in the right panel.

5.2.2 Creating a User

In the standalone mode, you can create new users for the Mobile Server. The information regarding the new users comes from the Users table in the Mobile Server Repository.

To create a user, click the Users tab and then click Create User in the left panel of the Mobile Server Control Center. As Figure 5-2 shows, the following fields appear in the right panel:

Field	Description	Required
Display Name	A distinguishable full name for the Mobile Server user.	X
User Name	The Mobile Server logon name that the user enters to begin the Mobile Server session.	X
Password	The password for the user. The password can only contain single-byte characters from the Oracle database character set (even when the character set contains multi-byte characters).	X
Password Confirm	The password for the user.	X
System Privilege	A drop-down list of available Mobile Server privileges for the user. You can choose only one of the following system privileges to assign to a user: User enables users to connect to the Mobile Server. Administrator enables users to modify Mobile Server resources. Organizer enables users to publish applications. None prevents users from having privileges.	X

Enter the required information and click Save. The Mobile Server Control Center displays the saved information including the user's sites. Since the newuser, at this point, does not have sites yet, the Mobile Server Control Center displays a message stating that no Web-to-Go sites were found.

5.2.3 Modifying or Dropping a User

To modify or to drop a user, click the Users tab. Select Users in the left panel. Enter your search criteria in the search field and click Go. A list of users appears in the right panel. Click the user you want to modify or drop. As Figure 5-3 shows, the user's information appears in the following fields:

Field	Description	Required
Display Name	A distinguishable full name for the Mobile Server user.	X
User Name	The Mobile Server logon name that the user enters to begin the Mobile Server session.	X
Password	The password for the user. The password can only contain single-byte characters from the Oracle database character set (even when the character set contains multi-byte characters).	X
Password Confirm	The password for the user.	X
System Privilege	A drop-down list of available Web-to-Go privileges for the user. You can choose only one of the following system privileges to assign to a user: User enables users to connect to the Mobile Server Administrator enables users to modify Mobile Server resources. Organizer enables users to publish applications. None prevents users from having privileges.	X
Forced Refresh	Marks a specific platform for the user for complete refresh. Designating a platform for forced complete refresh causes all of the user's data to completely refresh on the target platform the next time the user synchronizes. The Mobile Server administrator can designate forced complete refresh on all platforms or on a per-platform basis.

Modifying the User

To modify a user, change any of the preceding fields and then click Save. If you change the user's password, you must make the same change in the Password Confirm field.

Dropping the User

To drop a user from the Mobile Server, click Remove. Once you drop a user, the Mobile Server drops all references for the user to applications, snapshot template variables, and registry variables.

Viewing User Sites

To view user sites, click the Sites link in the left panel (see Figure 5-3). The Web-to-Go Sites screen appears, as illutrated in Figure 5-4, listing the sites by the host name and showing the time and date that the user site was created, the last refresh, and the last logon. Two links appear, one for Details and one for Delete, for each user site.

To see specific information about a user site, click the site name. Information regarding the selected user site appears as shown in Figure 5-5.

The screen displays the following information:

Topic	Definition
Host Name	The site host name. For example: host.domain
Operating System	The Mobile Client for Web-to-Go operating system, version, and architecture. For example: Windows NT 4.0 x86
Java Runtime Environment	The Java Runtime Environment (JRE). For example, 1.3.1.
Web-to-Go Version	The Web-to-Go version.

The right frame also displays the following user information:

Topic	Definition
User	The site user name.
Mode	The site's last mode. The last mode is either online or offline.
Created	The date and time that the site was created.
Last Refresh	The date and time that the site was last synchronized.
Last Logon	The date and time of the last time the user logged in.

Adding Users or Removing Them from a User Group

To add or remove a user from a user group by, click the Groups link in the left panel. The User Groups screen appears, as shown in Figure 5-6, listing all of the user groups that this particular user can belong to, including the user groups that this user already belongs to. Select the In Group? check box for each user group that you want to add this user to, or deselect the In Group? check box to remove this user from that user group..

5.2.4 Creating a Group

Creating groups enables you to control access to the Mobile Server applications for multiple users at the same time. To create a group, click the Users tab and then click Create User Group in the left frame of the Mobile Server Control Center. The following elements appear in the right frame:

Elements	Description	Required
Group Name	The name of the group.	X
The following displays for each user in the system:
User Name	The user name.
Display Name	The user's full name including the first and last name.
In Group?	When this check box is selected, the user is included in the group.

As Figure 5-7 illustrates, type the name of the new group in the Group Name field. Select the check box next to the user(s) you want to include in the group and click Save. To include all available users in the group, click Select All and then click Save.

5.2.5 Modifying or Dropping a Group

To modify or to drop a group, click the Users tab and then click User Groups in the left frame. Enter your search criteria in the search field and click Go. A list of groups appears in the right frame. Click the group you want to modify or drop. As Figure 5-8 shows, the group's information appears in the following fields:

Elements	Description	Required
Group Name	The name of the group.	X
The following displays for each user in the system:
User Name	The user's user name.
Display Name	The user's full name including the first and last name.
In Group?	When this check box is selected, the user is included in the group. When this check box is clear, the user is not included in the group.

Adding Users to Groups

To add users to the group, select the In Group check box next to the user(s) you want to add and then click Save.

Dropping Users From Groups

To drop users from the group, remove the selection from the In Group check box next to the user(s) you want to drop. Click Save.

Dropping Groups

To drop a group from Web-to-Go, click Remove. Once you drop a group, the Web-to-Go server drops all the group's references to applications.

5.3.1 Listing and Creating Users and User Groups

To get a list of Users in the Oracle9iAS mode, see Section 5.2.1, "Listing Users and User Groups".

As Figure 5-9 illustrates, there are three main characteristics that differentiate the Oracle9iAS mode from the standalone mode in terms of the actions that you can perform.

In the Oracle9iAS mode:

• You cannot create users through the Mobile Server Control Center. The Create User link is disabled. To create users in the Oracle9iAS mode, use the tools provided by Oracle9iAS.

• You cannot delete users through the Mobile Server Control Center.

• You can mobile enable users to use mobile applications through the Mobile Server Control Center from the panel that lists the users. Select the Mobile Enable? checkbox and click Save for each user you want to mobile enable to use mobile applications.

5.3.2 Modifying or Dropping a User

In the Oracle9iAS mode, you can only modify a user's System Privilege or drop a user from the Mobile Server. To modify a user's Display Name or User Name when you are running the Mobile Server as a component of Oracle9iAS, you can do so only from within Oracle9iAS.

To modify a user's System privilege or drop a user from the, click the Users tab. Select Users in the left panel. Enter your search criteria in the search field and click Go. A list of users appears in the right panel. Click the user you want to modify or drop. As Figure 5-10 shows, the user's information appears in the following fields:

Field	Description	Required
Display Name	A distinguishable full name for the Mobile Server user. This field is not editable in the Oracle9iAS mode.	X
User Name	The Mobile Server logon name that the user enters to begin the Mobile Server session. This field is not editable in the Oracle9iAS mode.	X
System Privilege	A drop-down list of available Web-to-Go privileges for the user. You can choose only one of the following system privileges to assign to a user: User enables users to connect to the Mobile Server Administrator enables users to modify Mobile Server resources. Organizer enables users to publish applications. None prevents users from having privileges.	X
Forced Refresh	Marks a specific platform for the user for complete refresh. Designating a platform for forced complete refresh causes all of the user's data to completely refresh on the target platform the next time the user synchronizes. The Mobile Server administrator can designate forced complete refresh on all platforms or on a per-platform basis.

Modifying the System Privilege for a User

To modify the System Privilege for a user, make your selection from the dropdown menu, then click Save.

Dropping the User from the Mobile Server

To drop a user from the Mobile Server, click Remove. Once you drop a user, the Mobile Server drops all references for the user to applications, snapshot template variables, and registry variables.

Viewing User Sites

Viewing user sites in the Oracle9iAS mode is the same as in the standalone mode. See "Viewing User Sites" in Section 5.2.3, "Modifying or Dropping a User" for the detailed information.

Adding Users or Removing Them from a User Group

Adding users or removing them from a user group in the Oracle9iAS mode is the same as in the standalone mode. See Section 5.2.3, "Modifying or Dropping a User" for the detailed information.

5.3.3 Creating a Group

Creating groups in the Oracle9iAS mode is the same as in the standalone mode. See Section 5.2.4, "Creating a Group" for the detailed information.

5.3.4 Modifying or Dropping a Group

Modifying or dropping a group in the Oracle9iAS mode is the same as in the standalone mode. See Section 5.2.5, "Modifying or Dropping a Group" for the detailed information.