forked from WillyXJ/facileManager
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
116 lines (86 loc) · 4.01 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
_/ _/
_/_/ _/_/ _/_/ _/ _/_/
_/ _/ _/ _/ _/ _/ _/ _/_/
_/_/_/ _/ _/ _/ _/ _/ _/
_/ _/_/ _/ _/_/ _/ _/ _/_/
_/
_/ _/ _/_/
_/_/ _/ _/ _/_/ _/ _/_/ _/_/ _/_/ _/_/ _/ _/_/
_/ _/ _/ _/ _/ _/_/ _/ _/ _/ _/ _/ _/ _/_/ _/_/
_/ _/ _/ _/ _/ _/ _/ _/ _/ _/ _/ _/
_/ _/ _/_/ _/ _/ _/ _/_/ _/ _/_/_/ _/_/ _/
_/
_/_/
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 DNS servers we are
managing.
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-available/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.
`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.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. Copy your backup of config.inc.php to /usr/local/facileManager.