Installation of Shinydrive should take about 30 minutes for a simple configuration.  This document will explore this simple configuration to get you up and running, and provide links to more detailed installation and configuration topics.

Getting Ready

Make a note of the following information:

Content Server Version:______________ (i.e. 10 SP2 update 13)

Content Server Port: ____________ (usually Port 2099, look in your [install_dir]/config/opentext.ini)

Content Server Host Name: ______________ (the fully qualified name of the host machine where you can contact the Content Server Port)

 

Prerequisite Software

You may already have these installed.

JDK or Java Runtime

While a JDK provides more tools than Java Runtime, both are sufficient for installation.

You can download your JDK from Oracle.  It will be called JDK JavaSE 8u[revision number].

Apache Tomcat (Version 7)

You can use an existing Apache Tomcat or dedicate one to Shinydrive and the Content Server Web Services (covered in the next topic).  Download it from Apache.

On Windows use the "32-bit/64-bit Windows Service Installer".

On your Unix distribution you may be able to use your package manager (like apt-get or RPM) to automatically install Tomcat.  Otherwise download the tar.gz package.

Please review the Shinydrive Tomcat Documentation.

Content Web Services

Content Web Services ships with OpenText Content Server 10 and 10.5.  Opening your Content Server installation directory to /webservices/java/webapps you'll find les-services.war for Content Server 10 and cws.war for Content Server 10.5.

IMPORTANT: For 10.5 do not use les-services.war.  Use cws.war.

Copy the .war file into your [Apache Tomcat Install Dir]/webapps folder.

When Tomcat is running it will automatically create a new folder for the web services.

Go into the /webapps/[cws or les-services]/WEB-INF folder and edit web.xml using a text editor.

Change the LivelinkServer and LivelinkPort in this web.xml file to be the same as you noted in the "Getting Ready" section.

 

Shinydrive Content Server Module

Shinydrive requires a single module to be installed on Content Server.

Content Server Module Installation for Windows

  1. Extract the shinyservice.zip file to the root directory of your Content Server installation; typically found here: C:\OPENTEXT\
  2.  Log onto your Content Server Administration page and click Module Administration > Install Modules
  3. Click the check box beside shinyservice_1_x_x and click Install. Content Server will ask to restart; click restart.
  4. After Content Server has been restarted click Continue. Shinydrive Service module is now installed on your Content Server.

Content Server Module Installation for Unix

  1. Copy shinyservice.tar.gz to your Content Server root directory and run “tar –zxvf shinyservice.tar.gz” as the user running Content Server.
  2. Log onto your Content Server Administration page and click Module Administration > Install Modules.
  3. Click the check box beside shinyservice_1_x_x and click Install. Content Server will ask to restart; click restart.
  4. After Content Server has been restarted click Continue. Shinydrive Service module is now installed on your Content Server.

 

Shinydrive Server

The Shinydrive server is a simple Tomcat application similar to the Content Web Services.  It requires a configuration file and license file.

License File

Your license file will be called license.xml  Check the contents of the file in a text editor and note your user limit and expiry date, if applicable.

Create a folder ON WINDOWS: "c:\usr\share\cs-rest" and copy the license.xml file into this folder.  This assumes your Tomcat 7 is installed on c:\.  If Tomcat 7 is installed on a different drive, replace c: with the appropriate drive letter.

Create a folder ON UNIX: /usr/share/cs-rest copy the license.xml file into this folder.

IMPORTANT NOTE:  Many people make a mistake by creating a folder "user" or "users".  Make sure it is "usr".

Properties File

Your cs-rest.properties file contains all of the configuration required for Shinydrive to operate. It identifies how to connect to Content Web Services and which drives should be configured.

Copy the cs-rest.properties file into the /usr/share/cs-rest folder.

Edit the cs-rest.properties file in a text editor such as Notepad++

The properties file is highly configurable.  Read this page for information on a basic configuration.

Shinydrive Tomcat Application

Copy the shinydrive.war file into your [TOMCAT]/webapps folder.

When Tomcat is running it will automatically create a new folder for the shinydrive service.

Go into the /webapps/shinydrive/WEB-INF folder and edit web.xml using a text editor.

Change the LivelinkServer and LivelinkPort in this web.xml file to be the same as you noted in the "Getting Ready" section.

Shinydrive Content Server Application

Copy the cs-rest.war file into your [TOMCAT]/webapps folder.

IMPORTANT NOTE:  If you are running Content Server 10 update 8-12, you'll use a special version of cs-rest.  It is cs-rest10sp2up8.war.  Rename this to cs-rest.war and copy it into your Tomcat webapps folder.

 

Testing the Shinydrive Server

You can test your configuration using a standard web browser.

Go to http://tomcatservername:tomcatport/cs-rest/admin (If you are testing locally, you can use http://localhost:8080/cs-rest)

Use your Content Server username and password, and DRIVE as your profile.

When everything is configured correctly, you will see:

Verifying Services

Authentication

Authentication success for user: Admin

Shinyservice

Service Enabled: Yes
Service Initialized: Yes
Content Server Module Available: Yes

Loading Profile: DRIVE

Enterprise Workspace letter: H type: EnterpriseWS id: EnterpriseWS
Success connecting to Enterprise Workspace as Admin

Personal Workspace letter: P type: PersonalWS id: PersonalWS
Success connecting to Personal Workspace as Admin

2 drives found for profile: DRIVE

Loading User Info

Success loading current user information for Admin

Loading Content Server Info

Content Server Version 10.5.0 Language Code USA

Server Time: 2015-06-23T19:10:27Z

 

Shinydrive Client Setup

Windows Client Setup

Requires Windows 7/8.x, will work on Windows Server 2008/2012

Click here for more detailed information on the windows client setup including Single Sign On.

downloadmovieInstallation Video

Check out the YouTube video of a typical installation.