Upgrade Test Configuration from Lasernet 9 to Lasernet 10

Introduction

This section will give a walkthrough of a Lasernet upgrade from version 9 to version 10. The upgrade will be demonstrated on a test configuration connected to a Dynamics 365 Finance and Operations test environment.

It is best practice to upgrade a test configuration before a live configuration is upgraded to identify any unexpected issues that may arise during the upgrade. Therefore, the test configuration upgrade will be carried out before the Prod configuration upgrade.

Export Objects from Lasernet 9 Test Configuration

To export objects from Lasernet 9 test configuration, follow these steps:

1. Open the Lasernet Developer 9, then click File > Export configuration to take a backup of the whole Lasernet 9 test configuration.

2. Export the objects that have been added or modified from the default Lasernet 9 configuration.

Here is a list of objects which you may want to export (this list will differ based on your unique configuration):

• Azure service bus

• Azure storage command

• Forms

• Subforms

• XML transformers

• Regional profiles

• Custom scripts

• Images

• Outlook mail module

• Any other objects that have been added or changed from the default configuration

In this example, we will export the following:

• One subform

• Customer scripts

• One regional profile

• Outmail Output module

• Azure service bus

• One image

• Three Dynamics 365 transformers

• All sixteen forms (ensure you select the forms from the “Dynamics 365 forms” as there are some similar named forms within “Templates”)

• One Azure storage account

3. Click OK to create an lnobjectx file which will contain the exported objects.

Install Lasernet 10 and Apply Demo License

To install Lasernet 10, read the following guide: How to Install Lasernet.

You will need to complete at least the following three sections of the guide:

1. Lasernet Server

• Add a demo license in the Lasernet Server License Manager when you get to that section of the Lasernet 10 installation guide.

• A demo license is valid for sixty days and can be downloaded from here.

• If you do not manage to complete the upgrade within sixty days, you will need to download another demo license and apply that.

2. Lasernet Config Server

• When setting up the server, ensure the instance name uses the same name that is in the Lasernet Server License Manager 10.

3. Lasernet Web Client

The Lasernet Developer is usually accessed from the same server as the Lasernet server. If the Lasernet Developer needs to be accessed from the Lasernet server, install the Lasernet Developer:

• Add a demo license in the Lasernet Developer License Manager when you get to that section of the Lasernet 10 installation guide.

• A demo license is valid for sixty days and can be downloaded from here.

• The demo license which was downloaded for the Lasernet Server License Manager can also be used for the Lasernet Developer License Manager.

• If you do not manage to complete the upgrade within sixty days, you will need to download another demo license and apply that.

Turn Off Lasernet 9 Services

Open the Services on the Lasernet server and ensure the following Lasernet 9 services are turned off:

Turn On Lasernet 10 Services

Open the Services on the Lasernet server and ensure the following Lasernet 10 services are turned on:

Import Lasernet Default Configuration for Dynamics 365 Finance and Operations

If you are unsure as to whether you are using a Formpipe default configuration, consult your Lasernet partner, as they may have an alternative non-Formpipe configuration that they would like you to use.

If you are using a Formpipe default configuration, refer to this page of our knowledge base.

1. Click the download link for the FO Connector version that you are using.

2. Select the default configurations zip folder.

3. Extract the lnconfigx file from the zip folder.

4. Import the default configuration (lnconfigx file) within Lasernet Developer 10.

5. Select Servers.

6. Change the Instance to the instance name which was defined in the Lasernet Server License Manager 10 and in the Config Server.

Import Lasernet 9 Objects into Lasernet 10 Default Configuration for Test

1. Open Lasernet Developer 10, then click File > Import Objects.

2. Select the lnobjectx file which was exported from the test configuration in the Lasernet Developer 9.

3. Select Full to select all objects within the lnobjectx file.

4. Click OK.

5. Click Import and Replace object to replace the object from the default Lasernet 10 configuration with the objects from the Lasernet 9 configuration. Select Do this for any remaining conflicts to apply the same choice to the remaining conflicts.

6. Commit and Deploy changes.

Perform Testing to Ensure Reports are Behaving as Expected

The Lasernet 10 configuration is now ready for testing.

Perform testing to ensure reports are behaving as expected.

Make a note of any additional changes that are needed for the Lasernet 10 test configuration, as these changes may need to be made in the Prod configuration as well.