When using the Sametime Mobile Proxy, mobile users can access and exchange instant messages securely (128-bit encryption) with other users that also are using Lotus Sametime clients such as mobile devices, desktop clients, and other Lotus Sametime Clients on other platforms.

The Lotus Sametime Mobile Proxy application is a Java-based application that is installed either on a Sametime 3.0, or 3.1 server, or another Microsoft Windows based server. The Lotus Sametime Mobile Proxy application accesses a light weight Sametime Mobile protocol via the device's web browser. In order for the Sametime Mobile Proxy to to function on mobile devices, the STMux server component must be installed. STMux creates a pipe that is capable of routing Sametime messages for Java enabled browsers on WEA supported devices.

STMux must be deployed with the Lotus Sametime Mobile Proxy either on an existing Sametime server, or another server. By default this component is installed during your Lotus Sametime 3.0, or 3.1 Server installation.

NOTE: The Lotus Sametime Mobile Client is not accessible from a WAP enabled device.

1. Sametime server 3.0 or 3.1
2. Java Runtime Environment (JRE) 1.3 or later
3. Microsoft Windows 2000/XP

Prior to installation you should:

1. Ensure your user id has full administrative rights to perform the Lotus Sametime Everyplace installation. Otherwise the installation will not correctly deploy all the necessary files.
2. Ensure that your user id is listed as a registered user in the Sametime server's directory.
3. Be able to provide the Domino server name and password for the server on which Sametime Everyplace will be installed.
4. Ensure your user id has Designer, or Manager access to the Lotus Domino server on which the Lotus Sametime Mobile Proxy for IBM Everyplace Access is to be installed.
5. If you are installing components on a server other than the Sametime server, you must use the IP address of the server, or servers on which you are installing the Lotus Sametime Mobile Proxy components for IBM Everyplace Access.
6. Become familiar with the mobile devices used by your organization.
7. Become familiar with Lotus Notes and Lotus Domino documents and concepts specifically focusing on domains and foreign domains.

NOTE: If you are unfamiliar with Lotus Notes and Lotus Domino document concepts, refer to your Lotus Notes and Lotus Domino documentation.

1. Run SETUP.EXE from the STMobile directory and follow the onscreen instructions offered in the installation wizard. The wizard detects whether you are installing STMobile on a Sametime server or on a separate server.
2. The setup wizard suggests an installation folder by default. To install the Lotus Sametime Mobile Proxy in a separate server, you must provide the fully qualified host name or IP address of the Sametime server.

Note: After Installation in a Microsoft Windows Server environment, the STLaunch and STMobileSA services will be loaded as Microsoft Windows Services. To start the services please access the Microsoft Windows Services gui available via the Administrative Tools menu to start, stop, configure the way the application starts

1. Complete the above installation steps on the machine that the STMobile Proxy is to be installed on
2. On the Sametime server, open the Sametime Configuration database (stconfig.nsf).
3. Open the CommunityConnectivity document.
4. Add the IP address of the seperate server in the Community Trusted IPs field. Separate mulitple IP addresses with commas (,) or semicolons (;)
5. Run SETUP.EXE from the STMobile directory and follow the onscreen instructions offered in the installation wizard. The wizard detects whether you are installing STMobile on a Sametime server or on a separate server.
6. The setup wizard suggests an installation folder by default. To install the Lotus Sametime Mobile Proxy to a separate server, you must provide the fully qualified host name or IP address of the Sametime server.

Note: The Sametime Mobile Proxy must connect using a direct socket connection to the Sametime server on port 1516. This is a static port dedicated to Sametime server client applications to connect to.

1. Open the trace file STMOBILE.LOG
2. Locate the started message noting the message's time stamp.

1. Locate your sametime.ini file
2. Locate the [StMobile] section
3. Required settings will all have a default value assigned. You can edit default values, add new values or new settings.
4. Save sametime.ini
5. Stop your STMobile service
6. Restart your STMobile service to use the new settings or values

1. In the [STMobile] section of the SAMETIME.INI file, the setting STMOBILE_ACL_GROUP contains the default group SametimeMobileUsers.
2. Change this group name to the name of the group that you created in the Domino Directory that lists the names of mobile users who have Java-enabled devices.
3. After STMobile successfully logs into the server, STMobile will retrieve the mobile users listed in the mobile users group. When each client tries to log in, STMobile resolves the user's name by searching the allowed list for the user ID. If the user exists, STMobile performs the log-in request. Otherwise, STMobile sends a LoggedOut event message to the client.

Note: If the directory does not contain the group name or if it contains more than one group with the same name, STMobile allows all users in the directory to log in. You can remove the setting STMOBILE_ACL_GROUP from the sametime.ini file, or you can leave the default setting in the sametime.ini file allowing STMobile to function without ACL support.

The following default settings and values are added to the STMobile section of the SAMETIME.INI file. To customize your STMobile environment, edit the default settings and values.

Lotus Domino Server 6.5.1 is not supported with this version of the Sametime Mobile Proxy. The steps outline here are to assist you in configuring Sametime Mobile Proxy with Domino 6.5.1 if you wish to test this unsupported configuration.

To install the Lotus Sametime Mobile Proxy when running Lotus Domino Server 6.5.1 for your own testing purposes you are required to perform the following steps.

1. Stop the Domino server
2. From your Microsoft Windows machine, click the START menu
3. Click on RUN from the Start menu
4. Into the prompt enter "regedit" and click "OK". NOTE, Editing the registry incorrectly can prevent the proper operation of your operating system and applications. Only experienced administrators should use this application.
5. Locate the KEY NAME "HKEY_LOCAL_MACHINE\SOFTWARE\Lotus\Sametime"
6. Below this key name you will find a key named "6.5.1"
7. Rename this key to 6.5.1.OLD
8. In the same location of the REGISTRY create a new key called 3.1. The default values are fine.
9. Install the Lotus Sametime Mobile Proxy
10. When Lotus Sametime Mobile Proxy is installed. Rename the key in step 6 back to 6.5.1
11. Delete the key that you created for step 7 named 3.1 from the registry
12. Save the REGISTRY and EXIT
13. Restart your Lotus Domino server and Sametime Mobile Proxy services

More Information: Because Lotus Domino 6.5.1 was not generally available when this version of the Lotus Sametime Mobile Proxy was released, Lotus Domino 6.5.1 is not supported, not tested and may cause issues not known at the time this readme was written. The Lotus Sametime Mobile Proxy Server Application does not recognize the Lotus Domino 6.5.1 Server and thus will not deploy all the required files correctly. The steps above are an unsupported workaround to resolve this problem.