Changes

From SME Server
Jump to navigationJump to search
3,780 bytes added ,  17:40, 28 June 2011
m
Created page with "{{Languages}} ===Maintainer=== Daniel B.<br/> [http://www.firewall-services.com Firewall Services]<br> mailto:daniel@firewall-services.com === Description ==..."
{{Languages}}


===Maintainer===
[[User:VIP-ire|Daniel B.]]<br/>
[http://www.firewall-services.com Firewall Services]<br>
mailto:daniel@firewall-services.com


=== Description ===

[http://tt-rss.org/redmine/ Tiny Tiny RSS] is a web based RSS reader.

=== Requirement ===

This contrib has been developped and tested on SME Server 8b6 and later. It probably won't work on SME 7.

=== Installation ===

Configure Firewall-Services's repository:

db yum_repositories set fws repository \
BaseURL http://repo.firewall-services.com/centos/\$releasever \
EnableGroups no GPGCheck yes \
Name "Firewall Services" \
GPGKey http://repo.firewall-services.com/RPM-GPG-KEY \
Visible yes status disabled
signal-event yum-modify

*install the rpms

yum --enablerepo=fws install smeserver-tt-rss

* Appply the needed configuration:

signal-event webapps-update
db configuration set UnsavedChanges no

You can now access the application using this URL: https://your-server.domain.tld/tt-rss
All users created on your SME Server can login with their usual credentials.

=== Additional options ===

Some settings are available from the DB

* '''Authentication''': Control the way users are authenticated. Correct values are '''http''' (apache protect the access), '''internal''' (uses the internal database to manage users and groups. An admin have to create user account before they can login). If you use the internal authentication mechanism, you need to login using admin/admin. A last value is available for this prop: '''LemonLDAP''' which uses [[LemonLDAP-NG]] to validate credentials, and the internal ldap server do get user/group information. You can have more information on this later on this page.
* '''MultiUser''': If set to disabled, the application will only manage one profile, everyone will share the same settings, the same list of RSS etc...
* '''AliasOnPrimary''': can be enabled or disabled (default is enabled). This prop lets you disable the access to Tiny Tiny RSS on your primary domain (the alias /tt-rss won't be added in apache configuration). This is useful if you want the application to be available only with a virtualhost.


example:
db configuration setprop tt-rss AliasOnPrimary disabled
signal-event webapps-update

=== Intergration with LemonLDAP::NG ===
Tiny Tiny RSS can be protected by LemonLDAP::NG. Here're the steps to protect it

==== Disable the access on the primary domain ====
You should disable the access to Open Upload on your primary domain:
db configuration setprop tt-rss AliasOnPrimary disabled
signal-event webapps-update

==== Enable LemonLDAP::NG integration ====
This contrib support LemonLDAP NG auth quite easily:
db configuration setprop tt-rss Authentication LemonLDAP
signal-event webapps-update

==== Create a new virtualhost for Tiny Tiny RSS ====
Lets create a new virtualhost for Open Upload. You can choose the name you want, for example, lets create upload.domain.tld:

db domains set rss.$(db configuration get DomainName) domain Content Primary Description 'Tiny Tiny RSS' \
DocumentRoot /usr/share/tt-rss Nameservers internet TemplatePath WebAppVirtualHost \
LemonLDAP enabled
signal-event domain-create rss.$(db configuration get DomainName)
signal-event webapps-update

==== Declare this virtualhost in LemonLDAP ====
You can now create the virtualhost in LemonLDAP management interface. You can create the rules you want. For example, here're the rules to accept only members of the group 'rss'

* Comment: default
* Rule: $groups =~ /\brss\b/

=== Uninstall ===
If you want to remove the contrib, just run:
yum remove tt-rss


=== Source ===
The source for this contrib can be found in Firewall-Services's repository [http://repo.firewall-services.com/centos/5/SRPMS/].

----
[[Category:Contrib]]

Navigation menu