Tiny Tiny RSS Image Guide

Version 17.4

Websoft9 Tiny Tiny RSS is a pre-configured, ready to run image for running Tiny Tiny RSS on Alibaba Cloud.

Tiny Tiny RSS is an open source web-based news feed (RSS/) reader and aggregator, designed to allow you to read news from any location, while feeling as close to a real desktop application as possible.Tiny Tiny RSS was widely reviewed as a possible replacement for it in major tech blogs and online magazines. Reviewers praised its versatility but criticized its performance and installation process.

TT-RSS Stack Components

Application (Tiny Tiny RSS17.4) Software directory: /data/wwwroot/tt-

Application Server(PHP7.0,APACHE2.4) PHP Configuration File: /etc//7.0/apache2/php.ini Apache Vhost Configuration File: /etc/apache2/sites-available Apache Log Files:/var/log/apache2

Database(MYSQL5.7) Database install directory: /usr/share/mysql Database data directory: /data/mysql Database Configuration File: /etc/mysql/mysql.conf.d/mysqld.cnf PhpMyAdmin install directory: /usr/share/phpmyadmin Kown more from MySQL User Guide (http://en.websoft9.com/xdocs/manage-mysql%ef%bc%88lnmplamp- image-%ef%bc%89) 

Verify the Image

After the installation of Image,please verify it

Login on Alibaba Cloud console,get you Internet IP Address

Open you Chrome or on your local PC,visit the http://Internet IP Address/ If verify successfully,you can enter the Start Installation page of this Image If no response from browser,please check the Security Group settings (https://www.alibabacloud.com/help/doc-detail/25471.htm) to ensure that port 80 is been allowed

Start to install TT-RSS

Using Chrome or Firefox to visit: http://Internet IP Address/ to start the application installation process.It is recommended to complete below step before the installation:

Domain resolution if you want to use (Add an A record to the Internet IP Address of Server from your Domain Control Panel) Modify the MySQL password of Root through PhpMyAdmin

Then access the installation page by domain directly and complete the installation wizard for the following steps: 1. Visit http://Internet IP Address or http://yourdomain to enter the  start page of installation

2. Fill in the Database settings section and Click the “Test configuration” to check the database 3. When Database test succeeded,Click the “Initialize database”,then you will see the interface below

4. Click the “Save configuration” and Installation is complete 5. Visit http://Internet IP Address or http://yourdomain to enter the log  in interface,login with default credentials (username: admin, password: password)

6. Click the “Login” and Log in to backend of Dodiad below:

Frequently used Usernames and Passwords

Three usernames and passwords are required for application installation, application using, andapplication maintenance:

1、ResourceSpace:Username and password is set by youself when installation, Backend URL:http://Internet IP Address/ 2、MySQL Database:Default username and password is root/123456, Control Panel URL:http://Internet IP Address/phpmyadmin 3、Linux Server:Username is root,Password is set by youself when buying.You can reset the password through console and restart the Server if you have forgotten it.Please Using the Putty for Remote and WinSCP for SFTP  Backup

Routine backup (archives) of the database and application setup is essential to ensure failover is smooth.

Backup is based on the server snapshot automatic backup and manual local backup in two ways, both of which have their own advantages and disadvantages, it is recommended to use together

Automatic Backup by Snapshot of Server

IaaS provider have the “snapshot” function for Server, the snapshot is for the server disk. Snapshot tool can record the specified point in time the hard disk data, all backed up, and can achieve a key recovery.

If you have an automatic snapshot of the disk settings, the following scenes you can be more calm face:

Work a few days of the results, was mistakenly deleted Hackers damage your site The content has been messed up

Done a snapshot backup, a key to restore to the backup point of time state. That is, on-site reduction, very good function.

Different cloud vendor snapshot settings slightly different, specific reference:

How to use Alicloud snapshot? (https://www.alibabacloud.com/help/doc-detail/25455.htm)

Manual Backup

You can use Manual Backup as following steps:

1. Download the entire software directory(/data/wwwroot/tt-rss) by SFTP or other tools 2. Visit http://< Internet IP Address >/phpMyAdmin,login in to the phpMyAdmin Panel 3. Select your database,then Export it 

4. Click “go” button for backup process,and then download the SQL backup file

Upgrade

Before upgrade you should put the site down for maintenance and always Backup your code, data and config files.

It is highly recommended to temporarily disable any third party themes and user CSS customizations before upgrading. Don’t forget to empty your browser cache if you experience weird bugs right after upgrading.

Note that you should upgrade to the latest version available, installing intermediate releases sequentially is not needed.

Below are the main upgrade steps:

1. Using ssh to run command below

cd /data/wwwroot/tt-rss git pull origin master

2. Merging new config.php directives:After the files have been upgraded by newer versions, open tt-rss. It may complain about missing

directives in config.php . If that happens, you will need to either

merge new stuff from config.php-dist to your config.php or remove config.php and rerun the installer (take note to copy previous  value of FEED_CRYPT_KEY if you have feeds with authentication enabled). 3. Updating the database:Afterwards, you may be redirected to the database updater

4. You will receive the feedback message like “Performing update up to version 132…OK!Your Tiny Tiny RSS database is now updated to the latest version.”,it’s means upgrade successfull Post-upgrade tasks

1. You might need to clear your browser cache if you experience CSS or script-related issues, older scripts might have stuck in it. 2. Do not copy cache directories from your old tt-rss version, it is unnecessary and potentially creates problems if you don’t preserve file modification times. 3. If you are using an accelerator like php-apc you might need to restart apache if older cached versions of PHP files got stuck in cache (this happens rarely, but is a possibility).

How to access phpMyAdmin?

Websoft9 Mantis Image have installed the phpMyadmin

Following is the step for access phpMyadmin

1. Open Chrome or Firefox on your local PC 2. visit the http://Internet IP Address/phpMyAdmin,you can enter the login page 

3. select you language,Username:root,Password:123456 4. Click the button “Go”

How to change admin password?

Login as administrator,Go to Actions->Preferences->Users and change your password of admin:  How to start or stop the services?

You can use the command to manage the services for Server.Please choose the corresponding command mode according to different types of operating system

Ubuntu Linux

Apache http service

~# systemctl start httpd ~# systemctl stop httpd ~# systemctl restart httpd ~# systemctl reload apache2 #Configuration file

MySQL service

~# systemctl start mysqld ~# systemctl stop mysqld ~# systemctl restart mysqld

Else

~# a2dismod ModuleName #disable Apache2 module ~# a2enmod ModuleName #enable Apache2 module ~# a2ensite Configuration #enable vhost configuration ~# a2dissiteConfiguration #disable vhost configuration

How to change the permissions of filesytem?

When install new extension from back-end it will not successful,may be the permissions of file and folder is not appropriate,you should change it

Web site root permissions to follow: file 644,folder 755 ,Permissions Users and groups www-data If there is a file permissions problem, execute the following three commands:  chown -R www-data.www-data /data/wwwroot/tt-rss find /data/wwwroot/default/tt-rss -type d -exec chmod 755 {} \; find /data/wwwroot/default/tt-rss -type f -exec chmod 644 {} \;

How to modify the allowed limit for upload?

Modify the /etc/php/7.0/apache2/php.ini file to increase the allowed size for uploads:

; Maximum size of POST data that PHP will accept. post_max_size = 16M ; Maximum allowed size for uploaded files. upload_max_filesize = 16M

then,restart the apache

# systemctl restart httpd

How to modify PHP settings?

The PHP configuration file allows you to configure the modules enabled, the email settings or the size of the upload files. It is located at /etc/php/7.0/apache2/php.ini.

There are some PHP settings that need to be sufficient to install.

e.g The values for PHP.ini below are suggested values only.

memory_limit – Minimum: 256M Recommended: 1G or better upload_max_filesize – Minimum: 20M post_max_size – Minimum: 20M max_execution_time: At Least 120 Recommended: 300

After modifying the PHP configuration file, restart both Apache and PHP- FPM for the changes to take effect:  # systemctl restart httpd

How to change the max_execution_time?

If you receive the message “Maximum execution time of 30 seconds exceeded”.You may also like to extend the max_execution_time for PHP and you can modify it by two methods below

Method one: edit your /etc/php/7.0/apache2/php.ini

; Maximum execution time of each script, in seconds ; http://php.net/max-execution-time ; Note: This directive is hardcoded to 0 for the CLI SAPI max_execution_time = 90 ; Maximum amount of time each script may spend parsing request data. It ; idea to limit this time on productions servers in order to eliminate ; long running scripts.

After modifying the PHP configuration file, restart both Apache and PHP- FPM for the changes to take effect:

# systemctl restart httpd

Method two: edit your .htaccess:

php_value max_execution_time 90

TT-RSS Help Links

Hompage – https://tt-rss.org (https://tt-rss.org/) Forum – https://discourse.tt-rss.org (https://discourse.tt-rss.org/) Wiki – https://git.tt-rss.org/git/tt-rss/wiki (https://git.tt-rss.org/git/tt-  rss/wiki)

Websoft9