Article: Installation > Wizard Insalation

[kishman155]

The Wizard

For the wizzard installation you need a textfile and a little help.

Download the sourcefile from  http://www.cmsmadesimple.org/downloads.shtml

OR

check out the latest version from subversion - svn co http://svn.cmsmadesimple.org/cms/trunk

Step 1

    * Linux -- Untar the source package to document root dir on your webserver - cd DOCUMENT_ROOT - tar xvfz cms-VERSION.tar.gz
    * Windows -- Unzip  cms-VERSION.zip into your document root dir on your webserver

Step 2
Create an empty config.php file and make it writable by your webserver's user:

    * - touch config.php
    * - chmod 666 config.php

Step 3

Create the cms database if you don't have already one and grant a user rights to use it:

    * Linux- login to mysql: mysql -u root -p create database cms; grant all privileges on cms.* to cms_user@localhost identified by 'cms_pass'; quit
    * Windows - login into your databasems and create a database cms; gave all privileges on the database cms to a cms_user@localhost identified by 'cms_pass', save and quiet

Step 4

    * Linux - Fix the permissions on the cache and template compilation directories so the web server has access to them
          o chmod 777 tmp/templates_c
          o chmod 777 tmp/cache
          o chmod 777 uploads
          o chmod 777 uploads/images

    *  Windows - Set the permission on the cache and template compilation directorie so the webserver has  access to them
          o tmp/templates_c
          o tmp/cache
          o uploads
          o uploads/images

Step 5

Open up your new CMS site in your webbrowser and you will be guided through a short install.

If Installationwizard don't start go to  http://yourdomain.tld/install/install.php

Step one of the installation wizard check if folder exists and if they have the correct permission

If not he will show failure:

install1.jpg

If everything is correct the installer whould say that everything was succesful

install1succesj.jpg

After this you must insert your Username and Password and some other stuff

install2.jpg

After you press continue you come to the Database setting

databaseconnectionsetup.jpg

After you type your setting into this and press continue the Wizard will try to Connect to the database and create the tables.

installdokumentroot.jpg

After Install the tables in the database , the wizard ask for your Dokumentroot, Dokumentpath, Querystring

Most of the time its recommendable to leave the things as they are.

endinstall.jpg

Hit CMS site and you will be redirected to your new CMS -site.

Step 6

After install, for security sake, you should set your config.php back to a read-only state. - chmod 444 config.php

and remove the folder install


Step 7

Login to your Adminsite at http://yourdomain.tld/admin/ with your username and password.

your CMS is now up and running if you have problem come visit us at forum.cmsmadesimple.org or

Read more here at the Documentationpage

[westis]

Note: All this red and green (and blue) is only because I didn't understand much of this myself. As I'm not a programmer I'm not very familiar with many of these expressions, so I tried adding some stuff to make it more understandable to people like me. Please suggest any corrections or modifications!
Formatting used: Red strikethrough is suggesting that part to be deleted. Green is suggesting that part to be added. Blue is my comments.

The Wizard Wizard Installation

For the wizzard installation you need a textfile and a little help. Comment: I'm not really sure what's meant by " a textfile and a little help"?

Requirements:

• PHP 4+
• MySQL
• Apache webserver (or another php enabled webserver)
• BBCodeParser (optional)

Comment: Or the above could go to a separate "Requirements" section to begin the installation section.

Download the sourcefile from http://www.cmsmadesimple.org/downloads.shtml (with for example ZipGenius you can unpack both tar and zip, otherwise the general rule us tar if you use Linux, zip for Windows users)

OR

check out the latest version from subversion - svn co http://svn.cmsmadesimple.org/cms/trunk

Step 1

• Linux
  Untar the source package file you just downloaded and upload to document root dir on your webserver (your root directory or create a folder for CMSMS)
  • cd DOCUMENT_ROOT
  • tar xvfz cms-VERSION.tar.gz
       
     
• Windows
  Unzip cms-VERSION.zip (the file you just downloaded) and upload to intodocument root dir on your webserver (your root directory or create a folder for CMSMS)

Step 2
If your webserver has write access to your new CMS directory you can skip step 2.

Create an empty config.php file in the CMSMS directory (you can right-click on your desktop, create a new document, name it config.php and then upload it to the CMSMS directory of your webserver)

andThen make itthe config.php file writable by your webserver's user (you may not need to do this):

