Wiki

Scale Your Enterprise

User Tools

Site Tools

Trace: • Introduction (Roles, Profiles, Users) • Record/Payment Submission • Forms Home • Introduction (ExchangeConnector) • Introduction (Custom Menus)
versago:versago_installation

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
versago:versago_installation [2020/05/13 09:32]
runger [Other Notifications] 		versago:versago_installation [2024/08/26 14:12] (current)
dlee
Line 5: Line 5:
 Versago stores configuration and other related data in a Microsoft SQL Server database. **No other databases for storing configuration information are supported at this time**. The database can be created in an existing SQL Server instance or a new instance can be created. Versago stores configuration and other related data in a Microsoft SQL Server database. **No other databases for storing configuration information are supported at this time**. The database can be created in an existing SQL Server instance or a new instance can be created.
  
-<WRAP center round help 90%>+  * Microsoft SQL Server 2012 or higher  
 +  * Microsoft SQL Server Express 2012 or higher 
 + 
 +<WRAP center round help 80%>
 The above requirement applies only to the storage of configuration information.  Connections to both SQL Server and HANA databases for reporting are supported.  And additional databases may be added in the future based on demand. The above requirement applies only to the storage of configuration information.  Connections to both SQL Server and HANA databases for reporting are supported.  And additional databases may be added in the future based on demand.
 </WRAP> </WRAP>
- 
- 
-  * Microsoft SQL Server 
-    * 2012 or above 
-    * Versago can be used on SQL Server 2008 but the preference is to use a newer version 
-  * Microsoft SQL Server Express 
-    * 2012 or higher 
  
 ==== Important Notifications ==== ==== Important Notifications ====
  
-<WRAP center round alert 90%>+<WRAP center round alert 80%>
 Do not use Microsoft Internet Explorer (IE) for the Versago installation process.  IE is not longer directly supported for Versago and it may, or may not, work as expected.  Download Chrome, Firefox, or any other HTML5-compatible browser and set it as the default on your Versago server. Do not use Microsoft Internet Explorer (IE) for the Versago installation process.  IE is not longer directly supported for Versago and it may, or may not, work as expected.  Download Chrome, Firefox, or any other HTML5-compatible browser and set it as the default on your Versago server.
 </WRAP> </WRAP>
  
-<WRAP center round alert 90%> +<WRAP center round alert 80%> 
-Versago v2.3 and higher 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**.+Versago v2.3 and higher requires that **both** Microsoft .Net Framework v3.5 <color #ed1c24>and</color> .Net Framework v4.7.2 or higher be installed before beginning an installation.  v3.5 should be installed from the Windows Server installation disk. v4.x application can be downloaded from Microsoft.  **A restart of the server is generally required after installation**.
 </WRAP> </WRAP>
  
-<WRAP center round alert 90%>+<WRAP center round tip 80%>
 In some instances we have found that installing Versago can force a server reboot.  We believe it may be associated with having Windows Updates pending.  Be sure there are no pending Windows Updates to help avoid the reboot during the Versago installation.  If there are pending updates, install them first before installing Versago. In some instances we have found that installing Versago can force a server reboot.  We believe it may be associated with having Windows Updates pending.  Be sure there are no pending Windows Updates to help avoid the reboot during the Versago installation.  If there are pending updates, install them first before installing Versago.
 </WRAP> </WRAP>
  
 +===== HANA Database Connections =====
 +
 +The **SAP HANA Client** should be installed on the machine where Versago is installed **if** you will be connecting to a HANA database to retrieve information. This application is automatically installed if SAP Business One for HANA is installed on the machine. An installation package is available from Third Wave Business Systems if it is not already installed.
 +
 +<WRAP center round alert 80%>
 +Beginning with Versago v2.4.11 and higher, HANA Client v2.4 must be installed on the Versago server.  You can download the installation package from https://portal.twbs.com. **This client is also used for Bizweaver.**
 +</WRAP>
 +
 +Please follow these instructions.
 +
 +  * If downloaded from the TWBS portal, extract the HANA client installation package from the .zip archive.
 +  * Use the 64 bit HANA Client
 +  * Right-click on "hdbsetup.exe" and select the "Run as administrator" option.
 +  * Click the "Install new SAP HANA database client" option.
 +  * Use the default install directory, C:\Program Files\sap\hdbclient
 +  * Click <Next> to move through the installation wizard
 +
 +
 +====HANA Drivers for Crystal Reports====
 +A specific ODBC driver is required if you plan to use Crystal Reports as a presentation mechanism with Versago and Bizweaver.  The name of this driver is **B1CRHPROXY32**.
 +
 +As of May/2020 it appears that the only way to get this driver installed is to install the SAP Business One 32-bit HANA client on the Versago server.  This should be done before installing Versago if possible.
 +
 +  - If this is done **before** Versago is installed you will need to remove the "SAP Crystal Reports Runtime engine for .NET framework" The Versago installation process will then install the correct version of the application.
 +  - If this is done **after** Versago is installed you will need to remove the "SAP Crystal Reports Runtime engine for .NET framework" and rerun the Versago installation process to get the correct version of this application installed.
  
  
