==== 3.3.2. Configure the Produmex License Server ====

<WRAP round important>From product version 18.4 the license module uses the Boyum IT portal and the old license file cannot be used anymore.
When upgrading from a version older than 18.4 to version 18.4 or higher, make sure that you have a license on the [[https://license.boyum-it.com/Account/Login?ReturnUrl=%2F|Boyum IT Portal]].</WRAP>

=== 3.3.2.1. Running the Produmex License Configurator ===

1. On the Produmex Suite Installer screen click on the ''Config'' button of the Produmex License Server. The Produmex License service uses port 9997 to communicate with the WMS add-on. Port 9997 should be open on the Firewall.

2. Click on the ''Run'' button on the form that opens to start the license configurator. 

Note: In the future the Produmex License Configurator can also be started by running the Produmex.Sbo.Logex.Licensing.Configurator.exe file. Make sure that the License Configurator is started in Administrator mode. (Example of file location: C:\Program Files (x86)\Produmex\Produmex License Server)

=== 3.3.2.2. The license file – online and offline solutions ===

The License Configurator offers two different options of licensing, **automatic** and **manual**:

{{ :implementation:wms:license:10.automatic_vs_manual_options.png |}}

**Automatic licensing is an online licensing option**. With active Internet connection your license is automatically downloaded from the Boyum IT portal.

**Manual licensing is an alternative offline solution.** If you have a problem with automatic licensing, for example you do not have active internet connection, manual licensing makes it possible to add your license data manually. In this case you can obtain the data from the offline license generator of the Boyum IT Portal.

It is also possible to switch between the two options later.
  * If you switch from automatic to manual licensing in the future, the current license remains in the system until you add a new license file manually. 
  * If you switch from manual to automatic licensing in the future, the current license remains in the system until the new license file is downloaded from the portal. Once it is downloaded, the system uses your online license instead of the previously added manual one.

The next sections describe the steps of the automatic and the manual licensing process in details.

== 3.3.2.2.1. Automatic licensing ==

When you open the License Configurator, the Automatic license type is checked by default and the License Configurator tries to download the licensing data from the Boyum IT portal automatically. 

If you have an active internet connection and the license can be downloaded, you will see the following message:

{{ :implementation:install:boyum:20._new_automatic_license_file_loaded.png |Automatic License File Loaded}}

1. Click ''OK''.

2. Click ''Save Configuration'', then click ''OK''.

3. Click ''Restart Service'', then click ''OK''.

Note: If you lose internet connection in the future, the License Configurator will use the online license it has downloaded from the Boyum Portal last time.

If you do not need manual licensing, continue with section [[implementation:wms:install_licenseconfig#the_license_configurator_window|3.3.2.3 The License Configurator window]].

== 3.3.2.2.2. Manual licensing ==

If you are not automatically connected to the license system or you have no active internet connection, you will see the following error message:

{{ :implementation:install:boyum:21._online_license_cannot_be_retrieved.png |Online License Cannot be Retrieved.}}

1. Click ''OK'' and select the Manual option.

2. The License Configurator sends the automatic message that your offline license file cannot be retrieved. Click ''OK''.

{{ :implementation:install:boyum:22._offline_license_cannot_be_retrieved.png |Offline License Cannot be Retrieved}}

3. Visit the [[https://license.boyum-it.com/licensekey|offline license generator of Boyum IT Portal]] to get the license data.

4. On the //Get Manual License// screen proceed as follows:
  - Fill in the //Installation Number// field.
  - Select the //Produmex WMS Professional – User license// in the drop-down Product list.
  - Click ''Submit''. 

Note: For more information on the installation number click [[https://support.boyum-it.com/hc/en-us/articles/226546427-How-to-get-a-manual-license|here]].

{{ :implementation:wms:license:get_manual_license.png |Get manual license}}

The portal displays the license data as follows: 

{{ :implementation:wms:license:license_data_portal.png |License data}}

5. Copy all the data to a new document of a text editor and save it to your local drive as a txt file. This will be your license file.

6. On the License Configurator screen click on the ''Choose new license file'' button and browse for the license file.

7. The License Configuration informs you that your manual license file has been loaded. Click ''OK''.

8. Click on the ''Save configuration'' button to save the configuration and then click ''OK''.

9. Restart the service by clicking on the ''Restart Service'' button. You are informed that the license server has started. Click ''OK''.

=== 3.3.2.3. The License Configurator window ===

{{ :implementation:install:boyum:23._license_configurator_window.png |The License Configurator Screen}}

In the Licenses section every license from the license file is listed. 

License parameters:
  * Type: The type of the license. 
  * Valid Till: The expiration date of the license.
  * Count: The number of licenses. 
  * Use Assigned Name (Y/N): Defines whether a user must be assigned to the license or not. If the ‘UseAssignedName’ option is active for a license, you have to link user(s) to the license.

Under //Assigned Names// every company that is included in the configuration file of the license manager is listed. (//Produmex.Sbo.Logex.Licensing.Configurator.exe//)
  * Connection name
  * Company

Licenses that are currently in use are listed on the ‘Active licenses’ tab.
  * License type: The license type. 
  * Assigned name: The SBO user/ thin client that is using the license.
  * User name: The Windows user that is using the license.
  * User domain: The server/PC where the license is being used.
  * Process ID: The Process ID that is using the license.

=== 3.3.2.4. License types ===

<WRAP center round tip 100%>
Click [[https://support.boyum-it.com/hc/en-us/articles/360009856517-WMS-Licensing|here]] and consult with the article on Produmex WMS licensing for more information.
</WRAP>

**1. Produmex WMS Professional license (Add-On)**\\
It is required to run the add-on in SAP Business One. On the License Configurator screen this is called //AddOnUser//. 

Add-on licenses must be assigned to specific user(s). The number of assigned users is not limited. Only assigned users are entitled to a Produmex License. 

The number of the available licenses defines the number of users that can use the Produmex WMS add-on concurrently. If there are more users than the number of licenses, the principle of “first come, first served” is applied.

Each time a user starts the add-on, the system checks whether the user is an assigned user and whether there is a free license that can be allocated to the user: 
  * If the user is not an assigned user, no license is allocated to the user.
  * If the user is an assigned user and there is a free license, the system allocates it to the user.
  * If the user is an assigned user and there is no free license, no license is allocated to the user. In this case the Produmex WMS add-on can be started, but when the user tries to open a function that requires a license, an error message is displayed. 

After the user logs out, the system deallocates the license from the user. 

Note: One user can only be assigned once even if multiple databases contain the same user. If a given user is logged in to one database, the user can only log in to another database if there is a free license. If a user is logged in to two databases, the user uses two licenses.

**2. Produmex WMS Terminal license (Device Client)** \\
It is required to run flows on the Fat Client (a scanner or a touchscreen). On the License Configurator screen this is called //DeviceUser//.

The terminal licenses are unassigned licenses. If the license must be assigned, it can be assigned to every Fat Client defined in the Organizational Structure of the company. The number of assigned clients is not limited.

Device clients have concurrent licensing, that is, licenses do not have to be assigned to a certain client. Instead the system allows as many concurrent connections as the total number of available licenses.

Each time logging in on a client, the system checks whether there is a free license slot that can be allocated to the client.
  * If there is a free license, the system allocates it to the client.
  * If there is no free license, an [[support:supportguidev2:licenseissues#no_fat_client_license_available|error message]] is displayed.

After the logout, the system deallocates the license from the client.

**3. Produmex 3PL Module** \\
It is required to use the [[implementation:wms:3plprocess|3PL invoicing]] functionality. On the License Configurator screen this is called //Mod_3PL//.

This license is an //unassigned// license. There are 99999 licenses available and when the Mod_3PL license is active, every add-on user has access to the 3PL invoicing functionality.

**4. Produmex EDI Interface** \\
It is required to use the additional functionality for [[implementation:wms:edi_module|EDI messages]]. On the License Configurator screen this is called //Mod_EDI//.

This license is an //unassigned// license. There are 99999 licenses available and when the Mod_EDI license is active, every add-on user has access to the EDI functionality.

=== 3.3.2.5. License assignment ===
To assign users to licenses, proceed as follows.

{{ :implementation:install:boyum:24._license_assignment.png |License Assignment}}

1. Select the company on the top of the //Assigned Names// section. 

2. Select the necessary license type from the //Show available names for type// drop-down menu. Under //Available// every user available from the selected company is listed. 

3. Select the name and click on the left arrow icon to assign it to the selected license type.  \\
If different companies have different users, they all have to be configured on the same Produmex license server. You must get the list of users for each connection string and assign them all together into a single list of assigned users.
 
Note: The sequence of the assigned users has no impact on license allocation. 

4. Click ''Save Configurations'' and close the License Configurator screens. 

The [[implementation:wms:install_notificationlistener|next section]] describes the configuration steps of Produmex SB1 Notification Listener. If you do not need this component, click ''Save'' on the Produmex Suite Installer screen and close the screen. Continue with section [[implementation:wms:install_storedprocedures|3.4. Adaptation of Stored Procedures]].