Production Installation: Overview

Prerequisites

HydraDAM runs on Linux and these production installation instructions have been tested on Ubuntu and CentOS. They may or may not work on other flavors of unix.

Follow the instructions in the order listed below. We recommend using rvm in single-user development environments, however native installation of ruby in production environments is preferred because of complexities that can arise when using rvm under multiple user contexts.

Steps

1. Set up prerequisites for these instructions.
2. Install dependencies (development tools & libraries).
3. (CentOS) Disable SELinux.
4. Install ruby 2.0 and rubygems 2.0.
5. Install java 7.
6. Install Tomcat.
7. Install a sql db for Fedora.
8. Install Fedora.
9. Install solr 4.2.
10. Install Redis.
11. Install ffmpeg.
12. Install fits.
13. Clone the git repo & install gems.
14. Install & configure Apache & Passenger.
15. Create the production sql database.
16. Create and configure the yml files.
17. Configure the rails application.
18. Create an admin user.
19. Set up resque pool.
20. Test your installation:
    1. Open a browser, navigate to the home page of your application, and log in
    2. Click on the Upload button (right side of screen)
    3. Click on Select files . . .
    4. In the popup window, select a file from your local drive and click OK
    5. Click on Start upload - once the file is uploaded, you'll see the Apply Metadata screen
    6. Change the Title if desired, select a Resource Type, enter a Keyword, enter a Creator, and select a license in the Rights section
    7. Scroll down and click Save - the resque workers will begin transcoding - if you've uploaded a large file, this may take some time
    8. Use the dropdown in the upper right corner to move to your Dashboard
    9. Select your object and confirm that your metadata is correct
    10. Test the Download and Edit links
    11. Celebrate! You have a working HydraDAM

Troubleshooting: finding the logs, administering solr, administering fedora, administering resque-pool

Enhancements/Additions

1. Log rotation - you may want to rotate the logs for mysql, tomcat, fedora, apache, and the application
2. Enable/configure email for password resets
3. Firewall to secure Solr and Fedora
4. Add FTP functionality Ftp allows you to upload files larger than the http transfer limit. Large video files generally must be uploaded via ftp.
5. (CentOS) Incorporating SELinux SELinux offers filesystem security by enforcing rules on CentOS servers. In its default configuration, SELinux will interfere with hydradam. You'll need to configure it to allow the processes hydradam needs if you want to use it on your hydradam server.