Installing Workshare iManage Integration Server

The Workshare iManage Integration Server (WIIS) integrates Workshare's comparison technology into the Work 10 web UI. When WIIS is installed, the user can launch comparisons using the context menus in Work 10. The experience depends on which configuration you’ve set up. Possible configurations include:

• Workshare Compare Desktop installation: The comparison is run and displayed in the Compare Desktop application.
• Workshare Compare Server installation: The comparison is run in Compare Server and displayed in Compare Online in a browser.
• Workshare Compare Server and Compare Desktop installation: Users can choose to run the comparison in Compare Server and display it in Compare Online or run and display it in the Compare Desktop application.

Implementations

The implementation of WIIS can vary according to your iManage Work 10 installation.

• iManage Work 10 on premise (either at your offices or a cloud data center that you control): WIIS can be installed on premise or in the cloud (hosted by Litera)
• iManage Work 10 in the public cloud (cloudimanage.com): WIIS is installed in the cloud (hosted by Litera) 

Installation Process
This process describes how to install WIIS 1.6 on-premise.

Step 1: Confirm IIS installed
If you don’t have Microsoft IIS installed on the server where you will install WIIS, install it before continuing further.

Step 2: Set up HTTPS binding
All interaction between the Work 10 server, WIIS, Compare Server and the users' browsers must be over HTTPS. This is because authentication of the user for the WIIS is handled by OAuth2 on the Work 10 server.
Users’ browsers must trust the certificates of the Work 10 server, the WIIS and Compare Server.
The WIIS must trust the certificates of the Work 10 server and Compare Server. There are no direct HTTPS calls from the Work 10 server to the other servers: the interaction between Work 10 and WIIS is initiated from the Work 10 web UI in a browser.

To set up HTTPS binding:
Go into IIS and set up the binding for HTTPS via port 443.

Step 3: Run WIIS install
The WIIS install is provided as a standard installation file - WiiS.Setup-[build#].exe. You must  run it from the command line so you can set the parameters required by the install.

To install WIIS:

1. Open a command prompt and navigate to the location of the WIIS executable file.
2. Set the following command line parameters:

Note: Use lower case for all parameters.

• work_server_url=https://<imanage-server-url>
• server_root_url=https://<wiis-server-url>/dvwork10
• compare_server_url=https://<compare-server-url>

Note: If you are installing WIIS without Compare Server, you must still enter a compare_server_url as a placeholder. This should be removed once installation is complete.

3. Press enter to initiate the WIIS installer.
4. Accept the license terms and conditions and click Install. The setup process runs.

Note: WIIS requires an SSL connection and if the web server is not configured for SSL, an error will be shown.

5. Once setup has completed, click Close.
6. If you are installing WIIS without Compare Server, go to web.config in your installed IIS site (by default C:\Inetpub\DvWork10) and remove the placeholder Compare Server URL added in step 2:

Configuration

Downloading configuration file from WIIS

Adding Workshare options to Work 10's menus is done by uploading a configuration file to each Work 10 server. First you need to generate a web extension configuration file for each of your Work 10 servers.

To generate the web extension zip file:

1. Navigate to https://<<WIIS-URL>/admin. The page shows the details of your servers from web.config.
2. Click Generate Web Extension Configuration File in the first section to generate a configuration zip file for the Work 10 server specified in the first section. A server-specific configuration file is generated with the name "wiis.[host name of server].zip".
3. For additional Work 10 servers, enter the URL of the server and click Generate Web Extension Configuration File in the lower section.
4. Once you have generated configuration zip files for each of your Work 10 servers, continue to the next step.

Uploading configuration file to iManage Work 10

1. Navigate to the iManage Work Control Center at https://[work-server-name]/work/cc/.
2. In the left menu bar, scroll to Configure > System Setup > Applications.
3. Click the add button in the top right of the screen.
4. Upload the zip file downloaded from the WIIS server – either by drag & drop onto the dialog or by browsing for it.
5. Click Continue.

6. Once the above screen is displayed, click Continue.
7. You can leave the default settings and click Continue.

The above screen enables you to restrict WIIS functionality to specified users or groups. This can be changed later – refer to iManage Work 10 administration guides for details.

9. Click Finish. The application is installed and a confirmation message is displayed.