TubeStudio Installation Instructions
Below are the instructions for self installation of Too Much Media's TubeStudio.
Server Instructions
The quick installation contains a simple list of instructions and expects the installer to be able to follow an on screen prompts and questions as well as configure any needed systems on the server.
Download
Download Tube Studio to the web server that will run your tube sites. Example:
wget "<download url>"
If you get a ''wget'' comand not found message use this instead: fetch "<download url>"
Unzip
Unzip the compressed archive. Example:
tar -xzf tube_1_0_17_1.tar.bz2
Install
Run the install.sh script from within the new directory called 'tube' by default. Example:
cd tube sh install.sh
Web Server
Most web servers require different settings to create new websites. If you are unfamiliar on how to properly configure your web server you should ask your hosting company to assist you with this step.
Admin Site
The Tube admin runs from its own hostname. If you already have a primary tube site domain you can just create a sub domain called admin. The document root of the admin domain should point to /path/to/tube/www/. So if you installed Tube Studio in the directory /home/domains/tube/ then you would make the document root '/home/domains/tube/www/.
Tube Sites
Tube studio can support multiple sites by default. Each one will use the same set of scripts located in /path/to/tube/site_scripts/. The easiest way to set up a new domain site is to make the site_scripts directory the document root for all tube sites. If you host does not support multiple domains using the same document root then you can give each domain its own document root and then create a symlink for all the needed files from the the domains document root to the site_scripts directory. You can Either symlink the entire directory or all the files within the directory.
Web Instructions
After pointing your web browser to the URL you already set up for TubeStudio you will see the TMM graphical installer. Each pages will displayed detailed information about how to complete the current steps.
Prerequisites
The Prerequisites page checks your servers current settings and verifies they it meets the minimum requirments to install and run TubeStudio. Each test will give you one of the following messages:
| passed | You meet or surpass the minimum requirement |
| passed | You meet the minimum requirement but it is recommended you increase the value |
| failed | Mminimum requirement not met. Item has to be resolved before installation can continue |
As long as all the tests say "passed" you can continue with the installation. If the test says passed with the orange text color then you can continue but it is recommended that you or your server administrator increase the setting for the best performance. For more information on TubeStudio system requirements you should refer to this page.
Paths
The paths page is where you will set up the default directory and system binary paths. The installer will make an attempt to figure out your current location and and the paths to the current binaries.
Disk Paths
TubeStudio will uses these paths for all file system operations. It is recommended that you use the default paths and only more advance users with a specific goal in mind should adjust them. You should not alter these paths once the installer is complete and these paths are saved to the configuration file. If you have a specific reason for needing to adjust a path after the installation is done you should put in a support ticket with TMM and we can assist you with any questions or problems that may come up with altering these settings.
All the paths are built of of the Root Dir path by default and all the default directories have also already been created. All paths except 1 should be absolute. The Thumbnail Web Dir path is just the web accessible part of the Thumbnail Dir path.
For example, if your is:
/path/to/tube/www/thumbs/
Then the Thumbnail Web Dir is just:
thumbs/
Since that is the part a web browser would use to access it.
Binary Paths
The binary paths are the the paths to the external programs that TubeStudio needs to use to perform tasks such as video conversion, screen capture generation, and fetching information about about a video file. Be default the correct paths should be filled in. If instead you see just a program name for any of the paths then chances are the application is not in the path for the user your web serve runs as or the program is not installed. If this is the case then you should check with your host and make sure that they are installed and/or find out what the paths are for programs not installed in the normal system path.
Database
Common Problems
Missing config.php file
This indicates that you did not run the install.sh script from the root directory of TubeStudio. You will often see an error like this:
include_once(/home/path/to/tube/www/../includes/config.php) [function.include-once]: failed to open stream: No such file or directory
