A step-by-step guide of installing tt-rss on CentOS 5.7

Howtos, instructions and links to related software. Do not ask questions here.
lazycai
Bear Rating Trainee
Bear Rating Trainee
Posts: 5
Joined: 14 Nov 2011, 18:29

A step-by-step guide of installing tt-rss on CentOS 5.7

Postby lazycai » 14 Nov 2011, 18:39

I know it's really basic, but I think there are quite a number of inexperienced people like me who really need a detailed installation guide - the official guide on the wiki and the Linux.com article really couldn't guide me well :-(

Anyway, here we go. The tut was first published on my wordpress blog: [url]http://lazycai.wordpress.com/2011/11/08/ttrss-1-5-6-install/[/url] (and there is a Chinese guide as well, if you are interested)

The following installation guide assumes you have not configured you LAMP environment, but has got a working yum repository.

OS: CentOS 5.7 (RHEL/Fedora equivalent)

1. Install MySQL, Apache and PHP

shell> yum install mysql mysql-server
shell> yum install httpd php php-common

You would need some php modules. I'm not sure what is required other than php-xmlrpc, so you might want to install all the common stuffs:

shell> yum install php-pear php-pdo php-mysql php-pgsql php-pecl-memcache php-gd php-mbstring php-mcrypt php-xml php-xmlrpc

2. Start services

shell> service mysql start
shell> service httpd start

Do your security initialization if you haven't done it yet:

shell> /usr/bin/mysql_secure_installation

3. Download the latest version of tt-rss (which is v1.5.6 in this case)

shell> wget http://tt-rss.org/download/tt-rss-1.5.6.tar.gz

4. Unzip it

shell> tar -zxvf tt-rss-1.5.6.tar.gz -C /var/www/html

5. Create you database and user

First, enter you MySQL as root:

shell> mysql -u root -p

The password should have been setup upon initialization.

Create database:

mysql> CREATE DATABASE ttrssdb;

Create a user to access this database:

mysql> GRANT ALL ON ttrssdb.* TO ttrssuser IDENTIFIED BY "SomePassword";

And you are done here.

mysql> quit;

6. Create all the tables - with the script that came along with the source file!

shell> cd /var/www/html/tt-rss

shell tt-rss> mysql -u ttrssuser -D ttrssdb -p < schema/ttrss_schema_mysql.sql

7. Configuration file

shell tt-rss> cp config.php-dist config.php
shell tt-rss> vi config.php

There are several things you need to specify:

define('DB_TYPE', "mysql");
define('DB_HOST', "localhost");
define('DB_USER', "ttrssuser");
define('DB_NAME', "ttrssdb");
define('DB_PASS', "SomePassword");
define('SELF_URL_PATH', 'http://your.domain.com/tt-rss');

Make sure your password is correct or you'll get Connection Failed warnings.

And there is one more thing, which you'll find at the end of all pages:

define('ISCONFIGURED', false);
// Please set this to true if you have read everything above and
// finished setting configuration options.

(Well, I was stuck here for one whole night...)

8. Test it

Run an auto-check in your web browser:

your.domain.com/tt-rss/sanity_check.php

There might be some permission issues with the "icons" directory, which could be resolved by

shell tt-rss> chmod -R 777 icons

Now we can already see our pages showing up, but you can't see any contents yet. One last step to go:

9. Update feeds

You'll need to update feeds at the background, so setup a screen first:

shell tt-rss> screen -S updaterss

(Do a yum install screen if you haven't got it)

Under this screen, do

shell tt-rss> php ./update.php -daemon

if you are under single-user mode, or

shell tt-rss> php ./update_daemon2.php

if you are under multi-user mode.

And now you can detach from the screen with CTRL+A+D shortcut.

Now go to your.domain/tt-rss/ to try it out!
Last edited by lazycai on 16 Nov 2011, 06:40, edited 1 time in total.

Usul
Bear Rating Trainee
Bear Rating Trainee
Posts: 38
Joined: 23 Jul 2008, 10:36

Re: A step-by-step guide of installing tt-rss

Postby Usul » 15 Nov 2011, 18:02

If you target "inexperienced people", you should mention the distribution you use, since yum is not the package manager of every distribution. Do you use Fedora or RedHat?

Second, running the update daemon manually in a screen may work, but is not a permanent solution. Why not explaining to setup a proper daemon with an init script, automatically started on boot? It's not that hard.

User avatar
fox
^ me reading your posts ^
Posts: 6318
Joined: 27 Aug 2005, 22:53
Location: Saint-Petersburg, Russia
Contact:

Re: A step-by-step guide of installing tt-rss

Postby fox » 15 Nov 2011, 18:29

[quote]Second, running the update daemon manually in a screen may work, but is not a permanent solution.


FWIW, I've been doing this for like 5 years now. :)