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 PropertiesOn 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:
cws folder
sd-csws folder
shinydrive-server folder
cws.war
filesd-csws.war
fileshinydrive-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 directoryGo 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 directoryCopy the new
cws.war
file from the Content Server you are connecting to (for example, OPENTEXT\webservices\java\) into your Tomcat webapps directoryOpen 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>
replacelocalhost
with the IP address, hostname, or fully qualified domain name (FQDN) of your Content ServerSave 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 editorIf 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>
replacelocalhost
with the IP address, hostname, or fully qualified domain name (FQDN) of your Content ServerConfirm 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.