TopTeam Web Application Server Installation Guide

TopTeam Web Application Server is a platform that helps you access TopTeam Repository through your browser.

TopTeam Web Application Server is an ISAPI-dll that needs to be deployed on Internet Information Services (IIS).

In this article, you will learn to install and configure TopTeam Web Application Server on the IIS.

• TopTeam Administrators
• IT Support

Refer to the article System Requirements for the TopTeam Web Server.

This article provides the recommended system requirements for installing TopTeam Web Application Server.

NOTE: If the server computer is not configured based on the recommended system requirements, the performance of the web server might slow down.

1. TopTeam Application Server has already been installed and running.
2. For Microsoft IIS, ensure that WebDAV Publishing is unchecked and the features are turned ON as shown in the image below:

1. Verify that TopTeam Web Application Server you have downloaded is compatible with your current TopTeam Database Schema version.
2. Install the new TopTeam Web Application Server files from the zip file you have downloaded.
3. Configure TopTeam Web Application Server using Management Console for TopTeam Web Server.
4. Create and configure a website for TopTeam Web on IIS.

1. Log into the computer where you want to install TopTeam Web Application Server as a Windows User that has Windows Administrator privileges.
2. If TopTeam Application Server is running on another computer, ensure that TopTeam User Data Files Folder is accessible from that computer.
3. If you are using Oracle or SQL Server as your database server, verify that the client library required to connect to the database server has been installed on your computer. Also verify that you are able to connect to TopTeam Database Schema.
4. Download the TopTeam Web Application Server – ISAPI Edition zip file from the TechnoSolutions Customer Portal (access to Customer Portal is available only to licensed customers) or any other download link provided to you.

Refer to the article How to find TopTeam Database Schema Version.

You can find out the compatible TopTeam Database Schema version of the new TopTeam Web Application Server from the zip file name.

The zip file name can be of the following format:

TopTeamWeb_Lic_<<Database>>_ISAPI_<<Version Number>>_MinDB<<DB Version Required>>_DDMONYY.zip

E.g. TopTeamWeb_Lic_SQL_ISAPI_9.20_MinDB9.0_04Nov15.zip

In the example above:

SQL – indicates that this TopTeam Web Application Server is for SQL Server Database.

Other possible value is Ora for Oracle.

IMPORTANT: If the database type indicated in the zip file name is different from TopTeam Database installed in your organization, you have downloaded the incorrect file. Please download the correct file and try again.

9.20 – is the version number of TopTeam Web application.

DB9.0 – is the minimum Database Schema version required for this TopTeam Web Application Server version.

04Nov15 – is the release date of this TopTeam Web Application Server.

IMPORTANT: If the currently installed TopTeam Database Schema version is lower than the TopTeam Database Schema version required for the new TopTeam Web Application Server, this server is not correct for you. Download a lower TopTeam Web Server version that is compatible with your current TopTeam Database Schema.

Another option is to upgrade TopTeam Database Schema to the version required by the new TopTeam Web Application Server. In that case, you may need to upgrade other components of TopTeam as well such as TopTeam Desktop App, TopTeam Application Server, etc.

1. Open the TopTeam Web zip file that you have downloaded.
2. Extract the contents to the installation folder of your choice. We recommend that you extract the files to an empty folder.

The following are the executable names for TopTeam Web Management Console:

• TopTeam Web ISAPI DLL for SQL Server Database: ttmISAPICp_SQL.exe
• TopTeam Web ISAPI DLL for Oracle Database: ttmISAPICp_Ora.exe

We recommend that you rename the desktop shortcut to TopTeam Web Application Server Management Console to differentiate it from the desktop shortcut of TopTeam Application Server Management Console.

After installing TopTeam Web Application Server, you need to specify few configuration settings before it can be used. These settings are essential for TopTeam Web Application Server to connect to TopTeam database. You can configure these settings using the Configuration Wizard.

NOTE: Management Console for TopTeam Web Application Server is different from Management Console for TopTeam Application Server.

Double-click the executable or desktop shortcut (if any) to run TopTeam Web Application Server Management Console.

This page displays only if you run the configuration wizard for the first time.

If you do not know the URL for TopTeam Web website, you can skip this step.
You can specify these settings later using the configuration wizard.

Specify the settings for connecting to TopTeam Database Schema.
This page will be different for Oracle and SQL Server databases.
Refer to one of the steps below based on the database server you are using.
If TopTeam Application Server is running on the same computer, the wizard will automatically choose the appropriate database settings from TopTeam Application Server.

1. Specify Database Connection Settings:

a. Specify Username and Password for TopTeam Database Schema on Oracle.

b. Specify the name of Oracle Database Server where TopTeam User Database Schema is hosted.
If you do not find the required database server, you can directly enter its name.

2. Click Test Connection to test the database connection.
If the database connection test fails, please verify that the Database Connection Settings are correct.
Verify that you are able to connect to TopTeam Database Schema from this computer through other Oracle utilities like SQL* Plus, using the same Database Connection Settings.

3. Click Next if database connection test is successful.

1. Specify Database Connection Settings:

