Installing Shinydrive Server for OpenText Content Server

Installation checklist

Make sure the following items are handy for the Shinydrive server installation:

Recent versions of the cws.war from Open Text require Tomcat 10. Tomcat 10 can be installed and run on the same server alongside Tomcat 9, the cws.war file will be placed in the webapps folder under the running Tomcat10. You will need to define an alternate port (i.e. 8082 or 8445) and ensure this port is used in configuring Shinydrive in the Admin page.

Installing Shinydrive Server

1. On the Shinydrive server, open Services

2. Locate and Stop the Tomcat 9 and Tomcat 10 service

3. Right-click on the Shinydrive Suite ZIP file and select Properties

4. Under the General tab, select Unblock and Apply                 

5. Right-click on the Shinydrive Suite ZIP file and select Extract All... 

6. Open the Shinydrive Suite folder

7. Open the server folder and locate the shinydrive-server.war file

8. Copy the shinydrive-server.war file into the webapps folder of your Tomcat 9 folder (for example, C:\Program Files\Apache Software Foundation\Tomcat 9\webapps) 

9. Return to the Shinydrive Suite folder

10. Open the content server-module folder

11. Copy the sd-csws.war into the webapps folder of your Tomcat 9 folder

12. Copy your Content Server’s cws.war file into the webapps folder of your Tomcat 10 folder

13. Verify the Apache Tomcat 9 webapps folder now contains the following 2 files:

    • shinydrive-server.war

    • sd-csws.war

14. Verify the Apache Tomcat 10 webapps folder now contains the following file:

    1. cws.war

15. You now need to set specific Java options in Tomcat 9:

    1. Open Tomcat9w.exe in [Install location]\Apache Software Foundation\Tomcat 9.0\bin

    2. Click the Java tab

    3. Add the following line to the Java 9 options:
       --add-opens=java.base/sun.reflect.misc=ALL-UNNAMED
       

       

    4. Click OK to apply

16. Start your Apache Tomcat 9 and Tomcat 10 service

Configuring the web.xml files

Edit the web.xml files by pointing them toward your Content Server location.

Configuring the web.xml file for cws

1. Navigate to the the cws folder of your Tomcat 10 folder (for example, C:\Program Files\Apache Software Foundation\Tomcat 10\webapps\cws) *

2. Open the WEB-INF folder

3. Open the web.xml file using a text/source code editor (for example, Notepad++)

4. Locate <param-name>LivelinkServer</param-name> in the <context-param> section

5. Update <param-value></param-value> with the IP or fully qualified domain name to the machine hosting your Content Server

6. Restart your Apache Tomcat 10 service

Configuring the web.xml file for sd-cws

1. Navigate to the sd-csws folder of your Tomcat 9 folder (for example, C:\Program Files\Apache Software Foundation\Tomcat 9\webapps\sd-csws) 

2. Open the WEB-INF folder

3. Open the web.xml file using a text/source code editor

4. Locate <param-name>LivelinkServer</param-name> in the <context-param> section

5. Update <param-value></param-value> with the IP or fully qualified domain name to the machine hosting your Content Server

6. Restart your Apache Tomcat 9 service