| 1 | HOTARU CMS
|
|---|
| 2 | ==========
|
|---|
| 3 | Version: 1.4.2
|
|---|
| 4 | Released: Nov. 20th, 2010
|
|---|
| 5 |
|
|---|
| 6 | Installation
|
|---|
| 7 | ------------
|
|---|
| 8 |
|
|---|
| 9 | Please visit http://docs.hotarucms.org/Getting_Started#Installing_and_Upgrading for
|
|---|
| 10 | the most up-to-date version of these instructions.
|
|---|
| 11 |
|
|---|
| 12 | Instructions last updated: Mar 8th 2010
|
|---|
| 13 |
|
|---|
| 14 | Requirements
|
|---|
| 15 | ------------
|
|---|
| 16 |
|
|---|
| 17 | Hotaru CMS has been tested using PHP 5.2.5 ~ 5.3.2 and MySQL 5.0~.
|
|---|
| 18 |
|
|---|
| 19 | Upgrading
|
|---|
| 20 | ---------
|
|---|
| 21 |
|
|---|
| 22 | 1. Backup your database.
|
|---|
| 23 | 2. Download the latest version of Hotaru CMS.
|
|---|
| 24 | 3. Turn off all your plugins.
|
|---|
| 25 | 4. Overwrite ALL the old files. If you've made any customizations, read this
|
|---|
| 26 | first: http://docs.hotarucms.org/File_Organization
|
|---|
| 27 | 5. Go to /install/upgrade.php and follow the steps
|
|---|
| 28 | 6. Turn your plugins back on
|
|---|
| 29 | 7. Reactivate your widgets
|
|---|
| 30 | 8. When finished, delete the install folder.
|
|---|
| 31 |
|
|---|
| 32 | First-time Installation
|
|---|
| 33 | -----------------------
|
|---|
| 34 |
|
|---|
| 35 | 1. Download the latest version of Hotaru CMS.
|
|---|
| 36 | 2. Create a database called `hotaru` in phpMyAdmin (or equivalent).
|
|---|
| 37 | 3. Rename `/hotaru_settings_default.php` to `/hotaru_settings.php`.
|
|---|
| 38 | 4. Open `/hotaru_settings.php` and edit the top section with your database
|
|---|
| 39 | details and path to Hotaru, e.g. http://example.com/
|
|---|
| 40 | 5. Upload the contents of the `hotaru` folder to your server.
|
|---|
| 41 | 6. Files should have permissions set to 644 and folders should be set to 755,
|
|---|
| 42 | except...
|
|---|
| 43 | 7. Set `/cache` and its sub-folders to 777
|
|---|
| 44 | 8. Go to `/install/install.php` and follow the steps
|
|---|
| 45 | 9. When finished, delete the install folder.
|
|---|
| 46 |
|
|---|
| 47 | Setting up your site
|
|---|
| 48 | --------------------
|
|---|
| 49 |
|
|---|
| 50 | 1. Log into Admin and go to **Admin -> Settings**
|
|---|
| 51 | 2. Change the settings as appropriate, but leave `DB_CACHE` off for now.
|
|---|
| 52 | 3. Download plugins from the Plugin Downloads forum, unzip and upload them to
|
|---|
| 53 | the `/content/plugins/` directory.
|
|---|
| 54 | 4. Go to **Admin -> Plugin Management** and install the plugins one by one.
|
|---|
| 55 | 5. Edit settings for each plugin listed in the sidebar under Plugin Settings.
|
|---|
| 56 | 6. Click the site title/banner to view your changes.
|
|---|
| 57 | 7. When finished, return to **Admin -> Settings** and set `DB_CACHE` to true.
|
|---|
| 58 |
|
|---|
| 59 |
|
|---|
| 60 | Friendly URLS
|
|---|
| 61 | -------------
|
|---|
| 62 |
|
|---|
| 63 | If you want to use friendly urls, rename `htaccess_default` to `.htaccess`, and
|
|---|
| 64 | edit it according to the instructions within the htaccess file. Then go
|
|---|
| 65 | to **Admin -> Settings** and change the **Friendly URLs** setting to true.
|
|---|
| 66 |
|
|---|
| 67 | Troubleshooting
|
|---|
| 68 | ---------------
|
|---|
| 69 |
|
|---|
| 70 | If you're having trouble installing Hotaru, please post your questions with as
|
|---|
| 71 | much detail as possible in the forums at http://hotarucms.org. Thanks. |
|---|