• touch config.php
• chmod 666 config.php (you can find a chmod tutorial at http://www.zachjorgensen.net/za/chmodtutor.html if you need to)

Step 3
Create the cms database if you don't have already one and grant a user rights to use it:

• Linux
  • login to mysql: mysql -u root -p create database cms;
  • grant all privileges on cms.* to cms_user@localhost identified by 'cms_pass';
  • quit
• Windows
  • Open your MySQL command line and type:
  • login into your databasems and create a databasecreate database cms;
  • gave all privileges on the database cms to a cms_user@localhost identified by 'cms_pass', save and quiet
    grant all privileges on cms.* to cms_user@localhost identified by 'cms_pass';
  • quit

Step 4
    * Linux - Fix the permissions on the cache and template compilation directories so the web server has access to them
          o chmod 777 tmp/templates_c
          o chmod 777 tmp/cache
          o chmod 777 uploads
          o chmod 777 uploads/images

    *  Windows - Set the permission on the cache and template compilation directorie so the webserver has  access to them
          o tmp/templates_c
          o tmp/cache
          o uploads
          o uploads/images

Step 5
Open up your new CMS site in your webbrowser and you will be guided through a short install.

If the Installationwizard don'tdoesn't start go to  http://yourdomain.tld/install/install.php

Step one of the installationwizard checks if folders exists and if they have the correct permission

If not heit will show failure:

install1.jpg

If everything is correct the installer whould will say that everything was succesful

install1succesj.jpg

After this you must insert your select a Username and Password for the admin and some other stuff type your e-mail address.

install2.jpg

After you press continue you come to the Database settings

databaseconnectionsetup.jpg

After you type your settings into this and press continue the Wizard will try to Connect to the database and create the tables.

installdokumentroot.jpg

After installing the tables in the database, the wizard asks for your Document root, document path and querystring

Most of the time its recommendable recommended to leave the things settings as they are.

endinstall.jpg

Hit CMS site and you will be redirected to your new CMS -site.

Step 6
After install, for security sake, you should set your config.php back to a read-only state.
  - chmod 444 config.php

and remove the folder install


Step 7
Login to your Adminsite at http://yourdomain.tld/admin/ with your username and password.

Your CMS is now up and running. If you have problems come visit us at forum.cmsmadesimple.org or

Read more here at the Documentation page

Step 8 (optional)
Some setup parameters are set to a default value and are not editable through the webinterface.
    Although CMS works out-of-the-box, you might still want to edit these parameters
   
  - open config.php with you favorite editor (this file has been created by the installer)

    Some of the parameters you can find here are:
   
The image manipulation library used by the Image manager, either 'GD' or 'NetPBM' or 'IM' for ImageMagick.
        - $config["image_manipulation_prog"] = "GD";   
 
        If the library is NetPBM or IM, you need to specify where the binary for the selected library are.
        -  $config["image_transform_lib_path"] = "/usr/bin/ImageMagick/";

The location (filepath and URL) to which files are uploaded using the filemanager
- $config["uploads_path"] = "/site/web/cms/uploads";
- $config["uploads_url"] = "http://www.cmsmadesimple.org/cms/uploads";

The location (filepath and URL) to which files are uploaded using the imagemanager. This can be the same path as the image manager URL
- $config["image_uploads_path"] = "/site/web/cms/uploads/images";
- $config["image_uploads_url"] = "http://www.cmsmadesimple.org/cms/uploads/images";

    CMS features a realtime HTML validation plugin for the WYSIWYG editor, which will insure valid HTML content
        This is turned off by default, since it will also disable the use of tables and markup tags.
        - $config["use_Indite"] = false;

Troubleshooting:
- If your install fails due to a database problem or something, and you try to resume the installation but get the dreaded "Site Down for Maintenance" message,
you'll need to delete your config.php and start the install over again.

- If you have database connection problems using the "MySQL 4.1+" install option, you might try installing as "MySQL 3.0-4.0". This will often work where the 4.1+ option fails.

[Hans]

Well. I use ftp only to install any script. Therefor it maybe useful to add sections that are suitable for people like me (i think there are many).
E.G.

Step 1

LinuxUntar the source package file you just downloaded and upload to document root dir on your webserver (your root directory or create a folder for CMSMS)

cd DOCUMENT_ROOT
tar xvfz cms-VERSION.tar.gz
WindowsUnzip cms-VERSION.zip (the file you just downloaded) and upload to into document root dir on your webserver (your root directory or create a folder for CMSMS)

Could be extended with:
Unpack the file and upload it with ftp to the dir on your server where you want cmsms to be installed.

Other example:

Step 3
Create the cms database if you don't have already one and grant a user rights to use it:

Linux
login to mysql: mysql -u root -p create database cms;
grant all privileges on cms.* to cms_user@localhost identified by 'cms_pass';
quit

Alternative: In your control panel create a new database and remember the name, the username and the password as you have to enter these on installation (or something like that)

In other words: maybe it is an good thing to make different descriptions of the install-procedure, depending on people having shell access or not.

[westis]

Yep, I agree on that, Hans. I also use FTP as I don't have my own server, but use an ISP. Maybe there could be two sections, one for people with shell access and one for people using FTP to upload files to the ISP server?

[Ted]

I agree on there being 2, since they are vastly different.  Having NOTE: all over the place wouldn't be as good as just splitting it up.  Of course, that means it needs to be edited in 2 different places when it changes, but it's probably worth it.

[westis]

Yep, let's do it that way. But what do we call those two sections, so that a newbie understands where to read?

Also, should we separate Linux and Windows installations? Or that's basically the same thing as what we're discuussing? As I'm not very familiar with shell terminology and I've not used Linux either, I would appreciate if someone could help filling in those sections.