Shinydrive
Shinydrive Administration Shinydrive 365 Administration Shinydrive End-user
Shinydrive
Shinydrive Administration Shinydrive 365 Administration Shinydrive End-user
Breadcrumbs

Installing Shinydrive Server for OpenText Content Server

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

What's changed in this release

  • Shinydrive Server now runs on Apache Tomcat 10.1 or Tomcat 11 with Java 21.

  • Shinydrive Server now communicates with Content Server through the Content Server REST API. You no longer need to deploy sd-csws.war or OpenText's cws.war, and you no longer need a second Tomcat instance.

  • You no longer need to add --add-opens Java options to Tomcat.

If you are upgrading from an earlier version, see Upgrading from a previous version below.

Installation checklist

Make sure you have the following items before you install Shinydrive Server:

  • Shinydrive Suite download folder (provided by Shinydocs)

  • Shinydrive Suite license key (from Shinydocs)

  • Apache Tomcat 10.1 or Apache Tomcat 11, running on Java 21

  • The URL of your OpenText Content Server. The Shinydrive server must be able to reach Content Server's REST API over the network.

Installing Shinydrive Server

  1. On the Shinydrive server, open Services.

  2. Find the Apache Tomcat service and stop it.

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

  4. On the General tab, select Unblock, then select Apply.

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

  6. Open the Shinydrive Suite folder.

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

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

  9. Check that the Tomcat webapps folder now contains shinydrive-server.war.

  10. Start the Apache Tomcat service.

You don't need to change any Java options. Earlier versions needed --add-opens=java.base/sun.reflect.misc=ALL-UNNAMED; this release doesn't.

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

Upgrading from a previous version

If you previously installed Shinydrive Server with the SOAP-based (CWS) setup:

  1. Stop all Apache Tomcat services on the Shinydrive server.

  2. Check that the server has Java 21 and Tomcat 10.1 or Tomcat 11. If you were running Shinydrive Server on Tomcat 9, install Tomcat 10.1 or 11 first.

  3. Remove the following from the webapps folder(s), including the expanded folders Tomcat created when it deployed them:

    • sd-csws.war and the sd-csws folder

    • cws.war and the cws folder (only if nothing other than Shinydrive uses them)

  4. Remove any --add-opens entries you added to the Tomcat Java options (in Tomcat9w.exe / Tomcat10w.exe → Java tab).

  5. Replace the old shinydrive-server.war, and its expanded shinydrive-server folder, with the new shinydrive-server.war.

  6. Start the Tomcat service.

  7. In the Shinydrive Admin page, update the Content Server connection so it points to Content Server's REST endpoint rather than the old CWS port (for example, 8082 or 8445).

  8. Once Shinydrive is working, you can uninstall the separate Tomcat instance you used only to host cws.war.