This is an old revision of the document!
3.2.2. Produmex License Server configuration
Starting from version 18.4 the license module uses the Boyum IT portal for the licenses. This means that the old license file cannot be used anymore. So when upgrading from a version older than 18.4 to version 18.4 or higher, you need to make sure that you have a license on the Boyum IT Portal.
3.2.2.1. Running the Produmex License Configurator
Run the Produmex License Configurator as follows.
- Option 1: On Produmex Suite Installer, click on the
Config
button on the line of the installed Produmex License Server. On the opening form click on theRun
button to start the license configurator.
- Option 2: Run the Produmex License Configurator file. The file name is: Produmex.Sbo.Logex.Licensing.Configurator.exe
The file is located in for example: C:\Program Files (x86)\Produmex\Produmex License Server
Make sure that the License Configurator is started in Administrator mode.
3.2.2.2. The license file – online and offline solutions
The License Configurator offers two different options of licensing, automatic and manual:
Automatic licensing is an online licensing option implying that with active Internet connection your license is automatically downloaded from the Boyum IT portal.
In contrast, 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 on.
- If you wish to 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 wish to switch from manual to automatic licensing in the future, the current license remains in the system until the new license file has been downloaded from the portal. Once it is downloaded, the system will use your online license instead of the previously added manual one.
The next sections will describe the steps of the automatic and the manual licensing process in details.
3.2.2.2.1. Online solution: automatic licensing
When you open the License Configurator, the automatic option is checked in by default, therefore the License Configurator will try to download your licensing data from the Boyum IT portal automatically.
If you have active Internet connection and your license can be downloaded, you will see the following message:
Click OK
and no further action is needed from your side.
Hereinafter, if you have no internet connection in the future, the License Configurator uses the online license it has downloaded from the Boyum Portal last time.
Please continue with section 3.2.2.3 The License Configurator window.
3.2.2.2.2. Offline solution: manual licensing
In case you are not connected automatically to the license system or you have no active internet connection, you will see the following error message:
1. Click OK
and select the Manual option.
2. At this point the License Configurator sends the automatic message that your offline license file cannot be retrieved. Click OK
.
3. Visit the offline license generator of Boyum IT Portal to get your license data.
4. On the appearing Get Manual License screen
- fill in the Installation Number field,
- select Produmex WMS Professional – User license in the drop-down Product list,
- click
Submit
.
Fore more information on how to obtain a manual license, please click here.
The portal displays your license data as follows:
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 window click on the Choose new license file
button and browse 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 configurations and then click OK
.
9. Restart the service by clicking on the Restart Service
button. At this point you are informed that the license server has started. Click OK
.
3.2.2.3. The License Configurator window
a) On 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 has to 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.
b) 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.2.2.4. License types
3.2.2.4.1. Produmex WMS Professional (Add-On)
The license that is needed to run the add-on in SAP Business One. On the license configuration this is called ‘AddOnUser’.
Add-On licenses have to be assigned to specific user(s). The number of the assigned users is not limited. Only assigned users are entitled for a Produmex License.
To assign users to the add-on license, first select the company on the top of the Assigned Names section. Then select the license type from the ‘Show available names for type’ dropdown menu. Under ‘Available’ every user available from the selected company is listed. Select the name and click on the left arrow icon to assign it to the selected license type. To retract a user, select its line from the Assignments list and click on the right arrow icon.
If different companies have different users, they all have to be configured in the same Produmex license server. You have to get the list of users for each connection string, and assign them all together into a single list of assigned users.
The sequence of the assigned users has no impact on license allocation.
The number of the available licenses defines the number of users that can use the Produmex Add-On concurrently. If there are more users than the number of licenses, the principle of “first come, first served” will be applied.
Each time a user starts the add-on, the system will check whether the user is an assigned user and whether there is a free license that can be allocated for the user:
- If the user is not an assigned user, no license will be allocated for the user.
- If the user is an assigned user and there is a free license, the system will allocate it to the user.
- If the user is an assigned user and there is no free license, no license will be allocated for the user.
After the user logs out, the system will deallocate the license from the user.
The Produmex Add-On will load even though there is no allocated license for the user. When the user tries to open a function that requires a license, an error message will be displayed.
Please note: One user can only be assigned once, even though multiple databases contain the same user. If a given user is logged in one database, the user can only log in another database if there is a free license. If a user is logged in two databases, he/she uses two licenses.
3.2.2.4.2. Produmex WMS Terminal (Device Client)
The license that is needed to run flows on the device (typically a scanner or a touchscreen). On the license configuration this is called ‘DeviceUser’.
The terminal licenses are unassigned licenses. If the license has to be assigned, it can be assigned to every thin client defined in the Organizational Structure of the company. The number of the assigned clients is not limited.
Device clients have concurrent licensing meaning that licenses do not have to be assigned to a certain client, but instead the system will allow as many concurrent connections as the total number of available licenses.
Each time logging in on a client, the system will check whether there is a free license slot that can be allocated for the client.
- If there is a free license, the system will allocate it to the client.
- If there is no free license, an error message will be displayed.
After the logout, the system will deallocate the license from the client.
3.2.2.4.3. Produmex 3PL Module
The license that is needed to use the 3PL invoicing functionality. On the license configuration this is called ‘Mod_3PL’.
This license is an ‘Unassigned’ license. There is 99999 licenses available, which means that when the Mod_3PL license is active, every add-on user has access to the 3PL invoicing functionality.
3.2.2.4.4. Produmex EDI Interface
The license that is needed to use the additional functionality for EDI messages. On the license configuration this is called ‘Mod_EDI’.
This license is an ‘Unassigned’ license. There is 99999 licenses available, which means that when the Mod_EDI license is active, every add-on user has access to the EDI functionality.