Installation

For customers using the on-premise version of aPriori, the aPriori Regional Data Libraries must be loaded from a computer with aP Pro installed and on the same Local Area Network (LAN) as the database server.

For customers using the appStream version of aPriori, please ensure you are logged into your correct deployment (Production, Sandbox, etc). Once appStream has loaded, upload the relevant Regional Data Libraries into the “Temporary Folder” of the appStream folder structure. When uploaded to this location you are ready to import the relevant zip files via the Digital Factory Manager menu “File > Import > Multiple Digital Factories”

The time required to install the update depends on the connection to the database and the number of regions that need updating. According to aPriori testing, it takes approximately 90 seconds per Digital Factory when loading to a database on a LAN.

Caution: If you try to load the updates from a machine that is not on the same LAN as the database server, the update may take many hours to complete.

Although users may remain connected to the system during an update, as a best practice, notify end users before updating to the new release. Updates are effective immediately and end users may notice cost differences during the update.

As of aPriori Release 2021 R1, the term Digital Factory replaced the term Virtual Production Environment (VPE). However, the file extension *.vpe is still valid.

1. Download the package provided by aPriori Customer Support to a local folder. This folder contains these files:

   1. License file containing access to new regions –.apz file

   2. A baseline update file – baseLineUpdate-<release-version>-(2026-06).apx

   3. Regional Data Libraries – files with extension *.vpe.zip

2. Import the new license file. To do so, you must be configured as a System Administrator in the aPriori environment.

3. Import the baseline update file. To do so, you must be configured as a Digital Factory Administrator in the aPriori environment:

   1. Launch the Digital Factory Toolset.

   2. Click File > Import > Import aPriori Baseline Update…

   3. Navigate to and select the baseline update file and then click Open.

      Note: If you download the file using Internet Explorer, the original file extension of .apx may change to .zip. By default, the file browser displays only files with .apx extensions. Therefore, you must either select the option to view all files or change the file extension of the update back to .apx.

   4. When you are asked to confirm, click OK.

      While the update is being loaded, you can see the progress in the lower right corner of the toolset window.

   5. When a pop-up message confirms that the update is complete, click OK.

4. Restart aPriori Professional or refresh your database connection.

5. Use this procedure to import Digital Factories:

   1. Launch the Digital Factory Toolset.

   2. Click File > Import > Multiple Digital Factories….

   3. Follow the steps in the dialog to import the Digital Factories from the directory you selected:

      1. Select a local directory that contains all the regional data libraries.

      2. Select the *.vpe files you wish to import.

      3. Click OK.

         While the update is being loaded, the progress bar displays in the bottom right of the main user interface (UI). Progress does not display in the Digital Factory UI. Depending on the number of selected Regional Data Libraries and the speed of your connection, the *vpe file import process can take several hours.

   4. When a pop-up message confirms that the update is complete, click OK.

      Note: Although you can import Digital Factories file-by-file by using the Import capability in the Digital Factory Toolset (File > Import > Digital Factory…), this method is inefficient, because it requires much more manual interaction than this procedure.

6. Import the Regional Data Libraries.