Updating the Shinydrive Server for OpenText Content Server

In this article, we describe the process for updating the Shinydrive Server.

We strongly recommend updating to the latest supported Shinydrive version 2.5.2.4 or higher.

NOTE: Prior to installation, you must delete your admin.creds folder:

On the machine hosting the Shinydrive Server, navigate to the \usr\local\shinydrive\shinydrive-server folder.
Delete the entire \usr\local\shinydrive file. This will erase the old configuration file and a new configuration file will be recreated.
It is strongly recommended that you clear your browser cache at this point.
Follow the steps below to update the Shinydrive Server. During a typical Shinydrive installation, you will be prompted to enter a new password, which will recreate the admin.creds file.

Please note that the most recent versions of Open Text’s Content Server require cws.war to be deployed under Tomcat 10 with a corresponding JDK, version 17. Shinydrive Server will remain on Tomcat 9 with JDK version 11. Tomcat 10 will need to be configured for a a different default port, i.e. 8082, and connections from Shinydrive in the Admin console will need to be adjusted accordingly.

Deploying the .war files

Download the latest version of the Shinydrive Suite: https://shinydocs.egnyte.com/dl/3iZ1xmRKyQ/shinydrive-suite-2.5.2.5.zip_
Right-click on the zip file (shinydrive-suite-yyyy-mm-dd.zip) and select Properties
On the General tab, check the box next to Unblock and click OK
Extract shinydrive-suite-yyyy-mm-dd.zip
Open Services (services.msc) and locate the Apache® Tomcat service that is currently configured to run the Shinydrive Server
Right-click on the service and Stop
Navigate to your Tomcat webapps directory (for example, C:\Program Files\Apache Software Foundation\Tomcat 8.5\webapps)
Delete or move the following files and folders to another location:
1. cws folder
2. sd-csws folder
3. shinydrive-server folder
4. cws.war file
5. sd-csws.war file
6. shinydrive-server.war file
In a new Explorer window, open the extracted Shinydrive Suite folder
Navigate to and open the server folder
Copy the new shinydrive-server.war file into your Tomcat webapps directory
Go back to the Shinydrive Suite folder
Navigate to and open the contentserver-module folder
Copy the new sd-csws.war file into your Tomcat webapps directory
Copy the new cws.war file from the Content Server you are connecting to (for example, OPENTEXT\webservices\java\) into your Tomcat webapps directory
Open Services (services.msc) and Start the Tomcat service
Shortly after starting the Tomcat service, the .war files will deploy into folders with the same name and the webapps directory will now look as it did in Step 7

Configuring web.xml for cws

Go back to Services (services.msc) and Stop the Tomcat service again
Go to your Tomcat webapps directory
Open the cws folder and open the sub-folder WEB-INF
If you are running Content Server and Shinydrive on the same machine, skip over the next step
On the line below <param-name>LivelinkServer</param-name> replace localhost with the IP address, hostname, or fully qualified domain name (FQDN) of your Content Server
Save the changes

Configuring web.xml for sd-csws

With the Tomcat service stopped, open the sd-csws folder and open the sub-folder WEB-INF
Open the web.xml file in a plain text editor
If you are running Content Server and Shinydrive on the same machine, skip over the next step
On the line below <param-name>LivelinkServer</param-name> replace localhost with the IP address, hostname, or fully qualified domain name (FQDN) of your Content Server
Confirm the port is correct also
Save the changes

Restart the Shinydrive Server

Open Services (services.msc) and Start the Tomcat service again
Log into your Shinydrive Admin Panel (typically http://localhost:8080/shinydrive-server/admin) and verify the server is up and running.