Commit | Line | Data |
---|---|---|
de8695b2 DO |
1 | Thank you for selecting RackTables as your datacenter management |
2 | solution. Feel free to address your questions to the mailing list | |
ad592f37 | 3 | before contacting the developers directly. |
de8695b2 | 4 | |
ad592f37 DO |
5 | Project homepage: http://racktables.org/ |
6 | Project SF page: http://sourceforge.net/projects/racktables/ | |
7 | Documentation: http://sourceforge.net/apps/mediawiki/racktables/index.php?title=Main_Page | |
8 | Users mailing list: <racktables-users/=@=/freelists.org> | |
9 | Mailing list archive: http://www.freelists.org/archive/racktables-users | |
10 | Developers: <info/=@=/racktables.org> | |
de8695b2 DO |
11 | |
12 | ******************************************************* | |
13 | * * | |
14 | * INSTALLING RACKTABLES * | |
15 | * * | |
16 | ******************************************************* | |
17 | ||
d3372430 | 18 | I. Install dependencies. |
de8695b2 | 19 | |
3ebdbeed | 20 | For database you must have a MySQL server installation |
e1ae3fb4 AD |
21 | version 4.x or 5.x. InnoDB support must be enabled. |
22 | It is a good idea to make it use UTF-8 by default. | |
3ebdbeed DO |
23 | |
24 | * Fedora 8/9: yum install mysql-server mysql | |
25 | put "default-character-set=utf8" into /etc/my.cnf | |
26 | ||
27 | * ALTLinux Desktop 4.0: apt-get install MySQL-server | |
28 | put "CHSET=utf8" into /etc/sysconfig/mysqld | |
29 | ||
3e1c9c67 | 30 | * openSUSE 11.0: YaST -> Software -> software management -> Web and LAMP server -> mysql |
3ebdbeed | 31 | put "default-character-set=utf8" into /etc/my.cnf |
de8695b2 | 32 | |
9ddee5ea DO |
33 | For web-frontend you must have Apache and PHP 5 with PDO and multibyte |
34 | extensions: | |
3ebdbeed DO |
35 | |
36 | * Fedora 8/9: yum install httpd php php-mysql php-pdo php-gd php-snmp php-mbstring | |
37 | ||
38 | * ALTLinux Server 4.0: apt-get install apache2-httpd-prefork php5-gd2 \ | |
9ddee5ea | 39 | php5-pdo_mysql php5-pdo apache2-mod_php5 php5-mbstring |
c2d46542 | 40 | |
3ebdbeed | 41 | * openSUSE 11.0: use YaST to apache2-mod_php5, php5-gd, php5-mbstring, php5-mysql, |
93bdb7ba | 42 | php5-snmp and php5-ldap |
3ebdbeed | 43 | |
a3bce64d DO |
44 | * FreeBSD 7: |
45 | # make -C /usr/ports/www/apache13-modssl install | |
46 | # make -C /usr/ports/www/php5-session install | |
47 | [X] CLI Build CLI version | |
48 | [X] APACHE Build Apache module | |
49 | [X] MULTIBYTE Enable zend multibyte support | |
50 | # make -C /usr/ports/graphics/php5-gd install | |
51 | # make -C /usr/ports/databases/php5-pdo_mysql install | |
c20f01f4 DO |
52 | # make -C /usr/ports/devel/pcre install |
53 | !!! Enable UTF-8 support ............ : yes | |
54 | !!! Unicode properties .............. : yes | |
a3bce64d DO |
55 | # make -C /usr/ports/devel/php5-pcre install |
56 | # make -C /usr/ports/converters/php5-mbstring install | |
57 | [X] REGEX Enable multibyte regex support | |
58 | ||
59 | # make -C /usr/ports/net-mgmt/php5-snmp install | |
60 | # make -C /usr/ports/net/php5-ldap install | |
d3372430 DO |
61 | |
62 | II. Prepare the files and database. | |
de8695b2 DO |
63 | 1. Unpack the tarball and make it web-accessible, e.g. http://yourcompany.com/racktables |
64 | or http://racktables.mysite.org. | |
1538b9c9 DO |
65 | |
66 | 2. Setup MySQL database: | |
67 | mysql> CREATE DATABASE racktables_db CHARACTER SET utf8 COLLATE utf8_general_ci; | |
68 | mysql> grant all privileges on racktables_db.* to XXX@YYY identified by 'ZZZ'; | |
c2d46542 DO |
69 | |
70 | ||
d3372430 | 71 | III. Finish the installation. |
c2d46542 DO |
72 | Open your RackTables URL and follow the instructions. In a suitable |
73 | environment everything should take a minute or so. | |
74 | ||
de8695b2 DO |
75 | ******************************************************* |
76 | * * | |
77 | * UPGRADING RACKTABLES * | |
78 | * * | |
79 | ******************************************************* | |
d3372430 DO |
80 | RackTables (since 0.14.6) provides an automatic database upgrade feature. |
81 | If you already have a working installation, the following procedure | |
82 | should be sufficient: | |
de8695b2 DO |
83 | |
84 | 0. BACKUP YOUR DATABASE | |
80138748 DO |
85 | 1. Remove all existing files except inc/secret.php, gateways' |
86 | configuration (in the gateways directory) and local mod (inc/local.php). | |
de8695b2 | 87 | 2. Unpack the new tarball into the place. |
d3372430 DO |
88 | 3. Open the RackTables page in your browser. The software detects version |
89 | mismatch and displays a message telling to log in as admin to finish | |
90 | the upgrade. | |
91 | 4. Do that. Normally, everything should be Ok. If there are | |
92 | errors displayed, copy and send them to us for review. | |
7fc5565c | 93 | |
c2d46542 DO |
94 | ******************************************************* |
95 | * * | |
96 | * RELEASE NOTES * | |
97 | * * | |
98 | ******************************************************* | |
99 | ||
1679ddbd DO |
100 | *** Upgrading to 0.18.x *** |
101 | ||
102 | RackTables from its version 0.18.0 and later is not compatible with | |
103 | RHEL/CentOS (at least with versions up to 5.5) Linux distributions | |
104 | in their default installation. There are yet options to work around that: | |
105 | 1. Install RackTables on a server with a different distribution/OS. | |
106 | 2. Request Linux distribution vendor to fix the bug with PCRE. | |
107 | 3. Repair your RHEL/CentOS installation yourself by fixing its PCRE | |
108 | RPM as explained here: http://bugs.centos.org/view.php?id=3252 | |
30d0a2a3 DO |
109 | |
110 | *** Upgrading to 0.17.0 *** | |
111 | ||
d74ae24c DO |
112 | One can always install RackTables 0.17.0 from scratch. However, upgrading |
113 | an existing installation to 0.17.0 implies a certain upgrade path. If the | |
114 | existing database version is less, than 0.16.4, it must first be upgraded | |
115 | to version 0.16.4, 0.16.5 or 0.16.6 (at one's choice) using appropriate | |
116 | tar.gz distribution. The resulting 0.16.4+ database can be upgraded to | |
117 | 0.17.0 (or later version) in a normal way (with tar.gz of the desired 0.17.x | |
118 | release). | |
119 | ||
2c9fde3a DO |
120 | LDAP options have been moved to LDAP_options array. This means, that if you were |
121 | using LDAP authentication for users in version 0.16.x, it will break right after | |
aca5a846 | 122 | upgrade to 0.17.0. To get things working again, adjust existing secret.php file |
2c9fde3a DO |
123 | according to secret-sample.php file provided with 0.17.0 release. |
124 | ||
3e1c9c67 DO |
125 | This release is the first to take advantage of the foreign key support |
126 | provided by the InnoDB storage engine in MySQL. The installer and | |
e1ae3fb4 AD |
127 | upgrader scripts check for InnoDB support and cannot complete without it. |
128 | If you have trouble, the first step is to make sure the 'skip-innodb' | |
129 | option in my.cnf is commented out. | |
130 | ||
131 | Another change is the addition of support for file uploads. Files are stored | |
132 | in the database. There are several settings in php.ini which you may need to modify: | |
133 | file_uploads - needs to be On | |
134 | upload_max_filesize - max size for uploaded files | |
3e1c9c67 DO |
135 | post_max_size - max size of all form data submitted via POST (including files) |
136 | ||
79b8ad1e | 137 | User accounts used to have 'enabled' flag, which allowed individual blocking and |
a476909e DO |
138 | unblocking of each. This flag was dropped in favor of existing mean of access |
139 | setup (RackCode). An unconditional denying rule is automatically added into RackCode | |
140 | for such blocked account, so the effective security policy remains the same. |