Products Downloads


French version


 

The Update management tool lets you arrange the automatic updating of a Visual Adelia application, when used with the Installation program manager.

 

 

The application must be started using a launcher, which performs an automatic check before running the application (and updates it if necessary).

 

Example

We want to run a program called "TEST", which contains two parameters: "param1" and "param2".

To run this program normally, enter the command:

TEST PARAM1 PARAM2

 

To run it with a version check, enter the command:

VERCTRL SERVLOGCTRL PRODUCTNAME TEST FLAG PARAM1 PARAM2

 

VERCTRL

Launcher program (program supplied with the Runtime package).

SERVLOGCTRL

Name of the logical server containing the application's update programs and details. The server management program can be used to configure the physical machine corresponding to this logical server.

PRODUCTNAME

Key name designating the application.

FLAG

Displays an information window or not

("Y" to display it, "N" to not display it).

Version control is automatic in the Adelia Mobile applications. No configuration is required.

If the application is saved in the version control (during installation or later using the command "verctrl.exe -register ce application full name"), all the .exe defined as entry points are automatically checked.

When starting a program in the version control, the runtime automatically checks whether an update is present. If an update is available, it triggers the update process.

The update process is run in an identical way to the Visual version; at the end of updating, if no faults have occurred, the command is run again.

The logical server for the update is imposed. You must create it in the client setup (Adelia.cfg) with the name *VERCTRL. The association with the physical server is set toward the machine hosting the update server.

To carry out a silent installation, you must add the following parameters to your Adelia.cfg configuration file:

 

[Version Control]

; Silent installation of updates

SilentInstall = 1

 

[HARDIS_HEADER_SECTION]

Version=v1.2.0

...

 

Version control process

The version controller runs through the following steps one by one:

1. It contacts the logical server to check that the product version is up to date:

    • if the product is the latest version, the version control ends and the launcher starts the application;

    • if an update is required, the logical server sends an update program.

2. The launcher runs the update program and the product is upgraded to the next version.

3. Back to step one.

 

 

When the product was originally installed by Adelia's Installation Manager, the HKEY_LOCAL_MACHINE\Software\<ProductName> key was created in the computer's registry.

With Visual Adelia installations, the user executing the VERCTRL launcher must have "Modify" permissions for this key's "Version" value.

 

Access

To configure a machine as an update server, select the Update management option from the Visual/Web Runtime subfolder in the Adelia Studio folder.

 

Lists

Products

List of products for which you want to implement an automatic update system.

The name must be the same as the one specified when you created the installation used to distribute this product ("Name" column).

The version must also match the one specified in the installation.

Note: in the case of a Mobile type installation, the product name must reference the full name of the CE application and its configuration. This helps distinguish between the update programs for different configurations.

The example below shows an application named TestApp, supplied by Hardis with multilingual support:

- The name recorded for the French Pocket PC version will be "HARDIS TESTAPP PPC_ARM_FR_FR".

- For the English version it is "HARDIS TESTAPP PPC_ARM_EN_GB".

This lets you release multiple versions of the application (for different destination systems / languages / processors, etc.) on the same update server. Controls are strict: a Pocket PC application should not normally be updated by a Windows CE standard update program for example.

 

Single-selection list.

 

Note: The version specified here is the current version, i.e. the latest one. You should therefore check that this field is updated whenever there is a new version.

 

Versions to update

List of versions prior to the selected product's current version, for which an update or installation program is available. This program is generated beforehand by the Installation program manager, in the form of a self-installing program for Visual Adelia applications.

Its path is specified in the "Program" column.

This list is updated when a product is selected in the product list.

Single-selection list.

 

Note: You can specify a default program for other versions that will not be included in the list of versions to update (e.g. the latest version's installation program). To do so, create a version with the code *OTHER.

 

Context-sensitive menus

Product list
Create

Opens a dialog box that lets you create a new product.

 

Modify

Opens a dialog box that lets you display or modify the selected product's general characteristics.

 

Delete

Deletes the selected product. It will no longer be possible to update this application automatically.

 

List of versions to update
Create

Opens a dialog box that lets you create a new version of the current product (the one selected in the product list), specifying the update program assigned to it.

 

Modify

Opens a dialog box that lets you display or modify the selected version's general characteristics.

 

Delete

Deletes the selected version.

 

Buttons

Enter

Closes the dialog box.

Keyboard shortcut: Esc.

 

Example >>

 

↑ Top of page

  • Aucune étiquette