1. Mobile Guide: Disconnected
  2. Setting Up the Disconnected Mobile Synchronization Component Group

Setting Up the Disconnected Mobile Synchronization Component Group

This task is a step in Process of Configuring Siebel Server for Siebel Mobile.

The following procedure shows you how to set up MobileSync, the disconnected mobile synchronization component group for Siebel Mobile disconnected applications. The purpose of this task is to support synchronization in disconnected mode.

Note that by default, all of the following are configured for the Siebel Mobile application for Siebel Pharma so it is not necessary to configure them again for the application:

  • MobileSync. The disconnected mobile synchronization component group.

  • MobileDbXtract. The data extraction component (in this case, the Siebel Mobile disconnected component) that is to extract data based on buscomp (the business component). The output is stored in the dmData.txt file, which will be synchronized with the Siebel Mobile client.

    You must use MobileDbXtract as a template and configure it accordingly to create the data extraction component for other mobile applications (such as, Siebel Field Service Mobile), as shown in the following procedure.

  • BatchSync. Batch synchronization.

To set up the Disconnected Mobile Synchronization component group

  1. Connect to the server manager on your server computer and run the following command to see if the MobileSync component group has been enabled or not:

    list compgrps

    If required, enable the MobileSync component group as follows:

    1. Navigate to the Administration - Server Configuration screen, then the Enterprises view.

    2. Select the Component Groups tab, and then query for MobileSync in the Alias field.

    3. Click the Enable button.

    4. In the Component Groups Assignments applet, click the Enable button for the required Windows or UNIX server.

  2. Create the data extraction component, using MobileDbXtract as a template, for the mobile application as follows:

    Note: The data extraction component is the Siebel Mobile disconnected component that is to extract data based on buscomp (the business component). The output is stored in the dmData.txt file, which will be synchronized with the Siebel Mobile client.

    1. Log in to the Siebel application as a user with administrator privileges.

    2. Navigate to the Administration - Server Configuration screen, then the Enterprises view.

    3. Click the Component Definitions tab, and then query for MobileDbXtract in the Alias field.

    4. Using MobileDbXtract as a template, create a similar data extraction component for the mobile application you want to set up MobileSync for as follows:

      • Click Menu, then Copy Record.

      • In the Component field, type the name of the new data extraction component.

        For example, type in ServicemDbXtract_enu to create a data extraction component for the Siebel Mobile application for Siebel Field Service where _enu indicates the language (English) supported. Type in ServicemDbXtract_jpn for the japanese language, and so on.

      • Select MobileSync from the Component Group drop-down list.

      • In the Description field, type a description of the new component.

    5. In the Component Parameters applet, configure the component parameters for the data extraction component (in this case, ServicemDbXtract) with the values shown in the following table:

      Name

      Value

      Application Name

      Siebel Field Service for Mobile

      Note: The application name must be exactly the same as the mobile application name. You can find the mobile application name using the srvrmgr command line as follows: list param CFGApplicationName for comp ServicemObjMgr_enu..

      Language Code

      ENU

    6. Click Activate to activate the data extraction component for the mobile application.

    7. Click Synchronize to synchronize the data extraction component for the mobile application.

      Note: This synchronization is a server administration task, which must be done for batch mode server components after certain types of operations, and is not related to the data synchronization that the components perform. For more information, see Siebel System Administration Guide.

  3. Configure the settings for the mobile application as follows:

    1. Navigate to the Administration - Siebel Mobile screen, then the Application Administration view.

    2. Select the mobile application from the upper applet. For example, select Siebel Field Service for Mobile.

    3. Click the Settings tab, and then do the following:

      • Click New, select Data Extraction Component in the Name field, and then select the actual data extraction component (in this case, ServicemDbXtract) in the Value field. The name of the data extraction component must be the same as the name defined in Step 2.

      • Click New, select Enable Batch Extraction in the Name field, and then select True in the Value field. For more information, see Configuring Batch Synchronization for Siebel Mobile.

      • Set any other mobile application settings. For example, set PurgeInterval, Default Busobj, and Application Directory. For more information, see Configuring Application Settings for Siebel Mobile.

    4. Restart the Siebel Server for the changes to take effect.

    5. Check the status of the MobileSync component group by doing one of the following:

      • From the command line, run the following command:

        list comp for compgrp MobileSync

      • From the UI, navigate to the Administration - Server Management screen, then the Components view.

  4. Create a mobile client (such as SPORTER) and perform the database extraction by doing one of the following:

    • From the command line, run dbxtract using the following command:

      start task for comp dbxtract with client="SPORTER-MOBILE"

    • From the UI, navigate to the Administration - Server Management screen, then the Jobs view, and select the Dbxtract Component Job. Then in the Job Parameters applet, add the Client Name parameter and its value, for example, as follows:

      ClientName=SPORTER-MOBILE
    Note: Dbxtract is the Siebel Remote component used to extract data based on database tables. Running dbxtract generates full user data and also the visibility database that is used to route the incremental changes to the user. Dbxtract generates the visibility database only for Siebel Mobile users that are not legacy remote users. For more information, see Running Database Extract for Siebel Mobile Users.

  5. Start the mobile application (for example, servicem/enu) and log in with the appropriate user credentials.

  6. Test that batch synchronization is working:

    • Run the following in the server manager:

      list task for comp MobileDbXtract

      From the UI, you can check the status of MobileDbXtract or the component of the respective application that was created (for example, ServiceDbXtract) by navigating to the Administration - Server Management screen, then the Tasks view.

    • Verify that the dmData.txt file is generated in the hhsync/<mobile-application> directory.

      For example, hhsync/phm is the directory created for Siebel ePharma Mobile, hhsync/salesm is the directory created for Siebel Sales Mobile, and hhsync/servicem is the directory created for Siebel Field Service Mobile.

      The folder structure is determined by the Application Directory value specified in the Administration - Siebel Mobile screen, Application Administration view, Settings subview.

      The dmData.txt file contains all the application data (records and business components) to be synchronized with the client.