Linux Installation with shell access
From JinzoraWiki
This manual describes the steps to install Jinzora on a Linux Server by using a shell (sometimes referred to as command line) locally or by SSH. If you don't have shell access to your server, use the manual 'Linux Installation without shell access' instead.
There are several factors that influence the exact steps needed to install Jinzora, like the backend you're going to use, the way your media is organized, the player you will be using etc. This manual describes the most common Jinzora setup. Your specific setup might differ, but this should get you started.
Contents |
Assumptions
- You have root privileges on the server.
- You have shell or SSH access to the server.
- You can store files on the server by FTP or other means.
- Your media is stored locally on the server.
- You are using Jinzora 2.x.
- You are using the optional MySQL Database Backend.
- PHP 4+ and MySQL 4+ are already configured.
Minimum Requirements
Jinzora has very few requirements. Basically, a web server that supports PHP 4 or higher is all you need. To unleash the full potential of Jinzora you can install optional third party software.
Import Method
Correctly importing your media is crucial to how Jinzora works. If you don't know what Import Method to use, please read that page first. You really should understand this before beginning any Jinzora installation!
Downloading Jinzora
For use on a live server, we recommend using the latest Stable Release. If you like to live on the edge, you could download the latest unstable code from our Subversion Repository, but do that for testing purposes only. This manual is meant for Stable Versions only.
After you've downloaded the Jinzora Package for Linux, store it on you server by FTP. Since the use of FTP is sufficiently described elsewhere, we are not going into detail here.
Logging on to your server
The following steps are done from the command line, by shell or SSH. Logon to your server and become root by typing the following command:
sudo su
When asked, enter your root password. Navigate to the directory where you've stored the Package. In our example we've stored it as /home/johndoe/jz2current.tar.gz.
cd /home/johndoe/
Uncompressing the Package
The Jinzora Package is a tarball, compressed in gzip format. Once uncompressed, a new directory called 'jinzora2' is created. Uncompress it by issuing the following command: 'tar -zxvf jz[version].tar.gz'.
Replace [version] by the version number you've downloaded. For example 'tar -zxvf jz275.tar.gz' or 'tar -zxvf jz2current.tar.gz'.
tar -zxvf jz2current.tar.gz
Moving the directory
The newly created directory 'jinzora2' contains all files you need. You need to move this directory somewhere where your web server can access it. In our example, we are moving it to /var/www/mywebsite/jinzora2/. Replace this by the location you want to use.
mv /jinzora2 /var/www/mywebsite.com/
Open the jinzora2 directory in it's new location:
cd /var/www/mywebsite.com/jinzora2/
Setting Permissions
Your web server needs write permissions to some of the Jinzora files. To write log files and cached pages for example. We've created a script called 'configure.sh' that sets the required permissions. First, the schript needs to be made executable:
chmod 744 configure.sh
Run the script to set permissions:
sh ./configure.sh
This will create the necessary files and setup proper permissions.
Starting the Web Based Installer
Congratulations! You're server is now prepared to start the Jinzora Web Based Installer (WBI) that guides you through the final steps of installation!
Use a web browser to open the WBI. In our example it's available at http://mywebsite.com/jinzora2/.
Fire up the Web Based Installer.
