r4073 minor change in UI for recent change: VST form commit on ENTER and hints on...
[racktables] / README
diff --git a/README b/README
index f2530ae..128c122 100644 (file)
--- a/README
+++ b/README
@@ -21,8 +21,9 @@ For database you must have a MySQL server installation
 version 4.x or 5.x. InnoDB support must be enabled.
 It is a good idea to make it use UTF-8 by default.
 
-* Fedora 8/9: yum install mysql-server mysql
-put "default-character-set=utf8" into /etc/my.cnf
+* Fedora 13: yum install mysql-server mysql
+Make sure to have "character-set-server=utf8" line in "[mysqld]" section
+of /etc/my.cnf file!
 
 * ALTLinux Desktop 4.0: apt-get install MySQL-server 
 put "CHSET=utf8" into /etc/sysconfig/mysqld
@@ -33,7 +34,7 @@ put "default-character-set=utf8" into /etc/my.cnf
 For web-frontend you must have Apache and PHP 5 with PDO and multibyte
 extensions:
 
-* Fedora 8/9: yum install httpd php php-mysql php-pdo php-gd php-snmp php-mbstring
+* Fedora 13: yum install httpd php php-mysql php-pdo php-gd php-snmp php-mbstring
 
 * ALTLinux Server 4.0: apt-get install apache2-httpd-prefork php5-gd2 \
 php5-pdo_mysql php5-pdo apache2-mod_php5 php5-mbstring
@@ -49,6 +50,9 @@ php5-snmp and php5-ldap
 [X] MULTIBYTE  Enable zend multibyte support
 # make -C /usr/ports/graphics/php5-gd install
 # make -C /usr/ports/databases/php5-pdo_mysql install
+# make -C /usr/ports/devel/pcre install
+!!! Enable UTF-8 support ............ : yes
+!!! Unicode properties .............. : yes
 # make -C /usr/ports/devel/php5-pcre install
 # make -C /usr/ports/converters/php5-mbstring install
 [X] REGEX  Enable multibyte regex support
@@ -94,35 +98,25 @@ should be sufficient:
 *                                                     *
 *******************************************************
 
-*** Upgrading to 0.14.12 ***
-
-The upgrade may show a failed query "alter database character set utf8", in
-this case the user should issue the query manually from the mysql command
-line.
-
-*** Upgrading to 0.16.0 ***
-
-This release features a completely new authorization system, RackCode,
-which brings the tags feature (introduced in 0.15.0) to its full potential.
-The old-style user permissions are converted during upgrade automatically,
-but the result may appear not what you would expect. Review the RackCode
-after upgrade (Main page -> Configuration -> Permissions) and adjust,
-if necessary.
+*** Upgrading to 0.19.x ***
 
-Another important change is a new dependency on "multibyte string" PHP
-extension. Normally one should get it working before starting the upgrade,
-this is typically achieved by installing a particular PHP RPM from the
-standard package repository (and restarting Apache after that):
+This release utilizes database triggers, which are only available in
+MySQL >= 5.0.2.
 
-Fedora: yum install php-mbstring
-ALTLinux: apt-get install php5-mbstring
+RackTables is now using PHP JSON extension which is included in the PHP core since 5.2.0.
+Installation process does not check for this extension because the lack of it does not affect
+base functionality. If some of ajax features are not working correctly, check if JSON extension
+is availible in your installation of PHP.
 
-*** Upgrading to 0.16.3 ***
+*** Upgrading to 0.18.x ***
 
-This release fixes a missing UNIQUE KEY in a table. The upgrade script may
-find it necessary first to transform some records. Because of this it is
-normal to see several "update TagStorage ... Duplicate entry" failed queries
-during the upgrade.
+RackTables from its version 0.18.0 and later is not compatible with
+RHEL/CentOS (at least with versions up to 5.5) Linux distributions
+in their default installation. There are yet options to work around that:
+1. Install RackTables on a server with a different distribution/OS.
+2. Request Linux distribution vendor to fix the bug with PCRE.
+3. Repair your RHEL/CentOS installation yourself by fixing its PCRE
+RPM as explained here: http://bugs.centos.org/view.php?id=3252
 
 *** Upgrading to 0.17.0 ***