Differences

This shows you the differences between two versions of the page.

--- bw:installation_upgrade_guide [2019/10/22 16:47]
akoehler [Information You Will Need]
+++ bw:installation_upgrade_guide [2020/12/14 17:07] (current)
akoehler [Configure SQL Server for Web Service Calls]
@@ Line 7: / Line 7: @@
 ====== Preparation ======
-<WRAP center round important 60%>
+==== HANA Database Connections ====
-Bizweaver requires that Microsoft .Net Framework v4.7.2 or higher be installed before beginning an installation.  The application can be downloaded from Microsoft.  A restart of the server is required after installation.
+  * __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.
+<WRAP center round alert 50%>
+HANA client change beginning with Bizweaver 2.5.8.
 </WRAP>
+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.**
@@ Line 23: / Line 41: @@
 ===== Confirm Environment Requirements =====
-  * Review server, server software, and IIS requirements <color #ed1c24>**>>** </color>[[bw:bizweaver_environment_requirements|here]].  Pay particular attention to the required version of Microsoft .Net Framework.
+  * Review server, server software, and IIS requirements <color #ed1c24>**>>** </color>**//[[bw:bizweaver_environment_requirements|here]]//**.  Pay particular attention to the required version of Microsoft .Net Framework.
   * Obtain the Bizweaver installation package, which is provided by Third Wave.
@@ Line 38: / Line 56: @@
   * 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.
+  * 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.\\ {{:bw:inimage1.png?384x313|VM 2012B 19216812351 Remote Desktop Connection}}
+  * The installation process can be ended at any step by clicking [**Cancel**] and confirming that you wish to quit.\\ {{  :bw:inimage1.png?384x313  |VM 2012B 19216812351 Remote Desktop Connection}}
   * Click [**Next**] to continue.
 ===== Review License Agreement =====
-{{:bw:inimage2.png?384x318}}
+{{  :bw:inimage2.png?384x318  }}
-  * 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 “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.
@@ Line 53: / Line 71: @@
 ===== Choose the Installation Location =====
-{{:bw:inimage3.png?384x313}}
+{{  :bw:inimage3.png?384x313  }}
   * Confirm or change the installation location for the Bizweaver application.
@@ Line 63: / Line 81: @@
     * When the installation is complete, a final dialog screen is displayed.
-{{:bw:inimage4.png?384x312}}
+{{  :bw:inimage4.png?384x312  }}
   * Click [**Finish**] to complete the installation process and begin the configuration process.
@@ Line 71: / Line 89: @@
 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.
+**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.
-{{:bw:inimage5.png?384x286}}
+{{  :bw:inimage5.png?384x286  }}
-Click [**Next**] to continue.
+  * Click [**Next**] to continue.
-{{:bw:inimage6.png?384x288}}
+{{  :bw:inimage6.png?384x288  }}
   * Define the SQL Server where the database is located. This may, or may not, be the server where Bizweaver is installed.
@@ Line 90: / Line 109: @@
     * 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.
+    * **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. \\ {{:bw:inimage7.png?384x286}}
+  * 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. \\ {{  :bw:inimage7.png?384x286  }}
-  * 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. \\ {{:bw:inimage8.png?384x288}}
+  * 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. \\ {{  :bw:inimage8.png?384x288  }}
   * 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. \\ {{:bw:inimage9.png?384x282}}
+    * 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. \\ {{  :bw:inimage9.png?384x282  }}
     * 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. \\ {{:bw:inimage10.png?384x288}}
+    * 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. \\ {{  :bw:inimage10.png?384x288  }}
-  * The final configuration step is a summary screen with all details is displayed. \\ {{:bw:inimage11.png?384x286}}
+  * The final configuration step is a summary screen with all details is displayed. \\ {{  :bw:inimage11.png?384x286
+ }}
   * Click [**Finish**]. The Bizweaver application is automatically launched.
@@ Line 114: / Line 134: @@
 ====== Upgrading Bizweaver ======
-<WRAP center round alert 100%>
+<WRAP center round alert 90%>
 Be sure that all instances of the Bizweaver application are ended before beginning the update.  You can check this using Windows Task Manager > Users tab.  <color #ed1c24>**Do not begin the upgrade if any instances are open**</color>.
 </WRAP>
+<WRAP center round important 90%>
-<WRAP center round important>
 A direct upgrade for installations **prior to version 91.1.0.138** is not supported. In these cases, simply uninstall Bizweaver using the standard Windows uninstall process. Then install the new version of Bizweaver as described above.
@@ Line 129: / Line 148: @@
   * Install the new version of Bizweaver.
 </WRAP>
 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.
-==== Final Upgrade Steps ====
+=== Bizweaver Workflow Upgrade Wizard ===
+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.
+{{ :bw:upgradewindow.png?400 |}}
+  * The wizard will process through all workflows in a Bizweaver instance.
+{{ :bw:upgradewindow2.png?400 |}}
+  * 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.
+=== Final Upgrade Steps ===
   * 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.
@@ Line 153: / Line 187: @@
 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[[https://wiki.twbs.com/doku.php/bw/bizweaver_environment_requirements#bizweaver_user|here]].
+A domain user specifically defined for this purpose should always be used for these services.  Information about configuring this user is found **//[[https://wiki.twbs.com/doku.php/bw/bizweaver_environment_requirements#bizweaver_user|here]]//**.
 ===== File System =====
@@ Line 176: / Line 210: @@
 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 [[SQLWS_Config|here]].  The use of this functionality is found [[SQLWS_Use|here]].
+To support this type of processing, some configuration in SQL Server is required.  The configuration process is outlined **//[[SQLWS_Config|here]]//**.

Wiki

User Tools

Site Tools

Differences

Page Tools