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
- Extract the shinyservice.zip file to the root directory of your Content Server installation; typically found here: C:\OPENTEXT\
- Log onto your Content Server Administration page and click Module Administration > Install Modules
- Click the check box beside shinyservice_1_x_x and click Install. Content Server will ask to restart; click restart.
- After Content Server has been restarted click Continue. Shinydrive Service module is now installed on your Content Server.
Content Server Module Installation for Unix
- Copy shinyservice.tar.gz to your Content Server root directory and run “tar –zxvf shinyservice.tar.gz” as the user running Content Server.
- Log onto your Content Server Administration page and click Module Administration > Install Modules.
- Click the check box beside shinyservice_1_x_x and click Install. Content Server will ask to restart; click restart.
- 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 ServicesAuthenticationAuthentication success for user: Admin ShinyserviceService Enabled: Yes Loading Profile: DRIVEEnterprise Workspace letter: H type: EnterpriseWS id: EnterpriseWS Personal Workspace letter: P type: PersonalWS id: PersonalWS 2 drives found for profile: DRIVE Loading User InfoSuccess loading current user information for Admin Loading Content Server InfoContent 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.
Installation Video
Check out the YouTube video of a typical installation.