Shinydrive
Shinydrive Administration Shinydrive 365 Administration Shinydrive End-user
Shinydrive
Shinydrive Administration Shinydrive 365 Administration Shinydrive End-user
Breadcrumbs

Installing and Configuring Prerequisite Software

Installing prerequisite software

Install the prerequisite software as per this article:

Install Checklist and Requirements - Shinydrive Server & Client for Content Server | Customer Portal

Configuring Tomcat

Once installed, configure Tomcat to meet the Shinydrive needs of your organization. This includes SSL, load balancing, support for large files, UTF-8 support, and scaling.

Determining appropriate sizing

The recommended resource provisioning for Shinydrive is as follows:

  • CPU: 1 core for every 1700 users

  • RAM: 4GB for every 1700 users

For example, if you dedicate 8GB to your Tomcat instance and have 2 cores on your machine, it will be provisioned at a recommended level of up to 3400 users. To add users, scale resources linearly as per this article:

Shinydrive Scaling | Customer Portal

Configuring SSL

SSL configuration for Shinydrive Server is handled through Tomcat. For a how-to reference, please review their documentation available at https://tomcat.apache.org/tomcat-10.1-doc/ssl-howto.html .

Increasing Java memory to support large files (Optional)

Large file support in Shinydrive requires an increase in memory allocation. When increasing memory allocation, it is important to not exceed the available RAM on the server.

To increase memory:

  1. From the system tray on the server, open Tomcat Service Manager.

  2. From the General tab, stop Tomcat.

  3. From the Java tab, in the Maximum memory pool field, increase the amount to the level required to support your organization.

    1. As a guideline, increasing to 8129MB successfully handles files up to 1.2GB in size

  4. Restart Tomcat.

Enabling UTF-8 Support (Optional)

Because Tomcat assumes an iso-8859-1 western European character set on Windows, Shinydrive’s use of UTF-8 can result in incompatibility when users add Unicode characters to files, folders, and volume names.

To enable UTF-8 Support:

  1. In {tomcat-home}\conf\server.xml, update the connector to include the UIREncoding=”UTF8” setting.

    1. For example: <Connector port=”8080” protocol=”HTTP/1.1” connectionTimeout=”20000” redirectPort=”8443” URIEncoding=”UTF-8”/>

  2. Run {tomcat-home}\bin\tomcatw.exe and add a Java Option argument -Dfile.Encoding=UTF8. This will ensure that the Tomcat Properties file includes UTF-8 in the Java Options.

To label a drive (change it’s Volume Name) and include a non-ISO-8859-1 character:

  1. Visit a native to ASCII converter (for example, https://native2ascii.net/)

  2. Enter the text to convert.

  3. Rename the drive using the converted text.