Troubleshooting Guide

1. Finding the logs
2. Administering solr
3. Administering fedora
4. Administering resque-pool
5. [Ffmpeg] (#ffmpeg)
   • [libx264 not found] (#libx264 not found)
   • [New ffmpeg text] (#New ffmpeg)
6. [Fits] (#Fits)
   • [command not found] (#command not found)
   • [New fits text] (#New fits)
7. [Navigating to the HydraDam Homepage] (#Navigating to the HydraDAM Homepage)
   • [You see the default Apache Welcome Page] (#default Apache Welcome Page)
   • [You see 'Found token that cannot start any token while scanning for the next token'] (#found token that cannot start any token while scanning for the next token)
   • [You see '403 Forbidden You don't have permission to access / on this server'] (#403 Forbidden)
   • [New navigation text] (#New navigation)
8. [Fedora] (#Fedora)
   • [Installation failed: (localhost): Name or service not know] (#Installation failed (localhost) Name or service not known)
   • [New fedora text] (#New fedora)
9. [Ruby or Ruby Gems] (#Ruby or Ruby Gems)
   • [Wrong ruby or rubygems version] (#Wrong ruby or rubygems version)
   • [New Ruby text] (#New ruby)
10. [MySQL] (#MySQL)
    • [MySQL doesn't have the right character set.] (#MySQL doesn't have the right character set)
      • [MySQL version 5.1 and lower] (#MySQL version 5.1 and lower)
      • [MySQL version 5.2 to 5.4] (#MySQL version 5.2 to 5.4)
    • [MySQL doesn't have the right default storage engine.] (#MySQL doesn't have the right default storage engine)
    • [New MySQL text] (#New MySQL)
11. [New Section] (#New Section)
    • [New Subsection] (#New Subsection)
12. [New Section1] (#New Section1)
    • [New Subsection1] (#New Subsection1)
13. Other Resources
    • Production Installation Guide
    • Operations Guide
    • Wiki Home

===============

Ffmpeg

libx264 not found

1. Double-check that you ran the x264 section with the following configure line `./configure --enable-static --disable-opencl` 1. Try running `cd ~/ffmpeg-sources/x264 | sudo ldconfig` 1. Try re-running the x264 section with the following configure line `./configure --enable-static --prefix=/usr`

Newffmpeg

[Troubleshooting text goes here.]

Fits

command not found

Type `echo $PATH` – if /usr/local/bin is not included, add it to the relevant user’s bash_profile. For more info, see [the fits documentation](http://code.google.com/p/fits/)

New fits

[Troubleshooting text goes here.]

Navigating to the HydraDam Homepage

You see the default Apache Welcome Page

Look in /etc/httpd/conf.d/ or /etc/apache/conf.d/ - if you see a file there called welcome.conf, remove it. Passenger should then pick up the slack and serve up the hydradam home page.

You see 'Found token that cannot start any token while scanning for the next token'

Check your yml files - you have a tab or another illegal character in one of your yml files. Use only the spacebar to create indentation in your yml files - tabs are not allowed in yml syntax.

You see '403 Forbidden You don't have permissions to access / on this server.'

You may be using a newer version of apache than these instructions assumed - type "apache2 -v" to check the version. If it's 2.4.x, you need to use the newer configuration commands to allow access. See [apache documentation](http://httpd.apache.org/docs/2.4/upgrading.html).

New navigation text

[Troubleshooting text goes here.]

Fedora

Installation failed: (localhost): Name or service not known

Something is wrong with your hostname. On one centos image the /etc/hosts file had an extra tab between "127.0.0.1" and "localhost.localdomain localhost", which caused this error.

New fedora text

[Troubleshooting text goes here.]

Ruby or Ruby Gems

Wrong ruby or rubygems version

This may be an issue with `gem -v` versus `sudo gem -v` in Centos and you should document this. The most reliable way to install rubygems is to start with your package manager, but you need to complete the following extra steps to get the current/correct version. 1. In Ubuntu, use the command `sudo apt-get install rubygems` 1. In CentOS, use the command `sudo yum install rubygems` 1. Check the version with `gem -v` - if the version is 2.x, you're ready. If not, continue to the next step as you need to fix your ruby and rubygems versions before continuing. 1. Update rubygems with `sudo gem update --system` 1. Old rubygems packages also install old ruby packages. Remove the old ruby with the command `sudo yum remove ruby`. 1. Then check the bundler's ruby and update it if necessary: 1. Check the location of the ruby 2.0.0 installation with `which ruby` - the response will be something like `/usr/local/bin/ruby` 1. Check the location of bundler script with `which bundle` - the response will be something like `/usr/local/bin/bundle` 1. Use the output of the last step to look at the bundler script - for example `less /usr/local/bin/bundle` and make sure the first line - for example `#!/usr/local/bin/ruby` points to the location of the system ruby 2.0.0 installation (the output of `which ruby`) - if not, edit the script and change that line

New ruby text

[Troubleshooting text goes here.]

MySQL

MySQL doesn't have the right character set.

For MySQL Version 5.1 and Lower

Copy and paste the following block to the end of the `/etc/mysql/my.cnf` file

[mysql]  
default-character-set=utf8  

For Version 5.2 to 5.4

Copy and paste the following block into your terminal window and hit Enter.

cat << EOF | sudo tee /etc/mysql/conf.d/utf8_charset.cnf  
[mysqld]   
default-character-set=utf8   
[client]   
default-character-set=utf8   
EOF  

MySQL doesn't have the right default storage engine.

Edit `/etc/mysql/my.cnf` and set default storage to InnoDB with: `default-storage-engine=InnoDB`

New MySQL text

[Troubleshooting text goes here.]

New Section

New Subsection

New Section1

New Subsection1