Coder Social home page Coder Social logo

mike2m / facilemanager Goto Github PK

View Code? Open in Web Editor NEW

This project forked from willyxj/facilemanager

0.0 1.0 0.0 2.35 MB

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

Home Page: www.facilemanager.com

License: GNU General Public License v2.0

PHP 93.68% CSS 4.11% JavaScript 2.22%

facilemanager's Introduction

                                _/ _/
        _/_/   _/_/      _/_/     _/  _/_/ 
     _/     _/    _/  _/      _/ _/ _/ _/_/
    _/_/_/ _/    _/  _/      _/ _/ _/      
   _/       _/_/ _/   _/_/  _/ _/    _/_/ 
  _/
_/  _/    _/_/
   _/_/ _/ _/   _/_/    _/  _/_/     _/_/     _/_/    _/_/   _/  _/_/
  _/  _/  _/ _/    _/  _/_/    _/ _/    _/ _/    _/ _/ _/_/ _/_/
 _/      _/ _/    _/  _/      _/ _/    _/ _/    _/ _/      _/
_/      _/   _/_/ _/ _/      _/   _/_/ _/  _/_/_/    _/_/ _/
                                              _/
                                          _/_/
                                          
Created by Jon LaBass <http://www.jonlabass.com> and Tim Rowland <http://www.nebtech.net>.

(c) 2013 by facileManager project members.
facileManager is free software released under the terms of GNU GPL v2.
Please see LICENSE for license.


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.2.0 or later with MySQL support
    * MySQL 4.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 fmDNS)
    * PHP 5.0 or later
    * 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)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Debian-based/Ubuntu - 
         Edit /etc/apache2/sites-enabled/default and change 'AllowOverride 
         None' to 'AllowOverride All' under <directory /var/www/> 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 to complete the client
    installation.
    `sudo php /usr/local/facileManager/<module_name>/{dns,fw}.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.


Client Upgrade
---------------

1.  Make a backup of your config.inc.php file.
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.

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/<module_name>/{dns,fw}.php upgrade`

facilemanager's People

Contributors

willyxj avatar bigwillystyle42 avatar dennobaby avatar hart323 avatar newphp avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.