How to install TomatoCMS

Posted by admin at 09:44:36 25-12-2009
4180

There isn't install wizard for TomatoCMS at this time. Don't worry, the installation does not take so much time. Just do the following steps:

Update:

- 2010/01/18: From 2.0.1 version, you can use Install Wizard to install TomatoCMS

1. Download the latest version from http://www.tomatocms.com

 

2. Unzip the downloaded file and upload to your server

The structure of folders are similar as follow:

 

 

3. All application settings are stored in file app/config/config.ini

 

* Database connection settings

TomatoCMS support both single and multiple database servers which work in replication environment.

The master server is the server only for writing data and the slave one is only for reading data.

In most common case, your website is hosted on share hosting, the master and the slave is the same.

Don't care about master.server1 or slave.server2, they are used to define the configuration section for master and slave connection.

 

Change the value of setting to suit your servers:

  • master.server1.host IP or name of your server. Leave it as "localhost" if your database server and the web sever is the same
  • master.server1.charset Character set of data
  • master.server1.port The port will be used to connect to the database
  • master.server1.dbname Name of database
  • master.server1.username User name used to access database
  • master.server1.password Password used to access database

 

For most general users which deploy TomatoCMS on local or share hosting, you don't have to change the value for master.server1.host, master.server1.charset and master.server1.port settings. Leave it as default.

Do the similar modifications for slave.server2.

 

* Web information settings

  • site_name Name of your site
  • url URL of your site (http://www.yourdomain.com)
  • template Template of your site, leave it as default at this step
  • skin Skin (theme) for the site, leave it as default at this step
  • server.static It is advanced options which will be used if you want to move all static resources (javascript, css, images files) to other server. If it is the first time you install TomatoCMS, just change the its value to value of url setting above
  • lang Language of your site in the format of xx_YY, where xx is language ISO code and YY is the country ISO code.
  • default_module The default module will be loaded when access your site. Leave it as default

 

* Date time settings

  • timezone The time zone of your server. You can see the full list of supported timezone here
  • format.date_time Format of your date time
  • format.date Format of date

For date time value, you can use all formats supported by PHP date() function which described here.

 

* Cache settings

TomatoCMS support all cache models supported by Zend Framework and your server, off course.

Most general cache models are File and Memcache:

  • frontend.name Name of cache type used for frontend, leave it as default
  • frontend.options.lifetime Lifetime of cache in seconds

 

- If you want to cache to file system, use the following options:

  • backend.name = "File"
  • backend.options.cache_dir = "{TOMATO_TEMP_DIR}{DS}cache"

You can change "{TOMATO_TEMP_DIR}{DS}cache" to path of folder will be used to store the cached data (Remember set the write permission to this folder).

 

- If your backend cache is Memcached, use the following options:

  • backend.options.servers.server1.host = "127.0.0.1"
    ;backend.options.servers.server1.port = "11211"backend.name = "Memcached"
  • backend.options.servers.server1.host IP of name of memcache server
  • backend.options.servers.server1.port Port of server used to transfer data. Default value is 11211

You have many memcached servers? Very simple, just add more options:

  • backend.options.servers.server2.host, backend.options.servers.server2.port
  • backend.options.servers.server3.host, backend.options.servers.server3.host, ... or so on

 

4. Create database and import sample data from file tomato_cms_db.sql which was located at install folder.

 

5. Set write permisson to the following files/folders:

  • app/config/layout.ini
  • app/templates
  • data
  • temp
  • upload

 

6. Go to URL of your website and see the result:

 

 

7. Do you want to go to administration section?

Go to http://yourdomain/admin and use the default administrator account:

- Username: admin

- Password: admin

(Remember change your password after logging in)

If you see the dashboard of administration section, congratulation!

 

 

IF YOU CAN NOT INSTALL OR THERE ARE ERRORS AFTER PERFORMING ABOVE STEPS, please use the comment form below to send the error messages you received on website, or send an email to core@tomatocms.com

Thanks you very much.

TomatoCMS Team

Comments

Collapse
  • Nguyễn Đình Trọng

    Not run on localhost

    Messenge with run on localhost
"Fatal error: Uncaught exception 'Zend_Db_Adapter_Exception' with message 'The PDO extension is required for this adapter but the extension is not loaded' in Cwww\webroot\cms\lib\Zend\Db\Adapter\Pdo\Abstract.php42 

Stack trace: 
#0 Cwww\webroot\cms\app\core\db\Connection.php(47): Zend_Db_Adapter_Pdo_Abstract->setFetchMode(5) 
#1 Cwww\webroot\cms\app\core\db\Connection.php(29): Tomato_Core_Db_Connection::_getConnection('slave') 
#2 Cwww\webroot\cms\app\App.php(61): Tomato_Core_Db_Connection::getSlaveConnection() 
#3 Cwww\webroot\cms\index.php(81): Tomato_App->__construct() 
#4 {main} thrown in Cwww\webroot\cms\lib\Zend\Db\Adapter\Pdo\Abstract.php on line 342"
    Help me!!!

    Nguyễn Đình Trọng at 13:43:32 05-01-2010 Reply
  • TomatoCMS Team

    pdo, pdo_mysql extensions are required
    @Trong: TomatoCMS requires some PHP extensions including: mysql, pdo, pdo_mysql, mbstring, gd, json, simplexml, xml, xmlreader. You received the error above because two extensions pdo and pdo_mysql have not been installed. On Windows, you can active these extensions by uncommenting two lines (remove the ; at the beginning of line) as follow: 

    extension=php_pdo.dll
extension=php_pdo_mysql.dll
    in php.ini file.

    TomatoCMS Team at 18:59:16 05-01-2010 Reply
  • Phạm Thanh Bình

    Error

    Fatal error: Call to a member function toArray() on a non-object in Evhosts\tomato.local\public_html\app\core\db\Connection.php on line 43

    Phạm Thanh Bình at 01:21:48 06-01-2010 Reply
  • TomatoCMS Team

    Can you post content of your configuration file?
    @Pham Thanh Binh: Can you post content of your configuration file? (TomatoCMS_Installed_Folder/app/config/app.ini)

    TomatoCMS Team at 16:03:23 06-01-2010 Reply
  • Hoàng Thái Bình

    Received "Permission denied" warning!
    I received following warning: 

    fopen(/home/t33nbiz/public_html/Home/temp/cache/layout_home.php) [function.fopen]: failed to open stream: Permission denied in /home/t33nbiz/public_html/Home/app/core/view/helper/LayoutLoader.php on line 96

Warning: fwrite(): supplied argument is not a valid stream resource in /home/t33nbiz/public_html/Home/app/core/view/helper/LayoutLoader.php on line 145
...
    Please help me!

    Hoàng Thái Bình at 20:40:05 07-01-2010 Reply
  • TomatoCMS Team

    Some folders have not been set write permision
    @Hoang Thai Binh: You have to provide the write permission for files/folders which was listed on step 5. In your case, you have not set the write permission for the "temp" folder (/home/t33nbiz/public_html/Home/temp). Lets us know if you still receive the warning! Thanks.

    TomatoCMS Team at 00:27:38 08-01-2010 Reply
Write your comment:

About

This is official blog of TomatoCMS, an open source CMS powered by Zend Framework, jQuery and 960 grid.

Poll

Collapse
How do you know about TomatoCMS?
  • Google
  • RSS channels
  • PHP developer forums
  • Other
^
© Copyright 2009 TomatoCMS Core Team