implementation:wms:install_registeraddon
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
implementation:wms:install_registeraddon [2018/06/29 13:14] csuhaa 18.2 |
implementation:wms:install_registeraddon [2020/01/17 15:11] (current) vise |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ======3.4. Registering the Produmex add-on====== | + | ======3.5. Register the Produmex add-on====== |
| - | For our next step we need to register the Produmex add-on component in Sap Business One. | + | |
| - | <WRAP round important>Make sure you run SAP Business One Client as administrator.</WRAP> | + | 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 in SAP Cloud (section [[implementation:wms:install_registeraddon#register_the_add-on_in_SAP_cloud|3.5.2]]). |
| - | =====3.4.1. Install the add-on===== | + | |
| - | ====3.4.1.1. On Premise==== | + | |
| - | ===3.4.1.1.1. Install Add-On loader=== | + | |
| - | In SAP Business One open the Add-On Administration window from Administration > Add-Ons. Click on the ‘Register Add-On’ button. On the opening Add-on Registration form browse the add-on loader installation .ard file after clicking on the ‘…’ button. The installation file is located in the installation zip folder \<//SBO Version//>\AddOnLoader. Selecting this file also opens the associated add-on installation package. Check the ‘Install as part of Registration’ checkbox and click on ‘OK’. | + | |
| - | {{ :implementation:wms:installation:register_addon.png |}} | + | Note: Make sure that you run SAP Business One Client as administrator. |
| - | On the opening add-on installer select the installation folder, then press ‘Next’. After the installation is finished, SAP Business One needs to be closed and restarted. | + | =====3.5.1. Register the add-on on premise===== |
| - | {{ :implementation:wms:installation:confirm_install.png?400 |}} | + | 1. In SAP Business One navigate to Administration > Add-Ons > Add-On Administration. |
| - | ===3.4.1.1.2. Set preferences=== | + | 2. Click on the ''Register Add-On'' button. |
| - | Start SAP Business One and navigate to Administration > Add-Ons > Add-On Administration. On the ‘Company Preferences’ tab select the Produmex Add-On Loader. Tick the ‘Active’ checkbox and set the Default Group. | + | |
| - | {{ :implementation:wms:installation:set_preferences.png |}} | + | 3. Browse the add-on loader installation .ard file after clicking on the ''…'' button. The installation file is located in the installation zip folder \<//SBO Version//>\AddOnLoader. |
| - | On the ‘User Preferences’ tab select the user ‘manager’ and verify that for the Produmex Add-On Loader the Preferences is set to the wished value. | + | {{ :implementation:install:boyum:28._add-on_registration.png |Add-on Registration}} |
| - | ====3.4.1.2. In SAP cloud==== | + | When selecting this file, the associated add-on installation package is also opened. |
| - | ===3.4.1.2.1. Install the Add-On Loader on the Could Control Center=== | + | |
| - | Create a Produmex sub folder within the folder you defined as the Extension Repository Path in Cloud Control Center. Upload the zip folder of the lightweight installer to this Produmex folder. Do not unzip the file. | + | {{ :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:31._add-on_installer.png |Add-on Installer}} | ||
| + | |||
| + | 6. When the installation is finished, close and then 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. | ||
| + | |||
| + | {{ :implementation:install:boyum:32._add-on_administration.png |Add-on Administration}} | ||
| + | |||
| + | 9. On the //User Preferences// tab select the user //manager// to check if the Preferences is set to the required value for the Produmex Add-on Loader. | ||
| + | |||
| + | 10. Click ''Update''. | ||
| + | |||
| + | {{ :implementation:install:boyum:33._user_preferences.png |User Preferences}} | ||
| + | |||
| + | Continue with section [[implementation:wms:install_registeraddon#update_database|3.5.3. Update database]]. | ||
| + | |||
| + | =====3.5.2. Register the add-on in SAP Cloud===== | ||
| + | |||
| + | ====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: \\ | The zip folder is named: \\ | ||
| Line 32: | Line 58: | ||
| <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> | <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> | ||
| - | On the Could Control Center, navigate to Landscape Management > Extensions. | + | 3. On the Cloud Control Center, navigate to Landscape Management > Extensions. |
| - | Check whether the installation file is listed on the //Extensions// grid then press the ‘Synchronize All’ button to install the Produmex Add-On Loader. Confirm that you would like to synchronize all extensions. | + | 4. Check whether the installation file is listed on the //Extensions// grid. |
| - | {{ :implementation:wms:installation:sync.png |}} | + | 5. Click on the ''Synchronize All'' button to install the Produmex Add-On Loader and confirm that you would like to synchronize all extensions by clicking ''Yes''. |
| - | If the installation is successful, on the opening Synchronization Report the status on the line of the Produmex Add-On Loader is successful. The installation zip is automatically moved to the Produmex Shared Repository folder. | + | {{ :implementation:wms:installation:sync.png |Register the add-on in SAP Cloud}} |
| - | {{ :implementation:wms:installation:sync_report.png?400 |}} | + | 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:wms:installation:sync_report.png?400 |Register the add-on in SAP Cloud}} | ||
| + | |||
| + | ====3.5.2.2. Deploy the Add-On Loader to the Service Unit==== | ||
| - | ===3.4.1.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> | <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> | ||
| - | Next deploy the add-on loader on every service unit where you would like to use it. | + | 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:wms:installation:deploy.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. | ||
| - | Navigate to Landscape Management > Service Units. On the //Service Units// grid select the target service unit. | + | 4. Follow the steps of the Extension Assignment Wizard. |
| - | On the //Service Unit Details// grid go to the //Extensions// tab and click on the Deploy button. Follow the steps of the Extension Deployment Wizard. Select the Produmex Add-On Loader at the //Select Extensions// step then finish the deployment. | + | 5. Select the Produmex Add-On Loader In the //Select Extensions// step, then finish the assignment. |
| - | {{ :implementation:wms:installation:deploy.png |}} | + | {{ :implementation:wms:installation:tenant.png |Register the add-on in SAP Cloud}} |
| - | ===3.4.1.2.3. Assign the add-on loader to the tenant(s)=== | + | =====3.5.3. Update database===== |
| - | Finally assign the Produmex Add-On Loader to the tenant(s) where you would like to use it. | + | |
| - | <WRAP round important>This step is not required in the case of a version upgrade.</WRAP> | + | Note: This step is not required for a version upgrade. |
| - | Go to Customer Management > Tenants. Select the tenant on the //Tenants// grid. On the //Tenant Details// grid navigate to the //Extensions// tab, then click on the ‘Assign’ button. Follow the steps of the Extension Assignment Wizard. In the //Select Extensions// step select the Produmex Add-On Loader, then finish the assignment. | + | 1. In SAP Business One navigate to Administration > Add-Ons >Add-On Manager > //Installed Add-Ons// tab. |
| - | {{ :implementation:wms:installation:tenant.png |}} | + | 2. If the Produmex Add-On Loader is not running, select it and click ''Start''. |
| - | =====3.4.2. Update database===== | + | {{ :implementation:install:boyum:34._add-on_manager_screen.png |Add-On Manager}} |
| - | <WRAP round important>This step is not required in the case of a version upgrade.</WRAP> | + | |
| - | In SAP Business One navigate to Administration > Add-Ons >Add-On Manager > ‘Installed Add-Ons’ tab. If the Produmex Add-On Loader is not running, select it then click on ‘Start’. | + | 3. Click on the ''Update Database'' button to perform the required database changes. If the database is already updated, //Database up-to-date// checkbox is checked and this step can be skipped. |
| - | {{ :implementation:wms:installation:start_addon.png?400 |}} | + | 4. Click on the ''Set DB credentials'' button. |
| - | On the opening screen click on the ‘Update database’ button to perform the needed database changes. If the database is already updated, ‘Database up-to-date’ checkbox is checked and this step can be skipped. | + | 5. Enter the database credentials on the form. |
| - | Then click on the ‘Set DB credentials’ button. On the opening form enter the DB credentials. After the credentials are set, click on the ‘Exit Add-On’ button to download the files needed for the add-on. | + | 6. After the credentials are set, click the ''Exit Add-On'' button to download the files required for the add-on. |
| - | {{ :implementation:wms:installation:set_db_credentials.png?400 |}} | + | {{ :implementation:wms:installation:set_db_credentials.png?400 |Set database credentials}} |
implementation/wms/install_registeraddon.1530278061.txt.gz · Last modified: 2018/06/29 13:14 by csuhaa
