7
Administering the Mobile Server

This document provides information on how to administer the Mobile Server. It includes a discussion of the following topics:

7.1 Viewing System Status Reports for the Server

You use the Mobile Server Control Center to view system status reports for the server. To perform this task, click the Server tab and then click Status Summary in the left frame. The Mobile Server Control Center displays the following reports:

System

The system report generates the following information:

Topic	Definition
Web-to-Go Version	The Web-to-Go version.
Time started	The time Web-to-Go is started.
Available Memory	The available memory on the server.
Operating System	The server operating system. For example: Windows NT 40 X86
Java Runtime Environment	The version of the Java Runtime Environment (JRE). For example: 1.3.1.

Server Configuration

The Server Configuration report generates the following information:

Topic	Definition
Configuration	The type of Web-to-Go server. Options include: Oracle9iAS Standalone
Running Mode	The server's current running mode. Options include: Suspended The Mobile Server is suspended and can only be accessed by users with administrative privileges. Normal The Mobile Server can be accessed by all users.
Session Expiration	The session expiration time.
Applet-JDBC Connections	The applet-JDBC connections through the Mobile Server.

Repository

The Repository report generates the following information:

Topic	Definition
Database URL	The Mobile Server Repository database URL. For example: `jdbc:oracle:oci8:@webtogo.world`
Database Net8 Service	The Mobile Server Repository database Net8 service. For example: webtogo.world
Owner	The Mobile Server Repository database owner. For example: MOBILEADMIN

7.2 Suspending the Server

You can use the Mobile Server Control Center to suspend the Mobile Server for maintenance purposes. When you suspend the Mobile Server, the Mobile Server terminates all currently active sessions on the server and restricts access only to users with administrative privileges. As the following Figure 7-1 shows, click the Server tab and then click Access Control in the left frame to perform this task:

Figure 7-1 Suspending the Server

Description of trace1.gif is contained in the surrounding text

Then click the Maintenance button to suspend the server.

Note:

The server automatically switches to Normal mode when the administrator logs off.

The following warning dialog appears:

Figure 7-2 Warning Dialog when Suspending the Server

Description of adm_cc26.gif is contained in the surrounding text

Click OK. A confirmation dialog appears.

The server is now running in maintenance mode and the right frame displays "Maintenance" as the system's current mode.

7.3 Resuming the Server

You can use the Mobile Server Control Center to resume Mobile Server operations after the server is suspended for maintenance purposes. To perform this task, click the Server tab and then click Access Control in the left frame. The server runs in maintenance mode and the right frame displays "Maintenance" as the system's current mode. Click the Normal button. The following warning dialog appears:

Figure 7-3 Warning Dialog for Resuming the Server

Description of adm_cc28.gif is contained in the surrounding text

Click OK. A dialog appears confirming that the server is now running in Normal mode.

Click OK. The server is now running in normal mode and the right frame displays Normal as the system's current mode.

7.4 Viewing Active User Sessions

The Mobile Server Control Center enables administrators to track all users connected to the Mobile Server at any given time.

To view a report on Active Mobile Server sessions, click Sessions in the left frame. The report that appears in the right frame includes the following information:

Label	Description
User	The name of the Mobile user.
Created	The time and date the session was created.
Last Refresh	The last time this session was accessed.

7.5 Uploading the SSL Server Certificate to the Mobile Server Repository

Using the Mobile Server Control Center, you can upload the copy of the server certificate public key from the certification authority (CA) to the Mobile Server Repository. The Mobile Server Repository stores the public key file in encrypted form. After the Mobile Server uploads the public key to the Mobile Server Repository, the next installation of the Mobile Client for Web-to-Go installs the encrypted key on the Mobile Client for Web-to-Go. This key is used for SSL handshaking with the Mobile Server.

To upload a public key to the Mobile Server Repository, select Server Certificate in the left frame. From the right frame, use the Browse button to select the certificate from the Certification Authority (CA). Upload the certificate file into the Mobile Server Repository using the Windows File Upload window.

7.6 Starting The Message Generator and Processor (MGP)

You can use the Mobile Server Control Center to start MGP after it has been stopped for maintenance purposes. To perform this task, click the Server tab and then click MGP Control in the left frame. Click the Start button. The right frame displays "Starting MGP" as the current mode and the Status button replaces the Start MGP button.

For a description of MGP, see Section 10.4, "The Message Generator and Processor (MGP)" in Chapter 10, " Administering Replication".

7.7 Stopping MGP

You can use the Mobile Server Control Center to stop MGP for maintenance purposes. To perform this task, click the server tab and then click MGP Control in the left frame. The right frame displays "Starting MGP," indicating that the MGP has been activated.

Click the Status button. The right frame displays "Stopped" as the MGP's current mode and the Start button replaces the Status button.

7.8 Using Server Trace and MGP Trace

For information on how to use server trace and MGP trace, see Chapter 11, "Tracing".

7 Administering the Mobile Server