Gentoo Forums
Gentoo Forums
Gentoo Forums
Quick Search: in
HowTo: Install and Setup Jinzora
View unanswered posts
View posts from last 24 hours

 
Reply to topic    Gentoo Forums Forum Index Unsupported Software
View previous topic :: View next topic  
Author Message
enceladus
n00b
n00b


Joined: 13 Aug 2009
Posts: 13

PostPosted: Fri Aug 14, 2009 12:36 am    Post subject: HowTo: Install and Setup Jinzora Reply with quote

This is possibly first draft quality. If you see any errors let me know, or if I did something a less than smart way, let me know.
If you want anything added I can try to do that too.
If anyone wants to copy this to the wiki or something, feel free.

Overview
Jinzora is a web based media streaming and management system.
www.jinzora.com
I'm treating this howto as beginning from a base install, since that is what I did.

My Setup, for reference purposes
Gentoo base install
Hardened kernel and toolkit, but no access control in place
No X server
Hardware: Athlon MP 1900+, 1.5gb ram, 80gb drive
MySQL

Considerations
Currently Jinzora is only in the webapps-experimental overlay.
This uses a web based setup. While using elinks I could not proceed to step 6. I had to use another computer to connect to it using Firefox.
At the time of my install the webapps overlay had Jinzora 2.7.5 and the latest was 2.8. Portage had trouble fetching 2.7.5, so I downloaded it manually and put it in distfiles.
To finish the web based installer/Jinzora setup you do have to import some music files. A couple should be fine, you can import more later (or all upfront).

Choices
Jinzora supports several different kinds of SQL: MySQL, MSSQL, PostgreSQL, SQLite
I picked MySQL, and put the mysql use flag in my global use flags (/etc/make.conf). For this howto, I am only going to cover MySQL.

