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:

1. On the machine hosting the Shinydrive Server, navigate to the \usr\local\shinydrive\shinydrive-server folder.

2. Delete the entire \usr\local\shinydrive file. This will erase the old configuration file and a new configuration file will be recreated.

3. It is strongly recommended that you clear your browser cache at this point.

4. 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

1. Download the latest version of the Shinydrive Suite: https://shinydocs.egnyte.com/dl/3iZ1xmRKyQ/shinydrive-suite-2.5.2.5.zip_

2. Right-click on the zip file (shinydrive-suite-yyyy-mm-dd.zip) and select Properties

3. On the General tab, check the box next to Unblock and click OK

4. Extract shinydrive-suite-yyyy-mm-dd.zip 

5. Open Services (services.msc) and locate the Apache® Tomcat service that is currently configured to run the Shinydrive Server

6. Right-click on the service and Stop

7. Navigate to your Tomcat webapps directory (for example, C:\Program Files\Apache Software Foundation\Tomcat 8.5\webapps)

8. 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

9. In a new Explorer window, open the extracted Shinydrive Suite folder

10. Navigate to and open the server folder

11. Copy the new shinydrive-server.war file into your Tomcat webapps directory

12. Go back to the Shinydrive Suite folder

13. Navigate to and open the contentserver-module folder

14. Copy the new sd-csws.war file into your Tomcat webapps directory

15. Copy the new cws.war file from the Content Server you are connecting to (for example, OPENTEXT\webservices\java\) into your Tomcat webapps directory

16. Open Services (services.msc) and Start the Tomcat service

17. 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

1. Go back to Services (services.msc) and Stop the Tomcat service again

2. Go to your Tomcat webapps directory

3. Open the cws folder and open the sub-folder WEB-INF

4. If you are running Content Server and Shinydrive on the same machine, skip over the next step

5. 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

6. Save the changes

Configuring web.xml for sd-csws

1. With the Tomcat service stopped, open the sd-csws folder and open the sub-folder WEB-INF

2. Open the web.xml file in a plain text editor

3. If you are running Content Server and Shinydrive on the same machine, skip over the next step

4. 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

5. Confirm the port is correct also

6. Save the changes

Restart the Shinydrive Server

1. Open Services (services.msc) and Start the Tomcat service again

2. Log into your Shinydrive Admin Panel (typically http://localhost:8080/shinydrive-server/admin) and verify the server is up and running.