a. Specify whether you want to use SQL Server Native Authentication or Windows Authentication.
We recommend that you use Native Authentication.

b. Specify Username and Password. This is NOT required if you are using Windows Authentication.

c. Specify the name of the TopTeam User Database.

d. Specify the SQL Server instance to use.

In case you are not able to view any server name in the drop-down list box, click Populate Servers.
If you do not find the required SQL Server instance in the list, you can directly enter the name of the SQL Server instance.

2. Click Test Connection to test the database connection.
If the database connection test fails, please verify that the Database Connection Settings are correct.
Verify that you are able to connect to TopTeam Database from this computer through SQL Management Studio, using the same Database Connection Settings.

3. Click Next if the database connection test is successful.

TopTeam Web ISAPI Edition when hosted on a IIS Website runs under the credentials as a special Windows user account for running IIS Websites. If you want to use Windows Authentication, ensure that the Windows user account whose credentials will be used to run TopTeam IIS Website has the permissions to connect to TopTeam Database on SQL Server.

Clicking Test Connection will verify the connection settings using the credentials of logged in Windows user account. A successful connection does not guarantee that TopTeam IIS Website will also be able to connect to SQL Server.

We recommend that you consult your IT Support and database administrator regarding this.
You can also change the Windows user credentials that are used to run TopTeam Website using IIS Manager. This topic is not in the scope of this article.

We recommend that you use SQL Server Native Authentication. Use Windows Authentication only if it is mandatory according to your corporate policy.

1. Specify the folder where the TopTeam User Data Files are stored.
You must specify the same folder that is used in TopTeam Application Server for storing User Data Files.

IMPORTANT: Ensure that the Windows user whose credentials will be used to run TopTeam IIS Website has “Write” permissions on this Folder.

2. Click Next to proceed.

If you want to configure Integrated Windows Authentication (SSO) on TopTeam Web, refer to the article How to configure Integrated Windows Authentication on TopTeam Web.

To deploy TopTeam Web on IIS, you need to create a website on IIS.

Ensure that IIS is installed on the computer.

To install, refer to the article How to install Internet Information Services (IIS) 7.

We recommend that If Default Web Site is not in use, you stop the site.

1. Expand Sites.
2. Select Default Web Site.
3. Click Stop on the Actions Pane.

An alternate method to stop the website is from the right-click menu: Right-click the Default Web Site, select Manage Web Sites and click Stop.

To run TopTeam Web in IIS, Execute permission needs to be granted to the ISAPI-dll feature.
Execute permission is required for ISAPI-dll to run on IIS Server.
Follow the steps from 4.3.1. to 4.3.4.:

If you do not find an entry for ISAPI-dll in Handler Mappings, you need to first include ISAPI-dll services in IIS.
Refer to the article How to install Internet Information Services (IIS) 7.

The Add Website window will open.

NOTE: The Website name entered in the Site name edit box is different from the Website address that you use in the web browser to access the Website.

NOTE:
1. If Enable dynamic content compression option is disabled, it indicates that this feature is not installed on IIS Manager. In that case, go to “Turn Windows features ON or OFF” section of Windows Control Panel and turn ON the Dynamic Content Compression of IIS.
2. Uncheck Enable static content compression option for Windows 2012 Operating System and above.

TopTeam Web downloads application files (JavaScript, images, CSS, etc.) from the web server. These files must be cached by browser for optimal performance.

Specify the values for:
Name: Cache-Control
Value: private,max-age=2592000

NOTE: The value of the “max-age” directive must be in seconds. Recommended value is 2592000 i.e. the number of seconds in 30 days. The value must always be specified only in terms of seconds for the number of days.

This will open the ISAPI and CGI Restrictions page.

If your computer is 64 bit, you need to set Enable 32-Bit Applications as True.

You can also right-click the Name column and select Add Application Pool.

NOTE: If you are using TopTeam Web Application Server for SQL Server Database with Windows Authentication, set windows Username and Password in the Application Pool identity.

NOTE: Ensure that tsApp.html is the first document in the list. Use Move up option to move tsApp.html to the top of the list.

JSON MIME Type will be added to the list.

TopTeam Web version 13.33 and above supports Document Generation. For better performance we recommend that you create a separate Application Pool that will be used to generate document from TopTeam Web.
For more information, refer to the article Configuring Application Pool in Internet Information Services (IIS) Manager for generating document from TopTeam Web.

If the TopTeam Web Login page displays in the browser, this means that TopTeam Web Website has been created successfully using IIS manager.

You have successfully installed and configured TopTeam Web on this computer.

However, if you encounter any problems during installation, refer to the article TopTeam Web Server Startup Verification Checklist and check for possible causes of the problem.

If the problem still persists, contact TechnoSolutions.

TopTeam Web Server Startup Verification Checklist
Configuring TopTeam Web Server log information settings
Configuring Email Settings on TopTeam Web Server
How to configure Integrated Windows Authentication on TopTeam Web
Configuring External Authentication in TopTeam
How to configure IIS 8.0 for accessing TopTeam Application Server via HTTP/HTTPS

Revised: September 19th, 2019