Wiki

Scale Your Enterprise

User Tools

Site Tools


bizweaver:installation

This is an old revision of the document!


Installation & Upgrade

Installation and updates follow the same set of steps. The only difference is that the Server Configuration values defined in a previous installation will automatically be displayed in an update. The values can be used by clicking [Next] to continue.

Basic Installation

  • Obtain the installation package from Third Wave Business Systems. This will typically be provided in an archive (.Zip format) file.
  • Extract the installation files from the archive on your local system.
  • Move to the folder containing the installation files.
  • Right-click on the ”setup.exe” file. Use the “Run as Administrator” option for the installation.
  • The initial installer screen is displayed.
  • The installation process can be ended at any step by clicking [Cancel] and confirming that you wish to quit.

  • Click [Next] to continue.

Review License Agreement

  • Click “I accept the agreement” to continue. If you do not wish to continue, select “I do not accept the agreement” or click [Cancel], and the process will terminate.
  • Click [Next] to continue.

Choose the Installation Location

  • Confirm or change the installation location for the Bizweaver application.
  • Click [Next] to continue.

Bizweaver Configuration

An application called “Bizweaver Configurator” is automatically launched. This application will configure Bizweaver for use.

Installations require that the information described in the following steps be entered manually.
Upgrades will automatically fill in the information provided in the previous configuration.

  • Click [Next] for each step unless a value needs to be changed.

  • Define the SQL Server where the database is located. This may, or may not, be the server where Bizweaver is installed.
  • The database used by Bizweaver can be anything you wish, but it is not a database used by SAP Business One.
    • A typical name is “bwCommon”.
    • The configuration process will create the database if it does not exist.
  • Enter a SQL Server user.
    • This user must be assigned to the “sysadmin” and “public” SQL Server roles (this is the default for the ‘sa’ user).
  • Enter the password for the designated SQL Server user.
  • Define the timeout period for SQL Server actions. This timeout value is only used in the designer.
    • Timeout settings for connections used for actual processing are defined in the Global Connections setup.
    • The default value of 30 should be adequate for most installations but may be increased if timeout errors are seen in the designer functions.
  • The number of days to retain log files is set to a default value is 30 but can be adjusted up or down as desired.
    • A value of 3, 4, or 5 is usually adequate for most installations.
  • Enter your SAP Business One installation ID or other ID provided by Third Wave Business Systems.
  • Click [Next] to save the settings and continue.
  • Bizweaver provides a web service to allow the execution of workflows from a remote application.
    • Windows IIS must active to complete this setup.
    • If Versago has been installed on this server, the appropriate settings will be determined by the application. The various fields will not be accessible so that you can proceed to the next step.

  • If Versago has NOT been installed, the desired settings can be entered.
  • Any valid port can be assigned. A common value that should work in most instances is 8082 unless HTTPS is in use. In this case, use port 443.
  • The process will halt if a port that is already in use is assigned. Change the port value to continue.
  • The final configuration step is a summary screen with all details is displayed.

  • Click [Finish]. The Bizweaver application is automatically launched.

Final Installation Steps

The basic installation of Bizweaver is now complete.

  • Update the login user for the Bizweaver Service service to use the designated domain user described in the environment requirements.

Upgrading Bizweaver

Be sure that all instances of the Bizweaver application are ended before beginning the update. You can check this using the Windows Task Manager > Users tab. Do not begin the upgrade if any instances are open.

If Bizweaver will be upraded into a new environment, you must install the original version of Bizweaver in the new environment and then execute the upgrade

To upgrade Bizweaver, follow the installation instructions as outlined above. Bizweaver workflows are stored in the database so that they will remain intact during the upgrade process.

Bizweaver Workflow Upgrade Wizard

A wizard will run after the upgrade completes. This wizard opens and saves each workflow to update any tools that have been upgraded in the newest release of Bizweaver.

  • The wizard will process through all workflows in a Bizweaver instance.

  • Once the wizard is complete, a list of all errors, if any, will be displayed.
    • Open Log This will open a text document with all errors displayed in the wizard.
    • OK This will close the wizard and proceed to Bizweaver.
  • To manually upgrade any workflow that failed, open the indicated workflow, fix the error, and save.
  • If no errors are encountered, the wizard will close, completing the upgrade process.

Post Upgrade Testing

After an upgrade, it is recommended to check some crucial areas of Bizweaver to confirm the upgrade was successful. This should be standard after all upgrades.

  • Check all connections
    • Confirm all connections that are in use have the required fields populated.
  • Test all active workflows.
    • Check all steps the steps in workflows ensuring no changes have been made.
    • Test run the workflows that are in use to ensure they are working as anticipated.

Final Upgrade Steps

  • Check the Bizweaver Service service and confirm that the designated domain user described in the environmental requirements is still in place. Reset the user if it is not.

Removing Bizweaver

Uninstall Bizweaver via the standard Windows uninstall process in “Programs and Features” in Control Panel.

  • Uninstall the programs “BWPortal” and “Bizweaver.”
  • Remove the IIS website “BW Service.”
  • Delete the folder C:\Program Files\Bizweaver
  • Delete the folder C:\ProgramData\Bizweaver

File System and SQL Server Access

Windows Services

Bizweaver utilizes two Windows services. These are Bizweaver Service and, in SQL SAP Business One environments, SAP Business One DI Server. By default, both services use the “Local System” user.

A domain user specifically defined for this purpose should always be used for these services with the following characteristics:

  • Security to access any local and shared folders that may be used in Bizweaver processing.
  • Access to any applications (e.g. FTP client) that may be used in Bizweaver processing.
  • The password should be set to “Never Expire”.

File System

  • Log files are written to C:\ProgramData\Bizweaver. The application must have read & write access to this location.

Home

bizweaver/installation.1712862643.txt.gz · Last modified: 2024/04/11 15:10 by dlee