r2169 - add some comments for future reference
[racktables] / README
diff --git a/README b/README
index 8d1f0e73468839b7bd8c75c9c7036cb83278a020..ca809d402674933632c0a4bd787237f63592b5dd 100644 (file)
--- a/README
+++ b/README
@@ -16,19 +16,30 @@ Authors: <info/=@=/racktables.org>
 
 I. Dependencies.
 
-For database you must have a MySQL server installation version 4.x or 5.x:
-Fedora Core 6: yum install mysql-server mysql
-Fedora 8: yum install mysql-server mysql
-ALTLinux Compact 3.0: apt-get install MySQL-server MySQL-client
-ALTLinux Desktop 4.0: apt-get install MySQL-server 
+For database you must have a MySQL server installation
+version 4.x or 5.x. 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
+
+* ALTLinux Desktop 4.0: apt-get install MySQL-server 
+put "CHSET=utf8" into /etc/sysconfig/mysqld
+
+*openSUSE 11.0: YaST -> Software -> software management -> Web and LAMP server -> mysql
+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 Core 6: # yum install httpd php php-mysql php-pdo php-gd
-Fedora 8: 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 \
+
+* Fedora 8/9: 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
 
+* openSUSE 11.0: use YaST to apache2-mod_php5, php5-gd, php5-mbstring, php5-mysql,
+php2-snmp and php5-ldap
+
 II. Prepare the server.
 1. Unpack the tarball and make it web-accessible, e.g. http://yourcompany.com/racktables
 or http://racktables.mysite.org.
@@ -104,3 +115,23 @@ standard package repository (and restarting Apache after that):
 
 Fedora: yum install php-mbstring
 ALTLinux: apt-get install php5-mbstring
+
+*** Upgrading to 0.16.1 ***
+This release fixes a missing UNIQUE key in the database. However, this fix
+may sometimes fail, if the table contains duplicate records. If the
+0.16.0-0.16.1 upgrade batch completed without errors, no action needs to be
+taken. If you see a failed ADD UNIQUE query during upgrade, the only solution
+is to delete the duplicates manually. To do this, open a MySQL console and
+issue the failed query again:
+
+mysql> alter table IPVirtualService ADD UNIQUE endpoint (vip, vport, proto);
+
+The IP address of the duplicate VS will be known from the "Duplicate entry"
+message. For example, to decode "Duplicate entry '180879877-80-TCP' for key
+2" error message, issue:
+
+mysql> select inet_ntoa(180879877);
+
+Then go to "virtual services" web-interface page and adjust the data as
+necessary. You would need to get rid of the duplicates accurately one by
+one, repeating the ADD UNIQUE query until it succeeds.