• SAP HANA Client should be installed on the machine where Bizweaver is installed if you will be connecting to a HANA database to retrieve information.

Beginning with Bizweaver 2.5.8, HANA Client v2.4.167 must be installed on the Versago server. You can download the installation package from https://portal.twbs.com. This client is also used for Versago.

The installation process for this application is slightly different than “normal,” so please follow the instructions.

• Create a folder named “TWBS” in C:\Program Files if it does not exist.
• Extract the HANA client installation package from the download .zip archive.
• Place the HANA client installation in the C:\Program Files\TWBS folder.
• Move to the HANA client folder (C:\Program Files\TWBS\SAP_HANA_CLIENT).
• Right-click on “hdbsetup.exe” and select the “Run as administrator” option.
• Click the “Install new SAP HANA database client” option.
• Select “C:\Program Files\TWBS\SAP_HANA_CLIENT” as the installation location.
• Click <Next> to move through the installation wizard

The installation package should remain in this folder. Removing it will cause issues with some Versago and Bizweaver functionality.

• The name/IP address of the server where the SQL Server database is found, or will be created.
• The user name & password for a SQL Server user with database administrator security.
  • Third Wave recommends that a specific user be created for Versago and Bizweaver rather than using the ‘sa’ (system administrator) user.

• Confirm that your SAP Business One Site ID is set up in Third Wave’s system. This value is used for licensing. You can check to see if it is set up on the TWBS portal (https://portal.twbs.com).

• Review server, server software, and IIS requirements » here. Pay particular attention to the required version of Microsoft .Net Framework.
• Obtain the Bizweaver installation package, which is provided by Third Wave.

The Bizweaver license is generated automatically. There are two requirements for the license process.

• Your SAP Installation ID must be on file in the Third Wave Business Systems license system.
• An active Internet connection to allow communication with the Third Wave license server. The connection must allow access to https://license.twbs.com:444.

• 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.

• 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.

• Confirm or change the installation location for the Bizweaver application.

• Click [Next] to continue.

• A dialog box displays the progress of the installation.

• When the installation is complete, a final dialog screen is displayed.

• Click [Finish] to complete the installation process and begin the configuration process.

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.

• Click [Next] to continue.

• 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 not be 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.
• Click [Next] in the Wizard – Specify Configuration Check List. The checklist can be modified, but it will automatically load whatever data is going to be configured in the next steps. The user does not need to change this.
  
• A list of workflow tools (called “workflow assemblies”) is presented. Do not change any of these options unless instructed to do so by Third Wave support. Click [Next] to continue.
  
• Bizweaver provides a web service to allow 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 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 application will alter Windows DCOM settings on this machine for use with Bizweaver. This is necessary in order for Bizweaver to receive web service calls from Versago.
    
• The final configuration step is a summary screen with all details is displayed.
  
• Click [Finish]. The Bizweaver application is automatically launched.

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.

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

Beginning in Bizweaver 2.5.17 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.

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

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

• For versions prior to 91.1.0.157, uninstall the program “Bizweaver.”
• Beginning with v91.1.0.157, 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

Two Windows services are utilized by Bizweaver. 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. Information about configuring this user is found here.

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

There are two points where a connection to SQL Server is used

• First is in the core configuration described in this document. This is needed, at a minimum, to create the various database objects used by Bizweaver
• Second is in the Global Configuration function.
• Both points require use of a user/password for login. Windows authentication is not supported.

The SQL user needs full access (read, write, execute) for the following tables:

• Whatever database is designated in the installation process
• VersagoData (or whatever database is designated for use with Versago Forms)
• Any SAP Business One databases to be accessed

In many SQL environments it is desirable to use the Bizweaver API to initiate a Bizweaver workflow. A common example is when something occurs in SAP Business One.

To support this type of processing, some configuration in SQL Server is required. The configuration process is outlined here.