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)
  • Content Server cws.war file (from OpenText)*
  • The activation-1.1.1.jar should already be deployed if necessary, see prerequisites.

Recent versions of the cws.war from Open Text require Tomcat 10. Tomcat 10 can be installed and run on the same server alongside Tomcat9, 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 machine where Tomcat is installed, run Services.msc

  2. Locate and Stop the Tomcat 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 folder (for example, C:\Program Files\Apache Software Foundation\Tomcat\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 folder

  12. Copy the cws.war file into the webapps folder of your Tomcat folder

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

    • shinydrive-server.war

    • sd-csws.war

    • cws.war*

  14. Restart your Apache Tomcat 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 folder (for example, C:\Program Files\Apache Software Foundation\Tomcat\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

Configuring the web.xml file for sd-cws

  1. Navigate to the sd-csws folder of your Tomcat folder (for example, C:\Program Files\Apache Software Foundation\Tomcat\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 service

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

Installing Tomcat 10.x for cws.war as a separate service:

You will need Tomcat 10.x from here: https://dlcdn.apache.org/tomcat/tomcat-10/

Tomcat 10 requires Java JDK 17, available from here:

CODE
https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.9%2B9.1/OpenJDK17U-jdk_x64_windows_hotspot_17.0.9_9.msi

Install Java before beginning the Tomcat 10.x installation. The default location is ideal, adjustments to the following will be required if there are any changes.

You may use a config.ini file:

CODE
JavaHome=C:\Program Files\Eclipse Adoptium\jdk-17.0.9.9-hotspot\
TomcatServiceDefaultName=Tomcat10
TomcatServiceName=Tomcat10-CWS
TomcatPortHttp=8082

For an automated installation you may use this command line:

CODE
apache-tomcat-10.1.28.exe /S /C=config.ini

As an administrator, from the command-line, starting the service for the first time, use:

CODE
sc start tomcat10-CWS

 

JavaScript errors detected

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

If this problem persists, please contact our support.