Line 38: Line 59:
   * The user name & password for a SQL Server user with database administrator security.   * The user name & password for a SQL Server user with database administrator security.
     * Third Wave recommends that a specific user be created for Versago rather than using the ‘sa’ user.     * Third Wave recommends that a specific user be created for Versago rather than using the ‘sa’ user.
-  * The desired communication port to be used by Versago. This can be any available port based on your network configuration. The default ports are 443 for SSL and 8080 for non-SSL installation. +  * The desired communication port to be used by Versago. This can be any available port based on your network configuration. The default port is 443 for SSL.
-    * **EXCEPTION for non-SSL**: If the SAP Business One Integration Platform is in use (or you plan to use it in the future), do not use port 8080. The integration platform uses this port. Use port 8090 or higher to avoid conflicts.+
   * Versago interacts with SQL server so the standard communication port (1433) will need to be open between the Versago server and the SQL server.   * Versago interacts with SQL server so the standard communication port (1433) will need to be open between the Versago server and the SQL server.
       * When working with a HANA database, the standard port 30015 will need to be open as well.       * When working with a HANA database, the standard port 30015 will need to be open as well.
Line 50: Line 70:
     * Country     * Country
     * Password     * Password
- 
  
   * 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).   * 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).
Line 57: Line 76:
  
 ==== Confirm Environment Requirements ==== ==== Confirm Environment Requirements ====
