3,250
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − + − {{Level|easy}} − + + + + + + + + + + − === Description === − smeserver-webbapps-common is not really a contrib, it is more a framework like used by many contribs of [[fws]] − + − This contrib is currently held in the fws repository, You do not need to install it alone, it is a dependency of other package such as tt-rss+ + + + + + + + + + + + + + + + + + + + + + + − However you can use to reconfigure some web application of fws by using + + + + + + + + + Line 23:
Line 59: − + − + − + − + + − + + + + + + + + + Line 34:
Line 79: + + + + + + + + + + + + − + +
→Bugs
{{Languages}}
{{Languages}}
{{Level|advanced}}
== webbapps-common for SME Server ==
== webbapps-common for SME Server ==
=== Maintainer ===
=== Maintainer ===
[mailto:daniel@firewall-services.com[[User:VIP-ire|Daniel B.]]] from [http://www.firewall-services.com Firewall Services]
[mailto:daniel@firewall-services.com][[User:VIP-ire|Daniel B.]] from [http://www.firewall-services.com Firewall Services]
=== Version ===
{{#smeversion: smeserver-webapps-common }}
[[Version::contrib9|fws]][[Has SME9::true| ]]
==About==
The webapps tool is a set of template fragments and actions that can be helpful to create Apache Virtual hosts in a flexible way outside of the default IBays. For example you would like your web application to be available from '/opt/myapp'. The webapps tool also provides the ability serve your web application as a sub domain on your main domain e.g. 'http://myapp.mydomain.com'. Next to this there are a number of parameters that can be set that control flexibility and security.
Installing the webapps tool will not provide any additional functionality to server-manager, nor any other visible change to the end user. The webapps functionality is solely ''controlled by db keys and events''.
=== Requirements ===
=== Requirements ===
You need the [[Fws|firewall-services]] repo to install this contribs
You need the [[Fws|firewall-services]] repo to install this contribs
=== Installation 8.x 9.x===
=== Installation 8.x 9.x i386===
The webapps tool is currently available in the Firewall Services repository. To enable the FWS repo please see [http://wiki.contribs.org/Fws '''here''']
Some of the existing contribs already use the webapps tool and therefore the webapps tool is being installed as a dependecy for that contrib. The following contribs are know to have a dependency on the webapps tool:
* [http://wiki.contribs.org/SharedFolders SharedFolders]
* [http://wiki.contribs.org/LemonLDAP-NG LemonLDAP-NG]
* TBA
After enabling the [[fws]] repo,
yum install smeserver-extrarepositories-fws --enablerepo=smedev,smecontribs -y
signal-event yum-modify
you can install the webapp tool:
yum install smeserver-webapps-common --enablerepo=fws
config set UnsavedChanges no
You can use to reconfigure some web application of fws by using
signal-event webapps-update
=== Installation 9.x x86_64 ===
install needed repos
yum install smeserver-extrarepositories-remi-safe smeserver-extrarepositories-fws smeserver-extrarepositories-epel -y
signal-event yum-modify
Install and start fpm services
yum install smeserver-webapps-common --enablerepo=fws,epel
config set UnsavedChanges no
signal-event webapps-update
service php-fpm restart
service php56-php-fpm restart
service php70-php-fpm restart
service php71-php-fpm restart
You can use to reconfigure some web application of fws by using
signal-event webapps-update
signal-event webapps-update
The most important things to know is that you can create a domain by command line. More features will be created
The most important things to know is that you can create a domain by command line. More features will be created
compared with the standard virtualhost templates, you have:
compared with the standard virtualhost templates, you have:
* the '''DocumentRoot''' key, which lets you choose an arbitrary document root instead of having to choose an ibay
* '''DocumentRoot''' to set an arbitrary document root instead of having to choose an ibay
* the '''RequireSSL''' key
* '''DirectoryIndex''' to set an specific index-files string (default "")
* the '''Authentication''' key
* '''RequireSSL''' to ask the forced SSL communication (default 'disabled', on by 'enabled')
:* '''Authentication Basic''' : to ask for a basic auth when reaching this vhost
* '''Authentication''' different ways to protect your domain
:* '''Authentication Basic''' : to ask for a basic auth when reaching this vhost (all valid users of sme server)
:* '''Authentication LemonLDAP''' : to ask for a smeserver-lemonldap-ng when reaching this vhost
:* '''Authentication LemonLDAP''' : to ask for a smeserver-lemonldap-ng when reaching this vhost
* '''ProxyPassTarget''' target of the ProxyPassReverse and ProxyPass (default "", enabled by an URL)
* '''Redirect''' target of the RedirectMatch permanent (default "", enabled by an URL)
* '''Rewrite''' target of the RewriteRule (default "" enabled by an URL)
* '''AllowHosts''' 'local' or 'IP,IP,IP...' (default "")
* '''ProxyPreserveHost''' target of the 'ProxyPreserveHost on' (default is no, enabled is yes)
* '''ProxyNoKeepAlive''' target of the 'SetEnv proxy-nokeepalive 1'(default is no, enabled is yes)
* '''Alias''' target of the Alias (alias,target) (default "")
* '''SetEnv''' target of the SetEnv (parameter,parameter) (default "")
* '''AllowGroups''' all groups listed will be granted by LDAP to browse the web directory (group1,group2,group3) (default "")
You can create a domain like this:
You can create a domain like this:
db domains set stuff.foo.fr domain Description "My super custom app" Content Primary Nameservers internet TemplatePath WebAppVirtualHost DocumentRoot /opt/stuff RequireSSL enabled
db domains set stuff.foo.fr domain Description "My super custom app" Content Primary Nameservers internet TemplatePath WebAppVirtualHost DocumentRoot /opt/stuff RequireSSL enabled
signal-event domain-create stuff.foo.fr
signal-event domain-create stuff.foo.fr
* For example with the wordpress contribs installed in /usr/share/wordpress
If you haven't done anything, then / points on the Primary ibay as expected, and not on wordpress. If you want a domain to point on an arbitrary location (not an ibay), you can use smeserver-webapps-common:
db domains setprop www.foo.com TemplatePath WebAppVirtualHost DocumentRoot /usr/share/wordpress
signal-event webapps-update
=== Bugs ===
=== Bugs ===
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
and select the smeserver-webapps-common component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-webapps-common|title=this link}}.
{{#bugzilla:columns=id,product,version,status,summary |sort=id|order=desc |component=smeserver-webapps-common|noresultsmessage="No open bugs found."}}
Sources for this contribs can be found in Firewall Service's repository [http://gitweb.firewall-services.com/?p=smeserver-webapps-common;a=summary]
Sources for this contribs can be found in Firewall Service's repository [http://gitweb.firewall-services.com/?p=smeserver-webapps-common;a=summary]
[[Category: Contrib]]
[[Category: Deprecated_Contrib]]