Anyway, here we go. The tut was first published on my wordpress blog: http://lazycai.wordpress.com/2011/11/08/ttrss-1-5-6-install/ (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!
