Creating and Installing Updates

Business application updates are created and installed using *.updpack files. Creating and installing business application update packages controls application integrity taking into account versions of related extensions of Foresight Analytics Platform.

When transferring business application update package to another repository where the application is not installed, primary component installation is executed using the repository manager. In the future, creation and update of versions of installed applications between repositories is executed in the designer of business applications.

Thus, on creating a business application the following steps are executed:

1. Primary installation of the Designer of Business Applications extension of Foresight Analytics Platform to development repository using the repository manager. After the extension has been installed, the Designer of Business Application system component with the COMP_CONSTRUCT identifier will be installed to the repository.

2. Creating an application and creating application updates in development repository using the designer of business applications.

3. Installing business application updates:

• In other repository, for example, test repository where the application is not installed:

• Primary installation of the Designer of Business Applications extension of Foresight Analytics Platform to repository using the repository manager.

• Primary application installation using the repository manager.

• In other repository, for example, test repository where the application is installed:

• Installing application updates to repository using the designer of business application.

Creating Business Application Updates

Business application updates in the *.updpack format are created on the Update page in the designer of business application.

Open the designer

Open the update creation wizard by clicking the Create button and set the parameters:

Basic properties

Update objects

Dependable components

Advanced update options

If required, the *.xml template can be created to save update creation settings for reuse. The template stores: update name, list of all objects with installed update contents and selection state (checkbox is selected/deselected), additional settings. The template does not store selection state by dependent components update, checkboxes are always selected by default. Click the Templates button and select one of the options in the list:

• Save to Business Application. When this item is selected, the update settings file is saved to the business application. These settings will be automatically applied on each update wizard opening till their deletion.

• Delete from Business Application. When this item is selected, the update settings file is deleted from the business application. The item is displayed in the list if the template has been saved to the business application before.

• Save to File. When this item is selected, the update settings file is saved on the local resource.

• Load from File. When this item is selected, the settings file specified by the user is loaded from the local resource (once). The information message is displayed to confirm settings application.

If the template is not applied, update creation wizard settings are set by default.

Primary Business Application Installation

For the primary business application update package installation to the repository where the business application is not installed, follow the steps:

1. Start the repository manager:

• To start, use the shortcut that is created in the Windows main menu or use the RepoMngr.exe application in the folder with installed Foresight Analytics Platform.

• After the startup, select the Install Platform Extensions item.

• Click the Next button.

2. Select a file with the application update package and specify the repository, to which the application will be installed.
   
   Clicking the Next button installs the selected update package for the application.

NOTE. Connect to the repository under the name of the user who is a database (schema) owner.

3. When the installation is finished, click the Finish button.

NOTE. If there are any conflicts on installing update package, try to install it using the Designer of Business Applications extension. To do this, open the repository, to which the package is to be installed, find the Designer of Business Application object with the COMP_CONSTRUCT identifier, open it for edit and install update package.

Installing Business Application Updates

An update can be installed in the desktop application and web application.

Installing Update in the Desktop Application

To update version of previously installed business application, follow the steps:

1. In the designer of business application go to the Update page and in the Install Update section click the Browse button , select the required file and click the Install button.

2. After the file has been selected, the Install Update dialog box opens where names of update and business application to be updated, number of the current business application version and its version after update installation, names and version numbers of linked components that will be updated are displayed. Click the Install button:
   

NOTE. If the number of installed version of business application is less than the current one, the warning icon will be displayed. The Install button will be inactive.
If it is required to downgrade the current business application version, contact the technical support service.

3. The Install Update dialog box opens, in which click the Install button:

4. When the update is installed, click the Finish button:

NOTE. If there are any errors, go to the Errors tab for details. In case of additional development of business application objects, recreate the update and install it.

5. After the update is installed, close the repository and re-login.

6. After the update is installed, the business application structure will contain the Update Installation Report folder including text files of installation report:

Installing Update in the Web Application

To install an application update, follow the steps:

1. Open the update wizard using one of the methods:

• In the object navigator select the Navigator > Update Repository Objects main menu item.

• In the object navigator select the Tools > Update Manager > Apply main menu item.

2. Select the update file. To do this, click the Browse button, the standard file selection dialog box opens. Specify the path to the update file with the *.updpack extension.

3. After the file has been selected, the Install Update dialog box opens where names of update and component to be updated, number of the current component version and its version after update installation, names and version numbers of linked components that will be updated are displayed. Click the Install button:

The update wizard dialog box opens that contains two pages: Information and Update:

Installation of an update in the *.updpack format in the web application includes preparation and installation of files listed on the side panel of the update wizard. At the stage of preparation of each of the file, the Update Objects tab displays the objects to be updated at the current stage.

4. On the Information page click the Next button to install update from the first file.

5. After the update from file is started, the Update page displays the current update progress:

After the update is installed from file, the Update page displays the message about update completion:

After the update from file is complete, click the Next button.

6. Repeat steps 4-5 for the rest of files.

7. Click the Finish button to close the wizard.