[Summary view] [Print] [Text view]

   1  # Installing Video Module 4 for Drupal 6
   2  
   3  ## Requirements
   4  
   5  ### Required Drupal modules
   6  
   7  - [CCK](http://drupal.org/project/cck)
   8  - [Filefield](http://drupal.org/project/filefield)
   9  
  10  ### Recommended Drupal modules
  11  
  12  - [Flowplayer API](http://drupal.org/project/flowplayer)
  13  - [VideoJS](http://drupal.org/project/videojs)
  14  - [SWF Tools](http://drupal.org/project/swftools)
  15  - [ImageCache](http://drupal.org/project/imagecache)
  16  
  17  ### Optional Drupal modules
  18  
  19  - [FileField Sources](http://drupal.org/project/filefield_sources)
  20  
  21  ### Required software
  22  
  23  - [ffmpeg](http://ffmpeg.org/), unless the Zencoder submodule is used, see instructions below
  24  
  25  ### Recommended software
  26  
  27  - [flvtool2](http://www.inlet-media.de/flvtool2/)
  28  - qt-faststart, provided by ffmpeg
  29  
  30  ## Installing the module
  31  
  32  1. Download the module and extract it to sites/all/modules
  33  2. Download and install optional modules, such as Flowplayer and VideoJS
  34  3. Enable the Video module and Video FTP and / or Video Upload
  35  4. Optionally, enable Amazon S3 on Video and / or Zencoder API on Video5. See below for installing additional libraries.
  36  5. Go to Administer › Site configuration › Video 
  37  6. Change the General settings to match your preferences
  38  7. Setup players for the video types you would like to use
  39  8. Select and configure your transcoder
  40  9. If you are going to use ffmpeg transcoding, select at least one preset
  41  10. Enable flvtool2 metadata generation if you have flvtool2 and are going to convert to flv
  42  11. Configure S3 storage if you intend to use it
  43  12. Configure cron. If you do not want to use cron to convert videos, see below for an alternative
  44  
  45  ## Installing the Zencoder library
  46  
  47  1. Go to https://github.com/zencoder/zencoder-php/tags
  48  2. Download the Zencoder API library to sites/all/libraries/zencoder
  49  3. Make sure the file sites/all/libraries/zencoder/Services/Zencoder.php exists
  50  4. The Documentation directory is not needed
  51  5. The version that is known to be compatible with the Zencoder module is 2.0.2 (2012-01-11)
  52  
  53  ## Installing the Amazon S3 library
  54  
  55  1. Go to http://aws.amazon.com/sdkforphp/
  56  2. Download the AWS SDK for PHP to sites/all/libraries/awssdk
  57  3. Make sure the file sites/all/libraries/awssdk/sdk.class.php exists
  58  4. The version that is known to be compatible with the Amazon S3 module is 1.5.0.1 (2011-12-21)
  59  
  60  ## Tips for a proper ffmpeg installation
  61  
  62  When you intend to use ffmpeg to transcode videos, make sure your ffmpeg installation handles all 
  63  the file formats before installing the module. Linux distributions using precompiled binaries, 
  64  such as Ubuntu, usually do not provide the best compile options and it is advised to compile 
  65  ffmpeg yourself.
  66  
  67  The following guides will help you to get a good ffmpeg installation:
  68  
  69  - [Ubuntu](http://ubuntuforums.org/showthread.php?t=786095): ffmpeg compilation guide
  70  - [Ubuntu](http://ubuntuforums.org/showthread.php?t=1117283): guide to enhance your ffmpeg installation using precompiled packages
  71  - [Gentoo](http://www.gentoo-portage.com/media-video/ffmpeg): make sure to setup the right USE flags before installing
  72  - [Windows](http://www.videohelp.com/tools/ffmpeg): Windows packages
  73  
  74  ## Alternative for cron
  75  
  76  Instead of the Drupal cron system, you can execute the video_scheduler.php script regularly
  77  to process pending transcode jobs.
  78  
  79  Be sure to run the crontab as same user account that the webserver process uses to allow
  80  the website to delete or modify the files after transcoding.
  81  
  82  On Ubuntu or Debian, this user is www-data. On other systems, it could also be apache or apache2.
  83  
  84  Execute the following command to edit the cron tab for the web user:
  85  
  86      crontab -e -u WEBSERVERUSER
  87  
  88  The crontab entry should look something like this:
  89  
  90      */20    *    *    *    *    cd /absolute/path/to/drupal/ ; php video_scheduler.php http://www.example.com/path_to_drupal
  91  
  92  This will execute the script every 20 minutes. Make sure the script does not run too often.
  93  
  94  Troubleshooting
  95  ---------------
  96  
  97  Configuring and installing ffmpeg in a web server environment might be pretty
  98  difficult. In order to help you troubleshoot the transcoding process the ffmpeg
  99  helper puts debugging informations on the drupal logs. I strongly suggest to
 100  have a look at them if you are experiencing problems with transcoding.
 101  
 102  All ffmpeg commands are added to the Drupal log. You might try to rerun them on a 
 103  command shell in order understand what went wrong.