[Comoblog-commit] comoblog/docs INSTALL,1.5,1.6 UPGRADE,1.5,1.6
Status: Inactive
Brought to you by:
markwallis
|
From: Mark W. \(a. serialmonkey\) <mar...@us...> - 2005-11-12 14:21:19
|
Update of /cvsroot/comoblog/comoblog/docs In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv21001/docs Modified Files: INSTALL UPGRADE Log Message: 1335903 - Updated documentation for upgrade and user-friendlyness Index: UPGRADE =================================================================== RCS file: /cvsroot/comoblog/comoblog/docs/UPGRADE,v retrieving revision 1.5 retrieving revision 1.6 diff -u -d -r1.5 -r1.6 --- UPGRADE 9 Oct 2005 14:11:35 -0000 1.5 +++ UPGRADE 12 Nov 2005 14:21:04 -0000 1.6 @@ -12,10 +12,16 @@ 1. Make a backup of your database and easymoblog install folder 2. Rename the folder you currently have EasyMoblog installed into - to something else (e.g. easymoblog_old) + to something else + e.g. if you have Easymoblog installed into a folder like + /var/www/html/blog then you will want to rename it + to something like /var/www/html/blog-old 3. Follow the instructions in INSTALL to install CoMoblog on your - server. Skip Step 3 where you create a new database. -4. When you goto the Install website enter in the Database details. + server. Skip Step 3 where you create a new database. You can find + the INSTALL file in the docs folder of the CoMoblog install + tarball. +4. When you goto the Install website enter in the database details + of your existing Easymoblog instance. Make sure when entering your database details that you get the table prefix correct (most likely easymoblog_) The script will then detect an existing install and switch to Index: INSTALL =================================================================== RCS file: /cvsroot/comoblog/comoblog/docs/INSTALL,v retrieving revision 1.5 retrieving revision 1.6 diff -u -d -r1.5 -r1.6 --- INSTALL 9 Oct 2005 08:42:10 -0000 1.5 +++ INSTALL 12 Nov 2005 14:21:04 -0000 1.6 @@ -2,26 +2,46 @@ | REQUIREMENTS | +--------------------------------------------------------------------+ -1. REQUIRED SOFTWARE +1. OPERATING SYSTEM REQUIREMENTS - CoMoblog requires a web server, PHP4 (http://www.php.net/) and - MySQL (http://www.mysql.com/) + CoMoblog should install on any Operating System that is supported + by the required 3rd party software listed below. The following + environments are tested by our development team - Your php must be compiled with mySQL functions and socket functions - enabled. + * Linux (specifically, Fedora Core 4 and Gentoo) + * Windows XP + * Windows 2003 Server + +2. REQUIRED SOFTWARE + + CoMoblog requires a web server such as Apache (http://httpd.apache.org), + PHP4 (http://www.php.net/) and MySQL (http://www.mysql.com/) + + Your php must be compiled with the MySQL module enabled. To confirm + this, run 'php -m' from a shell prompt and ensure 'mysql' is listed + in the PHP modules list. If it isn't you may need to recompile + your PHP software - please contact your hosting company or see + the PHP website for more detail. + + If you don't have shell access to your server then ask your System + Administrator to confirm that the mysql module is installed into PHP. + + If you wish CoMoblog to automatically resize any images that you post + then the GD functions must also be compiled into your php. To confirm + this, run 'php -m' from a shell prompt and ensure 'gd' is listed in the + PHP modules list. if GD is missing then CoMoblog will still function, but + all your images will be posted in their original size and you will need + to manually resize them yourself before posting to the blog. - NOTE: CoMoblog 0.3 was only tested with the following - configuration: + NOTE: CoMoblog is only tested with the following 3rd party + software versions: - Apache >= 1.3.24 - PHP >= 4.2 - MySQL >= 3.23 - NOTE: CoMoblog requirets the GD library to be compiled into your - PHP installation if you wish it to resiZe attached images - -2. POP3 MAILBOX +3. POP3 MAILBOX - You also need to have accesso to a pop3 mailbox. + You also need to have access to a pop3 mailbox. You are recommended to use a dedicated mailbox for your CoMoblog site: every message sent to this mailbox will be published on your CoMoblog site, and deleted from your mailbox! @@ -40,38 +60,59 @@ 1. DOWNLOAD COMOBLOG You can obtain the latest CoMoblog release from: - http://comoblog.serialmonkey.com/ + http://comoblog.serialmonkey.com/wiki/index.php/Download. + + The same file can be used for both a new install and upgrade to an + existing CoMoblog/EasyMoblog installation. If you are upgrading + please read the UPGRADE document before proceeding. - Download the current tar.gz archive and extract the files: + If you have shell access to your server then you can transfer the + tar.gz file to your home directory and extract using the command + below. If you don't access shell access then extract the tar.gz + file on your local computer and FTP the comoblog-x.x/ folder to + your home directory. $ tar -zxvf comoblog-x.x.tar.gz - This will create a new directory comoblog-x.x/ containing all + You will end up with a new directory comoblog-x.x/ containing all files and directories. Move the contents of that directory into a directory within your web server's document root or your public HTML directory; i.e.: - $ mv comoblog-x.x /var/www/html - - NOTE: when copying files, ensure you also copy the hidden .htaccess - files. + $ mv comoblog-x.x /var/www.mywebsite.com/html 2. FILE PERMISSIONS - You just have to make some folders world writable, in order to + You will need to make some folders world writable, in order to allow CoMoblog to store your posts images and your configurations + + If you have shell access to your server you can run the commands + below, replaciing the /path/to/ with the location you just moved + the CoMoblog files into above. $ chmod -R 777 /path/to/comoblog/img/tmp $ chmod -R 777 /path/to/comoblog/img/comoblog $ chmod -R 777 /path/to/comoblog/img/posts $ chmod -R 777 /path/to/comoblog/img/topics $ chmod -R 777 /path/to/comoblog/include + + If you don't have shell access then your FTP client should allow + you to change the permissions on those directories above. You want + to change their permission to '777' - which means full privledges + for all users. 3. CREATE THE DATABASE - You must create a new database for your CoMoblog site: + You must create a new database for your CoMoblog site. If you + don't administer the local MySql instance that you wish to use + then you will need to request your System Administrator to create + you a new database. They will provide you the database name, + username and password and you can skip the rest of this section. + + If you do administer your own Mysql instance then create a new + database using the command: $ mysqladmin -u user -p create comoblog @@ -106,16 +147,18 @@ 4. INSTALLATION WIZARD - Just open your browser ang enter the following URL: + Just open your browser and enter the following URL: http://<url_of_your_comoblog_site>/ - Follow instructions :) + Follow the instructions provided. 5. CRON JOB In order to work properly, you have to schedule the script - comoblog-x.x/batch/comoblog_batch.php + comoblog-x.x/batch/comoblog_batch.php to run on a regular basis. + This script will check the POP3 mailbox you have configured for + any new messages and post them to your blog. You simply have to add a line to your crontab file. For example, if you want to schedule the batch every 10 minutes: @@ -123,7 +166,11 @@ */10 * * * * /path/to/php -q /path/to/comoblog_batch.php If you have problems with your cron configuration, ask your system - administrator! + administrator. + + If you don't have access to your systems Crontab scheduler then + you will need to enable the mod_batch module through the Admin + interface instead. @@ -181,20 +228,6 @@ -+--------------------------------------------------------------------+ -| FUTURE RELEASES | -+--------------------------------------------------------------------+ - - Subscribe to CoMoblog newsletter if you want to be informed when - future releases will be available. - - Just go to http://comoblog.serialmonkey.com/ and fill in the form - with your e-mail address. - - - - - ______________________________________________________________________ END OF INSTALL FILE |