Centova Messenger - http://www.centova.com Copyright 2003-2006, Centova Technologies Inc. LICENSE ------- Use of Centova Messenger is subject to the terms of the Centova Messenger License Agreement, a copy of which should have been included in the Centova Messenger distribution archive in the file named "LICENSE.txt". If you did not receive a copy of the Centova Messenger License Agreement, please visit the Centova Messenger web site at http://www.centova.com and contact a Centova Support representative for a copy immediately. Distribution of Centova Messenger is prohibited under the terms of the Centova Messenger License Agreement. INTRODUCTION ------------ Centova Messenger is a completely web-based instant messaging application written in PHP. Centova Messenger is developed and distributed by Centova Technologies Inc. PREREQUISITES ------------- Centova Messenger requires the following: - PHP version 4.x. (Most recent version strongly recommended). - MySQL v3.x or 4.x. (4.x series strongly recommended). - A webserver; compatible webservers include: - Apache v1.3.x (if using Linux) - IIS v6.0 (if using Windows) - Apache 2.0 is untested. Older versions of IIS are untested. - A Jabber server; compatible Jabber servers include: - jabberd 1.4.x - jabberd 2.x - Merak Instant Messaging server (Windows) - any other 100% jabberd-compatible server should work. UPGRADING --------- To upgrade Centova Messenger to a newer version, perform the following steps: 1) Move your current Centova Messenger directory to a safe location. For example: mv /var/www/html/centova ~/centova_backup 2) Backup your current Centova Messenger database. For example: mysqldump -u mysqlusername -p centova > ~/centova_backup.sql 3) Unpack your new Centova Messenger tarball into your old Centova Messenger directory. Under Windows, you can use WinZip to do this. Under Linux: cd /var/www/html tar xzvf centova-x.x.x.tar.gz mv centova-x.x.x centova 4) Copy your old Centova Messenger configuration file into your new Centova Messenger directory. Under Windows, simply browse to your old Centova Messenger directory (which you backed up in step 1) and copy config.php into your new Centova Messenger directory (which you created in step 3). Under Linux: cd /var/www/html cp ~/centova_backup/config.php . 5) Look in the "upgrade" folder for the PHP script that matches the version you're upgrading to, and browse to that location in your web browser. For example, if you're upgrading to version 1.1.1, you might open the following URL: http://www.yoursite.com/centova/upgrade/upgrade_to_1.1.1.php 6) Remove the "upgrade" and "install" directories from the Centova Messenger directory. Centova Messenger should now be upgraded to the latest version. INSTALLATION - LINUX -------------------- To install Centova Messenger under Linux (or other POSIX-compatible operating systems) using the Apache webserver, perform the following steps: 1) Unpack the distribution tarball to a directory under your web root. For example: cd /var/www/html tar xzvf centova-x.x.x.tar.gz mv centova-x.x.x centova 2) Grant write permissions to config.php: cd centova chmod 777 config.php 3) Create a MySQL database and user for Centova Messenger. If you have a web- based MySQL configuration tool such as phpMyAdmin, you can use it to create the database. Otherwise, from a shell prompt, type: mysql -uroot -p Enter your root password at the "Enter password:" prompt and press Enter. At the "mysql>" prompt, enter the following: CREATE DATABASE centovamessenger; GRANT ALL PRIVILEGES ON centovamessenger.* TO centovamessenger@localhost IDENTIFIED BY 'secret'; This will create a MySQL database named 'centovamessenger', and a MySQL user named 'centovamessenger' with the password 'secret'. Substitute "secret" with a password of your choice. Be sure to remember the database name, user name, and password you chose here, as you will need them during Centova Messenger installation. 4) Open a web browser and access the URL for the directory into which you unpacked Centova Messenger. For example, if you unpacked Centova Messenger into the 'centova' directory under the web root for http://www.example.com, you would use the URL: http://www.example.com/centova/ This will start the web-based installer. Follow the instructions to install Centova Messenger. 5) If the installer instructed you to copy some configuration information and paste it into your configuration file, you must now edit your 'config.php' file and paste in the new configuration information. Use an editor such as 'vi' or 'pico' to edit config.php and enter the configuration information. If you were not prompted to copy/paste any information, you may ignore this step. 6) Remove write permissions from config.php: chmod 755 config.php Centova Messenger should now be installed! INSTALLATION - WINDOWS ---------------------- To install Centova Messenger under Windows using the IIS webserver, perform the following steps. Note that you MUST have PHP installed and fully functional on your IIS server before installing Centova Messenger. 1) Use an archiver application (such as WinRAR or WinZip) to unpack the Centova Messenger archive into a folder inside your web site's home directory. 2) Edit your php.ini file (usually in C:\WINDOWS or C:\WINNT) and add: zend_extension_ts = C:\\ioncube\ioncube_loader_win_.dll Where is the path to Centova, and is your PHP version (excluding the minor version number). For example, if you were using PHP v4.3.x, and Centova was installed in C:\Inetpub\Centova you would use: zend_extension_ts = C:\Inetpub\Centova\ioncube\ioncube_loader_win_4.3.dll If there are other zend_extension entries in the php.ini file, place this new entry before the existing entries. 3) Restart IIS or Apache. 4) Make sure the IIS anonymous user account has access to read the Centova Messenger folder. To perform a fully automated installation, you may also want to grant write privileges to the file 'config.php'. (If you do not, you will need to edit this file yourself after installation). 5) Create a MySQL database and user for Centova Messenger. If you have a web- based MySQL configuration tool such as phpMyAdmin, or a GUI-based MySQL configuration such as the MySQL Administrator, you can use it to create the database. Otherwise, from a command prompt, go to your MySQL "bin" directory and type: mysql -uroot -p Enter your root password at the "Enter password:" prompt and press Enter. At the "mysql>" prompt, enter the following: CREATE DATABASE centovamessenger; GRANT ALL PRIVILEGES ON centovamessenger.* TO centovamessenger@localhost IDENTIFIED BY 'secret'; This will create a MySQL database named 'centovamessenger', and a MySQL user named 'centovamessenger' with the password 'secret'. Substitute "secret" with a password of your choice. Be sure to remember the database name, user name, and password you chose here, as you will need them during Centova Messenger installation. 6) Open a web browser and access the URL for the folder into which you unpacked Centova. For example, if you unpacked Centova Messenger into a folder named 'centova' under the home directory for http://www.example.com, you would use the URL: http://www.example.com/centova/ This will start the web-based installer. Follow the instructions to install Centova Messenger. 7) If the installer instructed you to copy some configuration information and paste it into your configuration file, you must now edit your 'config.php' file and paste in the new configuration information. Open the file "config.php" (in the "centova" folder) using Notepad. Delete any existing information from this file, and paste in the new configuration information given to you by the installer. If you were not prompted to copy/paste any information, you may ignore this step. 8) If you enabled write privileges for the file 'config.php' (in step 2), you must now remove those write privileges before Centova Messenger will operate. Centova Messenger should now be installed!