Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/WillyXJ/facileManager

A modular suite of web apps built with the sysadmin in mind.
https://github.com/WillyXJ/facileManager

Last synced: 5 days ago
JSON representation

A modular suite of web apps built with the sysadmin in mind.

Host: GitHub
URL: https://github.com/WillyXJ/facileManager
Owner: WillyXJ
License: gpl-2.0
Created: 2013-08-09T18:30:43.000Z (about 11 years ago)
Default Branch: master
Last Pushed: 2024-05-14T18:53:15.000Z (6 months ago)
Last Synced: 2024-05-15T15:16:50.546Z (6 months ago)
Language: PHP
Homepage: www.facilemanager.com
Size: 9.51 MB
Stars: 84
Watchers: 18
Forks: 38
Open Issues: 31
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

awesome-starred - WillyXJ/facileManager - A modular suite of web apps built with the sysadmin in mind. (others)

README

        facileManager

=============

                                          

(c) by facileManager project members.

facileManager is free software released under the terms of GNU GPL v2.

Please see LICENSE for license.

Official site: http://www.facilemanager.com

Official git repository: https://github.com/WillyXJ/facileManager

Installation instructions for facileManager

===========================================

This document describes the necessary steps to install facileManager and get it

to a working state - it shouldn't take long at all!

There are two parts: the server and the client(s).  The server is where the web

interface will run from.  It is **_not_** required to host the MySQL database on the

same server as the web interface.  The client runs on the servers to manage.

Please note: Internet Explorer is not supported - it's too tiresome.

Prerequisites

-------------

facileManager (server) requires the following:

* PHP 5.5.0+ with MySQL support

* MySQL 5.0 or later

  * Required MySQL user privileges on the database include

   `SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, DROP, LOCK TABLES`

* A working webserver (httpd) with mod_rewrite.so enabled

* facileManager-core

* JavaScript enabled in your web browser

fM client requires the following:

* ISC BIND 9.3 or later (for the fmDNS module only)

* PHP 5.0+

* A running web server if using http(s) update methods

  * The install script supports the following web servers:

    * httpd

Server Installation

-------------------

1. Move the contents of the server directory to your document root.

   (ie /var/www/html/facileManager/)

2. Point your web browser to http://example.com/facileManager/ or your

   virtualhost if you set one up (ie http://facileManager.example.com).

3. Follow the installation wizard to setup your database.

Additional Steps (OS-based)

---------------------------

The following steps need to be performed on vanilla installations of certain 

Operating Systems to allow .htaccess files to be used.

### Debian-based/Ubuntu - 

> Edit /etc/apache2/sites-enabled/default and change 'AllowOverride 

> None' to 'AllowOverride All' under `` and reload 

> apache.

### RHEL7/CentOS7 - 

> Edit /etc/httpd/conf/httpd.conf and change 'AllowOverride 

> None' to 'AllowOverride All' under `` and reload 

> apache.

Client Installation

-------------------

1. Move the contents of the client directory to /usr/local/ on your client

   servers to manage. (Note: client files from the core (or complete) package

   are also required.)

   `sudo mv facileManager/client/facileManager /usr/local/`

2. For each module you wish to use, run the following on each client to complete

   the installation.

   `sudo php /usr/local/facileManager//client.php install`

	

Upgrade instructions for facileManager

======================================

This section describes the necessary steps to upgrade facileManager and get it

to a working state - it shouldn't take long at all!

Server Upgrade

--------------

1. Make a backup of your database using the built-in tool via the UI or manually.

2. Make a backup of your config.inc.php file.

3. Delete your old facileManager files.

4. Extract/upload the new files from the server directory.

5. Copy your backup of config.inc.php to the document root.

   (ie /var/www/html/facileManager/)

6. Login as a super-admin to facileManager and follow the wizard to upgrade 

   your database.

7. Once fM is upgraded, you will be redirected to the admin-modules page where

   you can upgrade your modules individually.

Alternatively, since v3.0, you can update the server through the UI (modules

page).  You should still backup your database though!

Client Upgrade

--------------

1. Make a backup of your config.inc.php file.

   `cp /usr/local/facileManager/config.inc.php .`

2. Move the contents of the client directory to /usr/local/ on your client

   servers to manage.

   `sudo mv facileManager/client/facileManager /usr/local/`

3. Restore your backup of config.inc.php to /usr/local/facileManager.

   `sudo mv config.inc.php /usr/local/facileManager`

Alternatively, since v1.1, you can update the clients through the UI (servers

page) or by running the following on the clients:

`sudo php /usr/local/facileManager//client.php upgrade`