This is an old revision of the document!
2. Installing Produmex Manufacturing Add-on
2.1. Install add-on
2.1.1. On Premise
2.1.1.1. Registering the Add-On
Extract the content of the .zip file on your local machine.
The .zip file contains two files:
- BXManufacturingAddOnSetup.ard
- BXManufacturingAddOnSetup.exe
In SAP Business One, open the Add-On Administration window (Main menu > Administration > Add-Ons > Add-On Administration).
Click on 'Register Add-On' button.
Click on the '…' button beside the Registration Data File and browse the %add-on%.setup.ard file, where the %add-on% is the name of the add-on. SAP Business One will fill out the path to the .exe file automatically.
If you check the box 'Install as Part of Registration', the add-on will be installed right away, if the checkbox is unchecked, you have to restart SBO to start the installation. Click on the 'Ok' button.
2.1.1.2. Proceeding with the installation
If the 'Install as Part of Registration' checkbox was turned on, the installation will start right away with starting the install wizard. Click on the 'Next' button to start the installation.
Accept the End-User License Agreement by selecting the 'I accept the agreement' option, and then click on the 'Next' button.
Make sure all components are checked and that there is enough disk space. Click on the 'Next' button.
Click on the 'Install' button to proceed with the installation.
If the installation process takes too long time, then SAP Business One will ask you if the installation finished successfully.
If the installation was successful, click on the 'Yes' button.
Please note: If there was an error during installation, it will be failed regardless of your answer.
2.1.1.3. Activating the Add-on
You can see now the Produmex add-on under Company-Assigned Add-Ons, on the right part of the window.
Make sure the 'Active' box is checked.
Change the Default Group from 'Disabled' to 'Manual' or 'Automatic'.
- 'Automatic' means the add-on will launch each time you start SAP Business One.
- 'Manual' means you have to launch the add-on manually after each time you start SAP Business One. It is advised to use this option during the configuration phase.
Click on the 'Update' button to save the changes.
2.1.2. In SAP cloud
2.1.2.1. Install the add-on 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.
The zip folder is named: ProdumexManufacturing_AddOnSetup_<version number>_<SBO version number>_<environment>_lightweight.zip
On the Could 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 Manufacturing add-on. Confirm that you would like to synchronize all extensions.
If the installation is successful, on the opening Synchronization Report the status on the line of the Produmex Manufacturing add-on is 'Successful'. The installation zip is automatically moved to the Produmex Shared Repository folder.
2.1.2.2. Deploy the add-on to the Service Unit
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.
Next deploy the add-on on every service unit where you would like to use it.
Navigate to Landscape Management > Service Units. On the Service Units grid select the target service unit.
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 Manufacturing add-on at the Select Extensions step then finish the deployment.
2.1.2.3. Assign the add-on to the tenant(s)
This step is not required in the case of a version upgrade.
Finally assign the Produmex Manufacturing add-on to the tenant(s) where you would like to use it.
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 Manufacturing add-on, then finish the assignment.
2.2. Database Setup
In SAP Business One navigate to Administration > Add-Ons > Add-On Manager. On the Installed Add-Ons tab select the Produmex Manufacturing add-on and click on the ‘Start’ button.
If the Default Group of the add-on is set to 'Manual', you have to do this step each time you start SAP Business One.
A System Message will open up to ask the user whether to upgrade the database or not. Click on the ‘Yes’ button to upgrade the database.
Please note: On MSSQL, the system will check whether there is a backup created within an hour. If no such backup is detected, a warning will be shown and the add-on exists. Create a backup of the database then restart the add-on.
On the next screen set up the database connection. Enter the database user name and the database password. After the DB Connection is set up, the system will upgrade the database.
After the database structure has been modified, another System Message is displayed. Click on the ‘Yes’ button to add the user-defined fields.
A confirmation is displayed that the the database structure have been modified. Acknowledge the message.
A System Message window warns that the add-on stopped:
The add-on stops and a warning message is shown. Select the ‘Continue working without this Add-on’ option, then restart SAP Business One to apply the changes.
2.3. Running the Add-on
Once SAP Business One has restarted, connect to the current company.
Start the add-on in the Add-On Manager as seen above (Main menu > Administration > Add-Ons > Add-On Manager).
The add-on should be running now.
If you want the add-on to start when you launch SAP Business One, you have to go to Administration window (Main menu > Administration > Add-Ons > Add-On Administration), and select 'Automatic' instead of 'Manual'. Click on the 'Update' button to apply the changes.
The Produmex Manufacturing add-on creates its log files at %appdata%\BX\Logs of the user that is assigned to the service. If it runs with local system account, then the log files are at: c:\Windows\SysWOW64\config\systemprofile\AppData\Roaming\BX\Logs (Please note: This is the Windows default setting, it can change based on Windows configuration).
Please note: Fonts will not be registered during a lightweight installation. In order to print barcodes for Produmex Manufacturing reports, install the fonts manually. You can download the fonts from here: Download fonts.