README --------------------------------------- Contents: --------- 1. Requirements 2. Installation 3. Patches 4. Backups 5. License 6. Appendix --------------------------------------- 1. Requirements --------------------------------------- The BXCP needs round about 5mb of webspace (nearly 500 kb are used after install). Also PHP 4.1.0 (http://www.php.net) or newer and MySQL 3.23.32 (http://www.mysql.com) or newer must be installed. With older software versions the BXCP can produce unexpected errors or just won't start to run, but your provider should have installed the almost current versions to fix security issues and so. You will need FileZilla (http://filezilla.sourceforge.net) or another ftp programm to upload the content. --------------------------------------- 2. Installation --------------------------------------- You can use the online installation inside the 'INSTALL' directory or do the following steps by yourself: Database -------- The next steps are based on phpMyAdmin 2.5.4 and maybe changed a bit at actual versions of the tool. At the moment it is not possible to run more then one BXCP a database, because table names are static and can't be edited. This is going to change in a later version. Now open your browser and point it to the phpMyAdmin installation on the webspace. Click the database at the left panel and then click 'SQL' on the top left. There should be a button to upload local files, click it and select the 'bxcp.sql' which can be found inside the 'INSTALL' directory. Next click the 'OK'. Your database should now have 26 new tables, else delete old ones with the same name and install again. Their is already an existing user inside the BXCP database tables. It's nick is 'admin' and the password '2345'. This user is at the moment the only one that can change internal functions. You should change the nick and password for security issues. Setup ----- Extract the BXCP on your local hard disk if not already done. Upload and open the 'createcfg.php' with your browser. You must create the needed 'config.php' with this script. The basic template can be found and edited inside the 'gfx' directory. If you don't like it, just change it! Cascading Stylesheets can be added to the 'gfx.css' without problems and any images of your template should be added their with an own class. Please don't link images directly inside your 'index.htm', because it can happen that they won't appear (expected in wrong directory etc.). Upload ------ Now move the whole BXCP directory with its normal structure onto your webspace and set the 'CHMOD' of all files and directorys to '755'. You can't see the webpage if the 'CHMOD' is too low, or maybe encounter problems with the internal BXCP functions that move files up and down. Please don't upload the 'DOCS' directory or files like 'bxcp.sql' now. If they are already online delete them fast, because they contain data that helps hackers to get control of your BXCP installation! --------------------------------------- 3. Patches --------------------------------------- This directory contains a 'patches.txt' with instructions to update old installations of the BXCP. These instructions must be exactly followed to keep the BXCP running without problems. --------------------------------------- 4. Backups --------------------------------------- You shoud, wether your webspace provider does it or not, backup the BXCP every 1-2 weeks. This means all files, directorys and database tables that belong to the BXCP should be safed on a local hard drive. Think of a server crash, what about your data? You'll be angry about it if all data or just some parts of it are erased. Tools like phpMyAdmin (http://phpmyadmin.sourceforge.net) can backup your database. --------------------------------------- 5. License --------------------------------------- This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. The GNU General Public License can be found inside the 'DOCS' directory. --------------------------------------- 6. Appendix --------------------------------------- Since October 2002 the BXCP is sequentially developed by bx aka. Hans-Joachim Piepereit. At this place i want to thank all the 10 beta testing clans for their help and say that i'll support you again in future. Enjoy the BXCP and please send wishes or errors to the project :-) BXCP (C) 2002-2004 Hans-Joachim Piepereit