--- title: "Upgrade Lasernet Archive" slug: "upgrade-lasernet-archive" description: "This page provides comprehensive instructions for upgrading to Lasernet Archive from earlier Archive and Autoform DM versions." tags: ["Autoform DM", "Lasernet Archive", "Standalone", "Upgrade"] updated: 2026-11-20T11:48:17Z published: 2026-11-20T11:48:17Z canonical: "kb.lasernetgroup.com/upgrade-lasernet-archive" --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.lasernetgroup.com/llms.txt > Use this file to discover all available pages before exploring further. # Upgrade Lasernet Archive This guide describes how to upgrade Archive when the software is running in standalone mode. It also covers upgrading from Autoform DM to Archive. ## Overview Archive versions follow the [Semantic Versioning 2.0.0](https://semver.org/) (MAJOR.MINOR.PATCH) system. An Archive version is a major release, a minor release, or a patch release. The type of software changes made in a new Archive version determines that new software version’s category (as described below) and consequently its version number: - **Major release:** Contains significant changes, including incompatible Application Programming Interface (API) changes. - **Minor** **release:** Contains moderate changes, such as new functionality that has been added in a backward-compatible manner. - **Patch** **release:** Contains minimal changes such as bug fixes (always added in a backward-compatible manner). The first part of a release’s version number indicates the software’s major version, the second is the minor version, and the third is the patch version. For example, if the version number is 3.2.1, then 3 is the major version number, 2 is the minor version number, and 1 is the patch version number. The release’s category (major, minor, or patch) determines which element of the version number is incremented to form the new release’s version number. ## Types of Upgrade The upgrade process is the same for all types of upgrade: - If the major version differs (for example, Autoform DM 10.4.3 to Archive 11.0), you are performing a “major upgrade”. - If the minor version differs (for example, Archive 11.0.0 to 11.1.0), you are performing a “minor upgrade”. - If only the patch version number differs (for example, you are upgrading from 11.1.0 to 11.1.1), you are performing a “patch upgrade”. > [!NOTE] > Note > > Patch upgrades are reserved for bug or security fixes and are not part of the typical upgrade path. To perform an upgrade, you must use the Archive installer. The installer will install the new software to the following location: `C:\Program Files\Lasernet\Lasernet Archive\Server_<major_version>.<minor_version> - <node_name>` Appropriately substitute the `<major_version>`, `<minor_version>`, and `<node_name>` to locate your installation path. See [Pre-Upgrade Checklist](/v1/docs/upgrade-keep#preupgrade-checklist) and [Upgrade Process](/v1/docs/upgrade-keep#upgrade-process-for-major-and-minor-upgrades) to start upgrading. ## Essential Information About Upgrades from Autoform DM to Lasernet Archive Upgrading from Autoform DM to Lasernet Archive is a major upgrade that delivers many benefits for users. However, to deliver these improvements in Archive, some legacy features have been removed. Additionally, to minimize the number of breaking changes associated with upgrading to Lasernet Archive, the Autoform DM versions that you can upgrade from are limited. ### Autoform DM Versions Supported for Upgrade to Lasernet Archive > [!WARNING] > Important > > The only Autoform DM versions that are supported for upgrade to Lasernet Archive are Autoform DM 10.0 and later. > > To upgrade an earlier version of Autoform DM to Lasernet Archive, you must first upgrade to Autoform DM 10. Then, you can upgrade to Lasernet Archive. ### Lasernet Archive Changes That Affect Existing Installations and Workflows To enable us to deliver improvements in Lasernet Archive, we have removed some features and capabilities that were present in Autoform DM 10. If the workflows currently implemented by your system rely on these capabilities, you will need to implement appropriate mitigations before upgrading, or in some circumstances the changes could prevent you from upgrading from Autoform DM to Archive. Additionally, some application behaviors have changed in Lasernet Archive, in ways that might require you to implement workarounds that ensure that your system continues to operate after upgrading to Archive. Removing legacy features reduces the testing, support, and maintenance overheads that they incur, which helps us to deliver new Lasernet Archive functionality faster. For detailed information about the changes and their associated mitigations and workarounds, see [Lasernet Archive Changes That Affect Existing Autoform DM Workflows](/v1/docs/lasernet-keep-changes-that-affect-existing-autoform-dm-workflows). ## Pre-Upgrade Checklist > [!WARNING] > Warning > > To ensure that the upgrade succeeds and the new software performs well, you must complete the following tasks. Before you upgrade Archive, complete every task in the following list. - To determine the best upgrade path, refer to [Notable Lasernet Archive and Autoform DM Versions](/v1/docs/notable-keep-autoform-dm-versions). - To learn about any significant software changes, refer to the release notes for the new Archive version, and the release notes for any versions released after the currently installed Archive or Autoform DM version but prior to the new version. - To learn which versions of relevant other software (such as databases, operating systems, and other integrated products) are compatible with the new Archive version, refer to the [Lasernet Archive Compatibility Matrices](/v1/docs/lasernet-keep-compatibility-matrices). - Locally test any client applications to discover whether they need to be modified for compatibility with the new Archive version. - To ensure the current server specification is sufficient, refer to the [Lasernet Archive System Requirements](/v1/docs/lasernet-keep-system-requirements). ## Upgrade Process The process for all upgrades involves installing the new Archive version alongside the existing Archive or Autoform DM version (while the existing software is stopped). You can then test the connection and functionality of the new software before uninstalling the old version. Where “install” is mentioned, you can use the manual method described in [Manual Installation Steps](/v1/docs/upgrade-keep#manual-installation-steps) or do a [silent install](/v1/docs/install-keep-silent-installation). ### Before You Begin Complete the following tasks before you begin the upgrade: - Copy the `.exe` installer file from the new Archive version’s installation package to the Archive server. - The Archive installer runs on Java. So, if a JRE or JDK (Java 1.8 or later) is not already installed on the Archive server, you must install a JRE before you run the Archive installer. > [!NOTE] > Note > > For more information about this install-time Java requirement (and about the associated Java licensing implications), see [Lasernet Archive and Java Licensing](/v1/docs/lasernet-keep-and-java-licensing). > > > > For information about compatible JREs, see the [Lasernet Archive Compatibility Matrices](/v1/docs/lasernet-keep-compatibility-matrices). ### Upgrade Process Testing The Lasernet Group recommends performing the upgrade on a test system first, before upgrading a live production environment. ### Summary of the Upgrade Process To upgrade Archive, follow this process: 1. [Collect information about the current Lasernet Archive or Autoform DM installation](/v1/docs/upgrade-keep#collect-information-about-the-current-installation) (or copy its `.properties` file, which records this information). 2. Stop the existing Archive or Autoform DM service. 3. Stop any software that is integrated with Archive or Autoform DM (such as Lasernet Generate). 4. Perform a full backup of the current Lasernet Archive or Autoform DM database and archive. 5. Perform the upgrade and start the new Archive service. You can follow the [manual upgrade steps](/v1/docs/upgrade-keep#manual-installation-steps) or do a [silent install](/v1/docs/install-keep-silent-installation). 6. Follow an approved test plan to verify the new install. 7. Start any integrated software (such as Lasernet) and verify that it can connect to Archive. 8. After the upgraded Archive software installation has passed testing and is running satisfactorily, you can uninstall the superseded Archive or Autoform DM version. ### Collect Information About the Current Installation Before you install the new version, record the following important information about the current installation. You will need some of this information during the upgrade process. - Server Name / IP Address - Ports (HTTP, HTTPS, management port, port offset) - Archive or Autoform DM administrator username - Archive or Autoform DM administrator password - Installation directory - Archive directory - Database server name - Database type (Microsoft SQL Server, Microsoft SQL Azure, or Oracle) - Database port (if not default) - Database name (`AFPDM` by default) - Database username (`pdm` by default) - Database password (`pdm `by default) - Windows Service username (if any) > [!NOTE] > Tip > > From Autoform DM 9.0.0, much of this information is recorded in the `installation-record.properties` file (generated by the Archive or Autoform DM installer that last ran on the server). You can use this file with the silent installation process to automate much of the installation. > > > > The installation steps below describe the manual upgrade process. ### Manual Installation Steps Follow these steps to manually install the new Archive version: #### 1. Run the Lasernet Archive Installer > [!NOTE] > Note > > The screenshots on this page show installer screens available in Lasernet Archive 11.1 and later. To run the installer that you copied to the Archive server, double-click the installer EXE file (for example: `Lasernet-Archive-v11.3.1.exe`). The installer’s **Welcome** page will appear. Click **Next**. #### 2. Accept the End User Software Licence Agreement Review the license terms and conditions at [https://www.lasernetgroup.com/legal/](https://www.lasernetgroup.com/legal/). If you accept the terms of the agreement, click **I accept the terms of this license agreement**, then click **Next**. #### 3. Select "Upgrade" Installation Type Click **Upgrade**, then click **Next**. #### 4. Enter a Node Name Each distinct installation of Archive on a particular server (and so, each running instance of Archive on that server) is referred to as a node. Each of these instances is differentiated by its node name, which the installer automatically includes in that Archive installation's Windows service name and installation file path. You can use the node name to identify the instance. For example, the node's name could indicate that Archive instance's role (such as Test or Production). Enter an appropriate **Node name**, then click **Next**. ![Lasernet Archive installation step 4](https://cdn.document360.io/c831ef63-c6b3-48ee-b443-3e33644e4e2e/Images/Documentation/Step%204%20-%20Node%20name.png) #### 5. Choose an Installation Location Check whether the default installation path (which includes the node name) is appropriate. If necessary, enter a different location (or click **Browse** to select a location), then click **Next**. > [!NOTE] > Note > > This should be a directory that is separate from any existing Archive or Autoform DM installs, because the new Archive version will be installed alongside the currently installed software. The currently installed software can be uninstalled after the new Archive system has been tested. #### 6. Choose Which Components to Install Select the checkboxes beside the Archive components that you want to install, then click **Next**. > [!NOTE] > Note > > **Application Server** and **Lasernet Archive** are mandatory components. They are automatically selected and are grayed (so that their checkboxes cannot be cleared). **Service:** This component is a Windows service that represents this installation of Archive. ![Lasernet Archive installation step 6](https://cdn.document360.io/c831ef63-c6b3-48ee-b443-3e33644e4e2e/Images/Documentation/Step%206%20-%20Installation%20Packages.png) #### 7. Configure Wildfly (Application Server) The next few pages of the installation wizard collect configuration settings for the application server (Wildfly). #### Application Server Configuration Page **Username**, **Password**, and **Retype Password**: Set the access credentials for the application server management console. > [!NOTE] > Note > > These credentials are used to access the Wildfly management console, not the Archive application. **Local HTTP management port:** If necessary to avoid a port conflict, change the default value. If multiple installations of Archive will run simultaneously on the server, each installation must have a unique **Local HTTP management port** value. HTTPS is configured by default. Click **Setup HTTPS with a custom certificate** (recommended) if you are able to provide a keystore containing the certificate that you want to use. Else, if you click **Setup HTTPS with a generated certificate**, the installer will generate a self-signed certificate, which you can change for a custom certificate at a later date. **Enable proxy forwarding header support:** By default, this checkbox is cleared. If appropriate, select this option; the information above the checkbox describes when this option is relevant. Complete this page, then click **Next**. ![Lasernet Archive installation step 7](https://cdn.document360.io/c831ef63-c6b3-48ee-b443-3e33644e4e2e/Images/Documentation/Step%207%20-%20Application%20Server%20Config.png) #### Application Port Configuration Page **HTTP Port** and **HTTPS Port**: The default **HTTP Port** is **80** (standard HTTP port), and the default **HTTPS Port** is **443** (standard HTTPS port). Change these port numbers if there is risk of a port number conflict with other services or web servers that are installed on the same server. **Port offset** and **Custom offset**: The ports that an Archive instance uses must be for the sole use of that Archive instance. If multiple Archive instances are installed and running on a server, and those instances all have the same **HTTP Port** and **HTTPS Port** numbers, a port conflict will occur unless each instance has a different **Port offset**. The **Port offset** resolves this problem by adding the specified number to the port numbers that are used by the Archive instance that you are installing. For example, if **HTTPS Port** is set to **443** and you select **50** from the **Port offset** list, the instance will use port 493 for HTTPS communication. You can select a value from the **Port offset** list, or select **Custom** from the list and enter a number into the **Custom offset** box. > [!NOTE] > Note > > Port offset does not affect **Local http management port**. Complete this page, then click **Next**. ![Lasernet Archive installation step 8](https://cdn.document360.io/c831ef63-c6b3-48ee-b443-3e33644e4e2e/Images/Documentation/Step%208%20-%20Application%20Ports%20Config.png) #### HTTPS Certificate Configuration Page If you selected **Setup HTTPS with a custom certificate** (on the **Application Server configuration** page), you must provide a keystore that contains the HTTPS certificate that you want Archive to use. You must also provide the accompanying credentials. **HTTPS certificate keystore to install:** Select the Java KeyStore (JKS) or Personal Information Exchange (PFX) file that contains the SSL certificate that you want to install. The installer will copy this keystore to a location within the Archive installation directory. Use **Key alias**, **Keystore Password**, and **Retype Keystore Password** to provide the access credentials for that keystore. To continue, click **Next**. > [!WARNING] > Warning > > After you click **Next**, the installer will validate the supplied access credentials against the selected keystore. If the credentials are not valid, you will be unable to proceed with this installation. ![Lasernet Archive installation step 9](https://cdn.document360.io/c831ef63-c6b3-48ee-b443-3e33644e4e2e/Images/Documentation/Step%209%20-%20HTTPS%20Cert%20Config.png) #### HTTPS Generated Certificate Configuration Page If you selected **Setup HTTPS with a generated certificate** (on the **Application Server configuration** page), you must enter **Hostname**, **Organisation**, and **Organisational Unit** values that enable the installer to generate a self-signed certificate. You can use the default values or change them. The alias and password for the generated certificate depends on the Archive version. - **alias:** `app_generated_cert` - **password:** `appcert` To continue, click **Next**. > [!NOTE] > Note > > The automatically generated certificate is intended to speed up the installation and deployment process, while establishing a base level of security. To provide a more secure environment, Lasernet Group recommends that you [replace the generated (temporary) certificate with a custom certificate](/v1/docs/https-certificate-rotation-keep) as soon as possible. ![Lasernet Archive installation step 10](https://cdn.document360.io/c831ef63-c6b3-48ee-b443-3e33644e4e2e/Images/Documentation/Step%2010%20-%20Generated%20HTTPS%20Cert.png) #### 8. Configure the Database Connection The information that you enter on this page enables Archive to connect to the database that the currently installed version of Archive or Autoform DM uses. > [!NOTE] > Note > > When the new version of Archive starts (after the upgrade is complete), it will upgrade this database. **Select target database:** Select the type of database that Archive will connect to. > [!WARNING] > Warning > > Do not use the **H2** database type for production systems. It is intended only for temporary test installations. **Hostname:** Enter the host name of the computer that is hosting the database. **Database name**, **Username**, **Password**, and **Retype Password**: Enter values that match those used by the database that the currently installed version of Archive uses. Unless directed otherwise, use the default **Min connection pool size** and **Max connection pool size**. To continue, click **Next**. ![Lasernet Archive installation step 12](https://cdn.document360.io/c831ef63-c6b3-48ee-b443-3e33644e4e2e/Images/Documentation/Step%2012%20-%20Database%20Config.png) #### 9. Configure the Windows Service If you selected **Service** (on the **Select Installation Packages** page), you must configure the Windows service that the installer will create. This service represents the new Archive installation. **Service Startup Mode:** If you click **Automatic**, the Archive service starts automatically when the server starts. If you click **Manual**, a user of that server must manually start the Windows service. **Start the service after installation:** By default, this option is selected. Next, specify the identity that the service will run under: - **To use the Windows LocalSystem account:** Leave **Username**, **Password**, and **Retype Password** blank. > [!NOTE] > Note > > The LocalSystem account cannot access archive file locations on other computers. - **To use an existing user account:** Enter that user account's username and password. Enter the username in `<domain>\<user>` format; appropriately substitute `<domain>` and `<user>`. If the user is on the local domain, substitute `<domain>` for `.` (period). Ensure that the specified account has **Log on as a service** privileges and will be able to access the archive file location. To continue, click **Next**. ![Lasernet Archive installation step 13](https://cdn.document360.io/c831ef63-c6b3-48ee-b443-3e33644e4e2e/Images/Documentation/Step%2013%20-%20Windows%20Service%20config.png) #### 10. Review the Pre-Installation Summary The **Summary Configuration Data** page summarizes the settings and configuration values that the installer will use to install and configure Archive and the application server (Wildfly). The **HTTP Port** and **HTTPS Port** that the new installation will use are calculated from the port number and offset entered earlier and are displayed here. If they differ from the default values, make a note of them. > [!NOTE] > Note > > Lasernet Archive stores the location of the archive directory in its database. On the installer’s **Database configuration** page, you specified which database the currently installed Lasernet Archive or Autoform DM system uses. As a result, the new version of Lasernet Archive will use the same database. When the new software version starts, it will connect to the database and read the archive directory location. > > > > As a result, the new version of Lasernet Archive will use the same archive directory as the currently installed version. To start installing the software, click **Next**. #### 11. Install the Software and Monitor Installation Progress The Archive installer will install and configure the software. Progress bars on the **Installation** page indicate how much of the process remains to complete. After the installer successfully installs the software, it will display an **Installation Finished** page. Click **Done** to close the installation wizard. #### 12. Log In to the New Lasernet Archive Installation After the software is installed, the corresponding Windows service will start. Open a web browser and log in to the new installation. Archive will indicate that it is upgrading the database, and then you will be able to use the Archive application. > [!NOTE] > Note > > If you upgraded from Autoform DM to Archive, ensure that you go to the log in page for Archive. > > > > The Archive URL has the following structure: > > `https://<host name>:<port>/archive/` > > > > Appropriately substitute `<host name>` and `<port>`. > > > > If Archive is using the default HTTPS port (443), you can omit `:<port>`. For example: `https://archive-server/archive` > > > > However, if Archive is using a different HTTPS port, you must specify that port number. For example, if during installation you specified an **HTTPS Port** number of **443** and a **Port offset** of **100**, Archive’s HTTPS port number is 543: `https://archive-server:543/archive` > > > > If you omit `/archive/`, your browser will redirect to you to Archive.