Skip to main content
Skip table of contents

Installing Shinydrive Server for OpenText Content Server

Ensure you have reviewed the hardware requirements and installed the prerequisites.

Installation checklist

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

  • Shinydrive Suite download folder (provided by Shinydocs)
  • Shinydrive Suite license key (from Shinydocs)
  • Apache Tomcat 9
    • Running with Java 21
  • Apache Tomcat 10
    • Running with Java 17
  • Content Server cws.war file (from OpenText)*
  • The activation-1.1.1.jar should already be deployed if not, place it in the lib directory of Tomcat 9 in it’s respective installation directory.

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

      image-20260313-173052.png
    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

Congratulations! You have completed installing Shinydrive Server. You are now ready to configure your Content Server and install the Shinydrive Client.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.