-Review server, server software, and IIS requirements [**//[versago:versago_environment_requirements|here]]//**.  Pay particular attention to the required version of Microsoft .Net Framework.+Review  **//[[versago:versago_environment_requirements|server and server software]]//**.   
 +Pay particular attention to the required version of Microsoft .Net Framework.
  
 ==== Configure IIS ==== ==== Configure IIS ====
-<WRAP center round alert 60%>+<WRAP center round alert 80%>
 Note that it may be necessary to restart IIS as part of the installation process. This should be considered if you have other applications that use IIS running on the web server where Versago will be installed. Note that it may be necessary to restart IIS as part of the installation process. This should be considered if you have other applications that use IIS running on the web server where Versago will be installed.
 </WRAP> </WRAP>
  
-<WRAP center round info 60%>+<WRAP center round info 80%>
 IIS is used by both Versago and Bizweaver.  The configuration for both applications is the same. IIS is used by both Versago and Bizweaver.  The configuration for both applications is the same.
 </WRAP> </WRAP>
  
-  * Confirm that IIS is installed, configured, and running on the server(s) hosting Versago and/or Bizweaver.  Review the configuration requirements **//[[vgo_BW IIS Configuration|here]]//**. +  * Confirm that IIS is installed, configured, and running on the server(s) hosting Versago and/or Bizweaver.  Review the  **//[[vgo_BW IIS Configuration|IIS configuration requirements]]//**. 
-  * Obtain and install an SSL certificate if you are using the SSL option.+  * Review IIS **//[[versago:versago_application_security|Application Security]]//** 
 +  * Obtain and install an **//[[versago:ssl_certificates|SSL certificate]]//**.
   * Obtain the Versago installation package, which is provided by Third Wave.   * Obtain the Versago installation package, which is provided by Third Wave.
  
 ===== License Requirements ===== ===== License Requirements =====
  
-The Versago license is generated automatically. There are two requirements for the license process.+The Versago license is verified 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.   * 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**.+  * An active Internet connection to allow communication with the Third Wave license server.  The connection must allow access to **https://license.twbs.com:443**.
  
 ====== Installation ====== ====== Installation ======
Line 93: Line 114:
   * Set installation options   * Set installation options
     * Select the website to be created. The default is “Versago” and should not be changed without consultation with Third Wave technical support.     * Select the website to be created. The default is “Versago” and should not be changed without consultation with Third Wave technical support.
-    * Select “Enable SSL” if SSL is to be used. See the information elsewhere in this document regarding SSL. +    * The default port for SSL is 443 
-  * Enter the port to be used for Versago. +    * Select the desired **//[[versago:ssl_certificates|certificate ]]//** from the drop-down.
-    * The default is 80 but should generally be changed. A common port is 8080, assuming this port is not being used by another application. +
-    * If SSL is selected the default will change to 443. This is the standard for SSL. +
-    * If have selected SSL **and** you have already registered your certificate in IIS, you can select the desired certificate from the drop-down.+
   * Click [**Next**] to continue.   * Click [**Next**] to continue.
   * Various screens will be displayed as different components are installed. This may take a few minutes.   * Various screens will be displayed as different components are installed. This may take a few minutes.
Line 107: Line 125:
   * Enter the database\instance name of the database server.   * Enter the database\instance name of the database server.
   * Enter the name of the database that will hold Versago configuration information. This can be an existing database or a new database.   * Enter the name of the database that will hold Versago configuration information. This can be an existing database or a new database.
-  * An SAP Business One database should not be used for this purpose.+  * An SAP Business One database should **not** be used for this purpose.
   * A common database name is "vgoCommon".   * A common database name is "vgoCommon".
   * Enter the user name and password that will be used to connect to the database. This can be any user provided the user is associated with the “sysadmin” security role (SQL Server).   * Enter the user name and password that will be used to connect to the database. This can be any user provided the user is associated with the “sysadmin” security role (SQL Server).
-    * Note that only SQL Server Authentication is supported. Windows Authentication cannot be used for this purpose.+    * **Note** that only SQL Server Authentication is supported. Windows Authentication cannot be used for this purpose.
   * Click [**Next**] to continue.   * Click [**Next**] to continue.
   * There will be a delay of several seconds while the database and associated tables are created.   * There will be a delay of several seconds while the database and associated tables are created.
 +
 +{{ :versago:install01.png?500 |}}
  
 ===== Configure User ===== ===== Configure User =====
Line 118: Line 138:
 This step establishes an initial administrative Versago user for your site. This step establishes an initial administrative Versago user for your site.
  
-<WRAP center round important 100%>+<WRAP center round important 80%>
 Always use a valid email address as your initial administrative user.  Do not use "admin" as was done in earlier releases.  The only way to reset the password of any user is through the "Reset Password" function, which sends an email to the user. Always use a valid email address as your initial administrative user.  Do not use "admin" as was done in earlier releases.  The only way to reset the password of any user is through the "Reset Password" function, which sends an email to the user.
 </WRAP> </WRAP>
Line 125: Line 145:
   * Enter and confirm a password.   * Enter and confirm a password.
     * A strong password is required.  The requirements are displayed below the password field.     * A strong password is required.  The requirements are displayed below the password field.
 +  * Enter user details. \\ {{ :versago:install02.png?500 |}}
   * Click [**Next**] to continue.   * Click [**Next**] to continue.
  
- +  * The final installation page provides the option start Versago. \\ {{ :versago:inimage7.png?500 |}}
-  * The final installation page provides the option start Versago. \\ {{:versago:inimage7.png?384x313}}+
   * Click [**Finish**] to complete the initial installation.   * Click [**Finish**] to complete the initial installation.
   * The Versago home page is opened using "localhost."   * The Versago home page is opened using "localhost."
Line 134: Line 154:
     * Once the Versago login/password fields are accessible the basic installation is complete.     * Once the Versago login/password fields are accessible the basic installation is complete.
  
-<WRAP center round info 100%>+<WRAP center round info 80%>
 Depending on your browser, you may receive a message that the “site is not secure.” This generally occurs when you are using **https**. There should be an option (you may have to look for it) to acknowledge the issue and continue. This most commonly is found with the Chrome and Firefox browsers. Depending on your browser, you may receive a message that the “site is not secure.” This generally occurs when you are using **https**. There should be an option (you may have to look for it) to acknowledge the issue and continue. This most commonly is found with the Chrome and Firefox browsers.
 </WRAP> </WRAP>
 +<WRAP center round important 80%> 
 +Some security software may affect the installation of Versago. Please review your antivirus logs to ensure that no Versago files have been quarantined 
 +</WRAP>
 ==== Final installation Steps ==== ==== Final installation Steps ====
  
-The basic installation of Versago is now complete. Login using the Admin user created earlier to complete the following steps.+The basic installation of Versago is now complete. Login using the Admin user created earlier, go to the Admin Console and complete the following steps.
  
-  * Complete product licensing+  * [[versago:about|Enter license]]
   * [[versago:email_password_configuration|Configure email for Versago]]   * [[versago:email_password_configuration|Configure email for Versago]]
   * [[Create Forms Database|Create a Database for Versago Forms]]   * [[Create Forms Database|Create a Database for Versago Forms]]
versago/versago_installation.1589376769.txt.gz · Last modified: 2020/05/13 09:32 by runger

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial 4.0 International
CC Attribution-Noncommercial 4.0 International Valid HTML5 Valid CSS Driven by DokuWiki