Let's Begin: Installing the Overlay
The Jinzora ebuild is in the webapps-experimental overlay (http://overlays.gentoo.org/proj/webapps/wiki).
Install layman with subversion support.
Code:
echo "app-portage/layman subversion" >> /etc/portage/package.use
emerge layman

Let portage know
Code:
echo "source /usr/local/portage/layman/make.conf" >> /etc/make.conf

Install the overlay
Code:
layman -f -a webapps-experimental


What PHP Needs
PHP use flags needed: apache2, cgi, cli, gd, iconv, pcre, session
Code:
echo "dev-lang/php apache2 cgi cli gd iconv pcre session" >> /etc/portage/package.use

Without session, the web based installer will not run. I believe pcre was also needed to run the installer.
Iconv is needed for reading id3 tags on your music files.

Install Time
Code:
emerge -pv jinzora

Make sure everything looks ok. Apache2, php5, and some other stuff should be pulled in too. If everything looks good,
Code:
emerge jinzora

Wait patiently.

Apache
Start apache2
Code:
/etc/init.d/apache2 start

Add to default runlevel
Code:
rc-update add apache2 default

Now we need to check some file permissions. The apache user should own 1 file and 2 directories in the jinzora folder. The following is edited for readability. The other files don't matter.
Code:
# ls -l /var/www/localhost/htdocs/jinzora/
drwxr-xr-x 19 apache apache   4096 Aug 11 17:35 data
-rw-r--r--  1 apache apache   5939 Aug 13 15:38 settings.php
drwxr-xr-x  3 apache apache   4096 Aug 13 15:43 temp

If yours are different, change them so apache owns them.
Code:
chown -R apache /var/www/localhost/htdocs/jinzora/settings.php
chgrp -R apache /var/www/localhost/htdocs/jinzora/settings.php


MySQL
Very useful: http://www.gentoo.org/doc/en/mysql-howto.xml
Configure MySQL. Replace 5.0.70-r1 with your MySQL version.
Code:
emerge --config =dev-db/mysql-5.0.70-r1

Portage asks for a root password for MySQL. Then configuration is done.
Start mysql and mysqlmanager.
Code:
/etc/init.d/mysql start
/etc/init.d/mysqlmanager start

Add both mysql and mysqlmanager to the default runlevel.
Code:
rc-update add mysql default
rc-update add mysqlmanager default

Log into mysql as root.
Code:
mysql -u root -h localhost -p

Create a jinzora2 database.
Code:
mysql> create database jinzora2;

Create a jinzora user. Give this user full access (I'm not sure what kind of access it really needs.) Replace password with a password of your choosing.
Code:
mysql> grant all on jinzora2.* to 'jinzora'@'localhost' identified by 'password';

Exit mysql

PHP Setup
Jinzora has some recommended PHP settings http://en.jinzorahelp.com/documentation/installation2/minimum_requirements.
Code:
Parameter          Recommended Value
file_uploads           1
max_execution_time     300
memory_limit           128
post_max_size          32
register_globals       off
upload_max_filesize    32

Change the settings in the /etc/php/apache2-php5/php.ini file. It is ok if they are not the recommended values, but I am unsure of what problems you may run into if you don't use the recommended values.
Code:
nano -w /etc/php/apache2-php5/php.ini

Use ctrl-w to search through the file for the parameters.

Jinzora Setup aka Web Based Installer
Reference with screenshots (scroll down to "Installing Jinzora"): http://maketecheasier.com/how-to-install-and-setup-jinzora-media-server-in-ubuntu/2008/08/25
Start the web based installer by navigating to http://localhost/jinzora/index.php Replace "localhost" with the appropriate IP if necessary.
Step 1: Pick a language. I picked English. Proceed.

Step 2: Requirements. If an item says “not found” that is ok. If it says fatal error, you cannot proceed without fixing it; probably you missed a step before this.
The first 2 sections should be pretty self explanatory. GD and Iconv are part of php. I do not have PDF support enabled on my server, nor any idea of how to do it.
If there is an issue under “Checking Permissions” that is related to apache not owning the file and 2 directories.
“Checking Recommended Settings” is from the php.ini file.
If everything is ok, Proceed.

Step 3: License. Check the box to agree. Proceed.

Step 4: Installation Type. I picked Standalone. For jukebox mode I picked Streaming Only. Proceed.

Step 5: Main Settings. Here we create an admin user, so pick a password. This is how you will log into the server when you get it setup.
I picked login required (because mine is web facing). Backend type is database. Front-end and style can be easily changed later.
For import settings, filesystem is recommended if your music is organized well, tag data is recommended if it is not. Pick what suits you here, and under media layout. Proceed.

Step 6: Backend Setup. This is what we created the Jinzora MySQL user for. Enter the MySQL login credentials of the jinzora user. Make sure “database name” has jinzora2 (or whatever you called your database). Server is localhost. Database type “MySQL”. Create database “true” – this lets jinzora create the tables it needs even though we already created the database. “Continue with backend install” It will fail to create the database because we already created one, this is ok. It should successfully create the tables. Proceed.

Step 7: Import media. Pretty self explanatory. You don’t need to import everything right now, but if you want to you can; you do have to import something to continue. “Import Media” Now you have the option of importing another directory. Do so if you would like, otherwise Proceed.

Step 8: Saving config. This should be successful. Proceed.

Step 9: Share anonymous stats. This is up to you. Pick one, then “Launch Jinzora”

Log in using the admin account you set up in Step 5.
Now it complains about the install being unsecure because the install directory needs to be removed. I renamed it.
Code:
mv /var/www/localhost/htdocs/jinzora/install /var/www/localhost/htdocs/jinzora/install-used

Refresh the page. Now you have a working jinzora setup.

Post Setup
You can change the interface and theme under preferences in the upper right hand corner.
To add another media directory, go to "Media Manager" under the "System Tools" drop box in the lower right hand corner of the page.



TODO
adding user?
anything I later realize I missed?
Back to top
View user's profile Send private message
NathanZachary
Moderator
Moderator


Joined: 30 Jan 2007
Posts: 2469
Location: /home/zach

PostPosted: Fri Aug 14, 2009 2:58 pm    Post subject: Reply with quote

Thank you for the detailed guide, but I'm moving this thread from Documentation, Tips & Tricks to Unsupported Software, as Jinzora is not available in the main Portage tree. Thanks to nightmorph for reporting.
_________________
“Truth, like infinity, is to be forever approached but never reached.” --Jean Ayres (1972)
---avatar cropped from =AimanStudio---
Back to top
View user's profile Send private message
enceladus
n00b
n00b


Joined: 13 Aug 2009
Posts: 13

PostPosted: Fri Aug 14, 2009 8:06 pm    Post subject: Reply with quote

Thanks. Sorry, I didn't realize it was in the wrong place.
Back to top
View user's profile Send private message
NathanZachary
Moderator
Moderator


Joined: 30 Jan 2007
Posts: 2469
Location: /home/zach

PostPosted: Fri Aug 14, 2009 10:19 pm    Post subject: Reply with quote

No problem at all; that's what we're here for. :) Thanks again for your nice work on the guide!
_________________
“Truth, like infinity, is to be forever approached but never reached.” --Jean Ayres (1972)
---avatar cropped from =AimanStudio---
Back to top
View user's profile Send private message
Display posts from previous:   
Reply to topic    Gentoo Forums Forum Index Unsupported Software All times are GMT
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum