JVideoDirect Installation
From JVideoDirect Documentation
Contents |
Component Core
Download the latest version
It is recommended that the latest version is used at all time. It included bug fixes and new features.
Free Members can obtain the component package from "Core File" in the download area.
Subscribers should always obtain the component package from "Latest Core File" in the download area.
Installation
Upload Package File
The core component should install automatically in Joomla 1.5 under the Extension Manager tool. To install a new component you need to log into your administration panel and click on the Install/Uninstall option under the Extensions menu option.
Install from Directory
If you often have problems installing large packages into your Joomla installation we recommend you install jVideoDirect using the install from directory tool.
- Adding files by FTP
- Download the latest core component from jVideoDirect website.
- Locate it in your local computer and unzip it. (Only unzip the main package. Do not unzip any files in the main package)
- Upload the contents of the main package to JoomlaRoot/media/jvd/ (if directory "jvd" does not exists, please create it.)
- Install from Directory
- Log into your Joomla administrator and visit the Install/Uninstall page under the main Extensions menu option.
- Using the Install Directory field enter the full server path to the /media/jvd directory you just created.
- Click the Install button.
Completion of Installation
During the process of installation, installation tasks will be outputted to the screen. There might be errors during the installation which will mean you need to manually perform various tasks on your server. see common installation errors
To Complete installation, you need to perform steps specified in Post Installation Tasks
Post Installation Tasks
To ensure your server settings meet the requirement of jVideoDirect.
The following tasks are strongly recommended.
Step 1: Create jVideoDirect configuration file
jVideoDirect stores all your configuration in a database.
Instead of creating lots of database activity when configuration is needed, we store it to a working file.
Configuration file is created/updated dynamically each time you save your configuration.
This file contains your preference to operate jVideoDirect.
Although, our installer will attempt to save it for you.
It is good practice to save your configuration once, after installation or re-installation jVideoDirect,
Step 2: System Check Up
This is a tool to check if minimum requirement for jVideoDirect is met.
If any test is failed, likely jVideoDirect will not operate as expected.
This tool can be found at joomla admin -> components -> jVideoDirect -> Checkup
This test attempt to do the following:
- Check if php configuration can meet the requirement.
- Check if Directory Permission of jVideoDirect storage directories are writable by username of apache. (Since jVideoDirect uses background process to minimize long waiting time by users, very likely background process will be owned by PHP in the username of apache). ... to read more, click here.
- Background Process (Needed to pass for users who required "Video Upload")
Prerequisite
- Make sure you have created jVideoDirect configuration file (see Step 1)
- Make sure you have selected "add video mechanism" that suit your need at configuration -> upload.
- "Path to PHP" to be filled at Configuration -> Converter (optional) (This is required for users who required "Video Upload").
To use this tool
- Press "Proceed"
The Logic Behind Check Up Tool
Different server environment may have different behaviour, we hope that this Check Up tool works for all.
If it doesn't works for your server environment, you may like to understand "The Logic Behind Check Up Tool".
Troubleshooting - Checkup
What to do if any test failed in Check UP?
see Troubleshooting - Checkup
Step 3: Tester
This is a video conversion test for user who is prepare to use video upload feature.
Theoretically, If your server passed Tester, you should have no problem uploading video.
This tool can be found at joomla admin -> components -> jVideoDirect -> Tester
Prerequisite
- Make sure you have created jVideoDirect configuration file (see Step 1)
- All tests in "Checkup" are passed
- Converter ready to be used, see Converter Setup
- "Path to PHP, Wget, Ffmpeg, Mencoder, Mplayer, Flvtool2 and optional MP4Box or qt-faststart" to be filled at Configuration -> converter. Linux users can use "detect" button to fill the field. "Detect" button uses "which" command to locate it's path. For some reason some server which has multiple copies of same application, "Detect" button may failed to detect the correct path for the relative command.
To use this tool
- Press "Test It". This will transcode and generate relevant files from sample video.
- Press "Erase Output files". This will erase all files generated.
- If you like to use your own video clip to perform the test, You may upload it to /joomla root/jMediaDirect/videos/tester/ and input the name into the field.
The Logic Behind Tester Tool
Different server environment may have different behaviour, we hope that this Tester tool works for all.
If it doesn't work for your server environment, you may like to understand "The Logic Behind Tester Tool".
Troubleshooting - Tester
What to do if any test failed in Tester?
see Troubleshooting - Tester
Modules
All Modules are installed via Joomla extensions tool.
Plugins
There are 2 types of plugins.
They can be distinguished by their package prefix.
Each plugin type install using different installer
| Package Prefix | Installer | Example |
| jvd_plg_ | components -> jVideoDirect -> configuration -> plugin | jvd_plg_tudou.zip |
| plg_ | Joomla Extensions Tool | plg_search_jvideodirect.zip |
| plug_ | relevant extension's backend plugin installer | plug_cb_jvideodirect.zip components -> comprofiler -> plugins |
Migrating from Localhost to Production Server
jVideoDirect's operation relies on many server side processing and specific environment.
If you have setup successfully on one machine, it doesn't mean the same settings will work on the other machine.
After any types of migration, it is recommended to perform Post Installation Tasks and/or any special steps again to ensure jVideoDirect can operate successfully on that machine.
Especially, Directory Permission on jVideoDirect storage directories.
