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.

• 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

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

Beginning with Versago v2.4.11, 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 Bizweaver.

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

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.

1. 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.
2. 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.

• The name/IP address of the server(s) hosting Versago
• The name/IP address of the server where SQL Server is found
• 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.
• 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.
  • 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.
  • When working with a HANA database, the standard port 30015 will need to be open as well.

• An initial Versago user that will act as an administrator. You will need to provide:
  • Email address
  • First name
  • Last name
  • Company name
  • Country
  • 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).

Review server, server software, and IIS requirements [[versago:versago_environment_requirements|here]]. Pay particular attention to the required version of Microsoft .Net Framework.

• Confirm that IIS is installed, configured, and running on the server(s) hosting Versago and/or Bizweaver. Review the configuration requirements here.
• Obtain and install an SSL certificate if you are using the SSL option.
• Obtain the Versago installation package, which is provided by Third Wave.

The Versago 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.

• Execute the “setup.exe” file in the installation package. This will start the installation process.
  • Always use the right-click > Run as administrator option to execute the installation.
• Click [Next] to continue from the first screen that is presented.
• Review the End User License Agreement (EULA) that is presented.
  • Indicate your acceptance by selecting the appropriate option.
    • Click [Next] to continue.
  • Select the “Do not accept” option if you do not accept the EULA.
    • The installation will terminate.
• Confirm or change the installation location of the Versago files.
  • Click [Next] to continue.
• 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 “Enable SSL” if SSL is to be used. See the information elsewhere in this document regarding SSL.
• Enter the port to be used for Versago.
  • 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.
• Various screens will be displayed as different components are installed. This may take a few minutes.

This step identifies information about the database server that will be used by Versago. This is not a database from which data will be sourced, it is the database that holds the Versago configuration information. This can only be a SQL Server database.

• 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.
• An SAP Business One database should not be used for this purpose.
• 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).
  • Note that only SQL Server Authentication is supported. Windows Authentication cannot be used for this purpose.
• Click [Next] to continue.
• There will be a delay of several seconds while the database and associated tables are created.

This step establishes an initial administrative Versago user for your site.

• Enter a valid email address (user).
• Enter and confirm a password.
  • A strong password is required. The requirements are displayed below the password field.
• Click [Next] to continue.

• The final installation page provides the option start Versago.
  
• Click [Finish] to complete the initial installation.
• The Versago home page is opened using “localhost.”
• There is a delay of several seconds while the initial configuration completes
  • Once the Versago login/password fields are accessible the basic installation is complete.

The basic installation of Versago is now complete. Login using the Admin user created earlier to complete the following steps.

• Complete product licensing
• Configure email for Versago
• Create a Database for Versago Forms