Siebel Medical Handheld Guide > Deploying Siebel Handheld Applications > Distributing Siebel Handheld Application Patches >

Deploying Handheld Application Patches with Companion Synchronization     

This task is a step in Process of Installing the Siebel Handheld Application.

In order to set up patch deployment for Companion Synchronization users, you need to create a "model" of a patched Siebel Mobile Web Client and a patched Siebel Handheld Client. Then you pull the designated patch files and place them in the correct directory on the user's Mobile Web Client. You can use Siebel Anywhere to create upgrade kits to automate this process of distributing patch files to your user's Mobile Web Client. The next time the user uses Companion Synchronization to synchronize their handheld device with the Siebel Mobile Web Client, the patch is installed on the device.

For more information about how the patch process works with synchronization, see Downloading Patches to the Handheld Device.

To set up patch deployment

1. On Siebel Server, verify that the following directories exist. If they do not, create the directories.
   • C:\patch\AppBinDir
   • C:\patch\WinDir
2. Apply the patch to Siebel Server.
3. Apply the patch to Siebel Mobile Web Client.

   This Mobile Web Client serves as the model from which the patch files can be pulled.

4. Apply the patch to one Siebel Handheld Client.

   This Siebel Handheld Client serves as the model from which the patch files can be pulled.

5. Examine the Handheld application directory (My Device\Program Files\Siebel Handheld) to determine which files to copy over to the Siebel Server directory (C:\patch\AppBinDir).
6. Examine the Handheld application directory (My Device\Windows) to determine which files to copy over to the Siebel Server directory (C:\patch\WinDir).

   To do Step 5 and Step 6 accurately, it is recommended that you use one of the following methods:

   • First, take a snapshot of all files in the Siebel Handheld application directory before you install the new build. Then install the new Handheld application build, making a note of all files that are installed in the process.

     By comparing the list of files in the Handheld application directory before installation of the new build with the list of files in the Handheld application directory after installation of the new build, you can determine which files are new and which files remain the same.

     Copy all new files over to the Siebel Server directory.

   • Take a snapshot of the siebel.inf file before you install the new build. The siebel.inf file contains a complete list of all files that are installed on the handheld device, and is created just before the installation of the Handheld application (before clicking the finish button to finish installation of your Siebel Handheld application, the %temp%\siebelhh\files\siebel.inf file is created).

     In the case of Step 5, by comparing the list of files in the [Files.AppBinDir] section of siebel.inf with the list of files that are installed with the new build in the \Program Files\Siebel Handheld folder, you can determine which files are new and which files remain the same.

     In the case of Step 6, by comparing the list of files in the [Files.Windows] section of siebel.inf with the list of files that are installed with the new build in the \Windows folder, you can determine which files are new and which files remain the same.

     Copy all new files over to the Siebel Server directory.

     NOTE:  In all cases, compare the file size and timestamp on the older build with the newer build to determine which files need to be patched.

7. From the DOS prompt, change directory to C:\Siebel Root\SWEApp\BIN.
8. Execute the following command to move the patch files to the correct location and generate a patchlist.txt file:

   C:\Siebel Root\SWEApp\BIN>createpatchlist /s c:\patch /t c:\Siebel Root\sweapp\cepatch_xxx

   where

   • /s - source directory. The directory where the patch files were moved.
   • /t - target directory. The directory where PatchAgent checks for the patch files.
   • xxx is the language [enu, esn, and so on].

     NOTE:  You can specify a drive other than C:. However, the location of the source and target directories must be specified exactly as shown.

     After the patch files have been moved and the patch list created, the following message appears: Patch List has been successfully created in Siebel Root\SWEApp\cepatch_xxx files transferred successfully.

9. Create the following directory on the user's Mobile Web Client: Siebel Root\client\cepatch_xxx (where xxx is the language [enu, esn, and so on]), and push the files from the \Siebel Root\SWEApp\cepatch_xxx directory on Siebel Server to the Siebel Root\client\cepatch_xxx on the Mobile Web Client.

   NOTE:  Siebel Anywhere upgrade kits can be used to carry out this step.