Setting up mobile clients

Registering an employee as a mobile client is the first task in the process of

supporting users who need a local database. This procedure is necessary for
developers and end users alike.
Administrators register employees as mobile clients in the Administration - Sieb
el
Remote screen, Mobile Clients view, which is shown in the following screenshot:
The following steps describe the process of registering a new mobile client:
1. Navigate to the Administration - Siebel Remote screen, Mobile
Clients view.
2. In the Mobile Clients list, click New.
3. Enter a name for the mobile client. This is typically the same as the user's
login name but can be different from it.
4. Select an employee or enter a user login identifier in the User ID field.
5. Select the MOBILE CLIENT - STANDARD routing model (See the
information box below for details on routing models).
6. Save the record.
Creating the database schema files
After a new installation of a Siebel enterprise and after each change to the sch
ema
through developer activity or an upgrade to a newer Siebel version, administrato
rs
must run a job for the Generate New Database component.
The component is named Generate New Database because it creates a new empty
Sybase Adaptive Server Anywhere database in the DBTEMPL folder of the Siebel
server's installation directory. This empty database contains the same tables an
d
indexes as those that existed in the server database at the point in time when t
he
component was invoked.
We can use either the Siebel Server Manager (srvrmgr) command line utility to st
art
a task for the GenNewDb (its alias name) component or use the Jobs view in the
Administration - Server Management screen in the Siebel Web Client.
The following procedure describes how to run a job for the Generate New Database
component using the Jobs view:
1. Navigate to the Administration - Server Management screen, Jobs view.
2. Click New to create a new job request.
3. Select Generate New Database from the Component/Job pick list.
4. Click the Submit Job button.
5. Monitor the Job using ALT+ENTER to refresh the Jobs view frequently
until the job's status changes to Success.
6. Open the Siebel Server's installation folder and navigate to the
DBTEMPL folder.
7. Verify that a new subdirectory has been created and that a file
sse_utf8.dbz exists among other files. This file is a compressed, empty
Sybase database with the same tables and indexes as the server database.
The following screenshot shows the Jobs view in the Administration - Server
Management screen:

Extracting data for local databases

The next step is to extract a data snapshot for one or more mobile users using t
he
Database Extract server component. Before we submit a job request for the Databa
se
Extract component, we must verify that the Siebel Remote system preferences are
set correctly.
optimize visibility check enabled
Running a database extract job for developers
Because we consider a development environment scenario in this chapter, the
following procedure includes instructions to set the security control fields in
the
Remote System Preferences view to false as recommended above. The procedure
describes how to execute a job for the Database Extract component for a single u
ser
or groups of users.
1. Navigate to the Administration - Siebel Remote screen, Remote System
Preferences view.
2. Uncheck the Enable Mobile Password Expiration flag.
3. Uncheck the Enable Mobile Password Syntax Check flag.
4. Uncheck the Enable Mobile Web Client Lockout flag.
5. Check the Enable Transaction Logging flag.
6. Click Save.
7. Navigate to the Administration - Server Management screen, Jobs view.
8. Click New to create a new job request.
9. Select Database Extract from the Component/Job pick list.
10. Scroll down to the Parameters list.

11. Create a new parameter record, select Client Database encryption method
and enter a value of None.
12. Create another parameter record, select Client Name and enter either an
exact mobile client name, a comma-separated list of mobile client names,
or use the asterisk (*) wildcard character. For example, specify all mobile
clients that start with A by entering A* as the value for the parameter.
13. Create another parameter record, select Encrypt client Db password and
set the value to False.
14. If we wish to extract repository data so that developers do not have to copy
it in Siebel Tools, we can set the Extract all Repository Tables parameter
to True.
15. In the upper list applet, click Submit Job.
16. Monitor the job using ALT+ENTER until the job's status changes to Success.
To verify the successful execution of the Database Extract job, we can navigate
to
the docking folder in the Siebel Server's installation directory. For each mobil
e client
specified in the Client Name parameter, we should now find a subdirectory with t
he
client's name. This directory has an inbox and an outbox subdirectory.
The outbox subdirectory should contain a set of files, which represent the data
that was present in the server database when the job was executed. The following
screenshot shows the outbox folder for the mobile client AHANSAL and its content
generated by the Database Extract component: