LeanDESIGNER ClickOnce installation (Cloud database)

This article describes the LeanDESIGNER ClickOnce installation, both server and client side, with database on cloud. It applies for LeanDESIGNER 1.0.20 or higher. For previous versions, please contact Hyperlean support.

1. Introduction

To install LeanDESIGNER you’ll need to download some files from a few links: you shall check for each “.zip” file you download that it does not have a security block and eventually disable it, by applying the following procedure:

1. Right-click with the mouse on the downloaded “.zip” file
2. Select “Properties” option in the context menu which will open and then go to the tab named “General”.

If the “.zip” file is blocked, you will see the button or the box “Unblock”. In this case:

1. Press “Unblock” button or tick “Unblock”.
2. Press “Ok” to save the changes.

2. ClickOnce Technology

ClickOnce is a Microsoft technology which allows to create Windows applications with automatic update and that can be installed with minimum user interaction. The core principle of ClickOnce is to ease the deployment of Windows applications and it aims to solve three problems with conventional deployment models:

• Difficulties in updating an application. With Microsoft Windows Installer deployment, whenever an application is updated, the user must reinstall the entire application; with ClickOnce deployment, you can provide updates automatically. Only the portions of the application that have changed are downloaded. So, the application is updated on a client machine without any interaction by the user.
• Impact on the user’s pc. With Microsoft Windows Installer deployment, applications often rely on shared components, with the potential for versioning conflicts. With ClickOnce deployment each application is self-contained and cannot interfere with other applications.
• Security permissions. Windows Installer deployment requires administrative permissions and allows only limited user installation. ClickOnce deployment allows also non-administrative users to install and grants only those Code Access Security permissions necessary for the application.

Thanks to this new technology, you only need to install LeanDESIGNER ClickOnce on a server and you do not have to install LeanDESIGNER through the install-package (.msi) on a client machine. Moreover, to update LeanDESIGNER on a client machine, you only need to run LeanDESIGNER on it and not to install the new LeanDESIGNER version.

3. Server-side configuration

Server-side, there are two main topics to highlight:

• License installation
• Creation of a shared folder containing the material, data and ClickOnce deployment

The shared folder can be created in the same server where LeanDESIGNER license is installed or in a different one.

3.1 License installation

First, you need to install the driver to manage the license by following next procedure:

• Download “LicenseDriverInstallation_8.41.zip” from Dropbox.
• Unzip the downloaded “.zip” file. The folder “LicenseDriverInstallation_8.41”, obtained from the unzip, contains the following 4 files:

• Run as administrator the file “InstallLicenseDriver.bat” (right-click à “Run as administrator”) to install the license manager driver.
• Check if the service Sentinel LDK License Manager is running, otherwise start it. To check it: write “Services” on Windows search bar.

Go to folder “LicenseDriverInstallation_8.41” and:

1. Double-click on “RUS_GEWKM.exe” to run it
2. In the “Collect status information” tab
3. Select “Installation of new protection key”
4. Click on “Collect information” button

Save the related “C2V” file (fingerprint) with the name of your server.

Send the fingerprint file by email to support@hyperlean.eu.

NOTE: “C2V” files do not contain private customer information. They contain information about the license terms and data stored in deployed Sentinel protection keys. For further information, please visit the provider’s webpage.

Hyperlean Support will send you back a “V2C” file that allows you to activate the license. To apply the file run “RUS_GEWKM.exe” then follow next steps (shown on next images):

• Select “Apply License File” tab
• Click the three points button to upload the “.v2c” file received by Hyperlean Support
• Click on “Open” button to open it
• Click on “Apply Update” button

Open a browser and go to http://localhost:1947/int/devices.html to check if the license has been installed. If so, you will see a line like the one in the next picture.

3.2 ClickOnce deployment configuration

In this chapter we describe how to configure the server choosen to host the LeanDESIGNER ClickOnce deployment.

Creation of a shared folder

The first step is to create a shared folder called “LeanDESIGNER” with read permissions for all LeanDESIGNER users. Inside this folder, create the following subfolders:

• “Documentation” store here the guides Hyperlean sent you.
• “LeanDESIGNER_Deploy” this folder must contain two subfolders:
  • “ClickOnce” extract here the contents of the “LeanDESIGNER_X.x.x_ClickOnce.zip” folder folder send by Hyperlean
  • “Settings” extract here the contents of the “LeanDESIGNER_ClickOnce_Settings.zip” folder folder send by Hyperlean

Set the ClickOnce deployment path

It is necessary to configure a “.bat” file to set the path of LeanDESIGNER ClickOnce deployment.

Go to the “Settings” folder and open the “Change_LeanDESIGNER_distribution.bat” with a text editor.

Add the net path to “LeanDesignerLauncher.application”, that is stored in the “ClickOnce” subfolder, as shown in the picture below:

Save the customized “.bat” file and execute it on the server, by double-clicking on it.

Now you can install LeanDESIGENER on each client machine by following the procedure described on the next chapter.

4. Client-side installation

Preliminary step

Before installing LeanDESIGENER ClickOnce on a client PC, make sure that LeanDESIGENER was not already installed with MSI. If it was, you must unistall it and restart the PC.
To unistall LeanDESIGENER (MSI) open the “Control Panel”, select “Programs” and then “Unistall program.” Look for “LeanDESIGENER” on the list, select it and click “Uninstall”. Wait for the unistallation to end then restart the PC.

Client installation (ClickOnce)

N.B.: During the first installation, your user must have administrator rights to install LeanDESIGENER ClickOnce. The reason is that, during the first installation, you will have to install the license manager and set a registry key with the path to the ServerData folder and these operations can be done only with administrator permission. 
Additionally, If the client has multilpe accounts that will have to use LeanDESIGENER , you must install LeanDESIGENER ClickOnce for each account, since the ClickOnce installation is linked to the user’s account, not to the PC.

Open the shared “…\LeanDESIGENER_Deploy\Settings” folder,copy the “AddRegistryKeysLD_64bit.reg” file and paste it in your desktop: it contains the crypted string to enable the connection to the database on cloud.

If you have any firewall restrictions, it may be necessary to open the port 25034 that is the port used for the remote connection to our cloud server.
Please inform support@hyperlean.eu if you wish to use a different port.

Press right mouse button on the “AddRegistryKeys_64bit.reg” file that you pasted in your desktop and click on “Merge”.

Press “Yes” and “Ok” on the next two windows that will open.

Open the shared “…\LeanDESIGENER _Deploy\ClickOnce” folder and double click on the “Setup.exe” to install LeanDESIGENER. The LeanDESIGENER setup process will automatically start.

In every machine where LeanDESIGENER is installed for the first time, some prerequisites will be automatically installed.

Click “Install” to accept the installation of the necessary prerequisites.

Next pictures show the installation progress.

The installation of the prerequisites is not always necessary: if a previous release of LeanDESIGENER had been installed on that client, they will not be installed again.

Amongst orther prerequisites, the “Hyperlean S.r.l.” certificate of authenticity will be installed: click “Yes” in the following windows.

After the installation of all prerequisites, the LeanDESIGENER installation will start.

Once the installation has ended, the login window of LeanDESIGENER will open: Select language, type username and password and click “Ok”.

Wait for the LeanDESIGENER interface to open.

If you run into any problems, contact support@hyperlean.eu.