======3.5. Register the Produmex add-on======

The following section describes the steps of registering the Produmex add-on component in SAP Business One on premise (section [[implementation:wms:install_registeraddon#register_the_add-on_on_premise|3.5.1]]) or on the Cloud Control Center (section [[implementation:wms:install_registeraddon#register_the_add-on_in_SAP_cloud|3.5.2]]).

Note: Make sure that you run the SAP Business One Client as administrator.

=====3.5.1. Register the add-on on premise=====

1. In SAP Business One navigate to Administration > Add-Ons > Add-On Administration.

2. Click the ''Register Add-On'' button. 

3. Click the ''…'' button and browse the add-on loader installation .ard file.  

The installation file is located in the installation zip folder \<//SBO Version//>\AddOnLoader. 

{{ :implementation:install:boyum:add-on_registration.png |Add-on Registration}}

When selecting the file, the associated add-on installation package is also opened. 

{{ :implementation:install:boyum:29._installation_package.png |Installation Package}}

4. Check the //Install as Part of Registration// checkbox and click ''OK''. 

{{ :implementation:install:boyum:30._install_as_part_of_registration.png |Install as Part of Registration}}

5. On the Add-on Installer screen select the installation folder, then click ''Next'' and then ''Finish''. 

{{ :implementation:install:boyum:installation.png |Add-on Installer}}

6. When the installation is finished, restart SAP Business One.

7. In SAP Business One navigate to Administration > Add-Ons > Add-On Administration.
 
8. On the //Company Preferences// tab select the Produmex Add-On Loader. Select the //Active// checkbox and set the Default Group. 

From 2020, Produmex WMS version number contains 15 characters. In the Version column of the Add-on Administration window, SAP Business One 9.3 displays the first 13 characters of the installed add-on version. 

The version number of the installed add-on loader can be found in the Add-On Name column.

{{ :implementation:install:boyum:add-on_registration_3.png |Add-on Administration}}

9. On the //User Preferences// tab select the user //manager// and make sure that the Preferences is set to the required value for the Produmex Add-on Loader.

10. Click ''Update''.

{{ :implementation:install:boyum:add-on_registration_04.png |User Preferences}}

Continue with section [[implementation:wms:install_registeraddon#update_database|3.5.3. Update database]].

=====3.5.2. Register the add-on on the Cloud Control Center=====

====3.5.2.1. Install the Add-On Loader on the Cloud Control Center====

1. Create a Produmex subfolder within the folder you defined as the Extension Repository Path in Cloud Control Center. 

2. Upload the zip folder of the lightweight installer to this Produmex folder. Do not unzip the file.

The zip folder is named: \\
''Produmex_WMS_<//versionnumber//>.<//SBOversion//>_AddOnLoader_lightweight.zip.''

It can be found in the installation zip folder of Produmex WMS: Produmex_WMS_<//versionnumber//>.<//SBOversion//>\<//SBOversion//>\AddOnLoader.

<WRAP round info>Regardless of the environment displayed in the name of the Produmex WMS installation folder, the lightweight installer zip contains both the x32 bit and the x64 bit installation files.</WRAP>

3. On the Cloud Control Center, navigate to Landscape Management > Extensions.

4. Check whether the installation file is listed on the //Extensions// grid. 

5. Click the ''Synchronize All'' button to install the Produmex Add-On Loader and confirm that you would like to synchronize all extensions by clicking ''Yes''.

{{ :implementation:install:boyum:cloud_1.png |Register the add-on in SAP Cloud}}

If the installation is successful, the status of the Produmex Add-On Loader is successful on the Synchronization Report screen. The installation zip is automatically moved to the Produmex Shared Repository folder. 

{{ :implementation:install:boyum:cloud_2.png |Register the add-on in SAP Cloud}}

====3.5.2.2. Deploy the Add-On Loader to the Service Unit====

<WRAP round important>When upgrading the add-on to a new version, make sure that the add-on is not running on any presentation server. If there is a running add-on, the upgrade will fail.</WRAP>

The next step is to deploy the add-on loader on every service unit where you would like to use it.

1. Navigate to Landscape Management > Service Units.

2. Select the target service unit on the Service Units grid.

3. To to the //Extensions// tab on the //Service Unit Details// grid and click the ''Deploy'' button. 

4. Follow the steps of the Extension Deployment Wizard. 

5. Select the Produmex Add-On Loader at the //Select Extensions// step, then finish the deployment.

{{ :implementation:install:boyum:cloud_3.png |Register the add-on in SAP Cloud}}

====3.5.2.3. Assign the add-on loader to the tenant(s)====

The next step is to assign the Produmex Add-On Loader to the tenant(s) where you would like to use it.

Note: This step is not required for a version upgrade.

1. Go to Customer Management > Tenants. 

2. Select the tenant on the //Tenants// grid. 

3. Navigate to the //Extensions// tab on the //Tenant Details// grid and click the ''Assign'' button. 

4. Follow the steps of the Extension Assignment Wizard. 

5. Select the Produmex Add-On Loader In the //Select Extensions// step, then finish the assignment.

{{ :implementation:install:boyum:cloud_4.png |Register the add-on in SAP Cloud}}

=====3.5.3. Update database=====

Note: This step is not required for a version upgrade.

1. In SAP Business One navigate to Administration > Add-Ons > Add-On Manager > Installed Add-Ons tab. 

2. If the Produmex Add-On Loader is not running, select it and click ''Start''. The Produmex WMS add-on is started.