Install Wizard
From TomatoCMS Documentation
First, you can download TomatoCMS on our website
Contents |
Install Wizard
First, you have to create your database to contain your website data.
For MySQL - Install MySQL as appropriate for your operating system. There are a lot of documents on how to do this all over the internet and I'm not going to reiterate all of that here.
SECURITY TIP: Be sure to set a root password
Start your MySQL
Log in your MySQL database - For *nix operating systems and Windows from the command line: mysql -u root -p & hit enter
It will ask for the root password you set earlier.
You should get a prompt that says "mysql>"
Type in "CREATE DATABASE <mydatabase>;" <-- Note the semi-colon on the end which MUST be included on all statements to the database.
Do NOT include the < and >!
Hit enter.
SECURITY TIP: Do not use the default database or user names or passwords included in the installation the document
Now you will need to make a user.
Type in "CREATE USER 'myuser'@'localhost/hostname' IDENTIFIED BY 'mysecurepassword';" & Hit enter
Type in "GRANT ALTER, ALTER ROUTINE, CREATE, CREATE ROUTINE, CREATE TEMPORARY TABLES, CREATE VIEW, DELETE, DROP, EXECUTE, INDEX, INSERT, LOCK TABLES, REFERENCES, SELECT, SHOW VIEW, UPDATE ON `mydatabase`.* TO 'myuser'@'localhost/myhostname' WITH GRANT OPTION;" & hit enter.
Type in "FLUSH PRIVILEGES;" <-- Note the semi colon
Your database is created, your user is created, your user has their password and their rights set. You should be ready to rumble.
Step 1
Point your web browser to http://localhost/tomatocms/index.php
It will redirect you to the install page.
At the first step, you can select language to set default language for your website, it available two language: English and Vietnamese. You can also choose another language by upload your language package at here.
Then, click Next.
Step 2
At the second step, TomatoCMS will check some extensions and some permissions to ensure that TomatoCMS can install completely. If one of these parameters are not ready, TomatoCMS can not install so you need to adjust that parameter.
For *nix Operating Systems -
1) Find out what user and group your web server is running as. This information should be in your apache2.conf on most distributions. It's probably www-data and www-data (user and group) but not guaranteed - SO CHECK FOR YOURSELF.
2) Type in: chown -R www-data:www-data /path/to/tomato/applications/config & hit enter
3) Type in: chown -R www-data:www-data /path/to/tomato/applications/templates & hit enter
4) Type in: chown -R www-data:www-data /path/to/tomato/temp & hit enter
5) Type in: chown -R www-data:www-data /path/to/tomato/upload & hit enter
That will give your apache instance ownership of those files. Next, you will need to make sure that it has sufficient file permissions to write to them.
1) Type in: chmod -R 755 /path/to/tomato/applications/config & hit enter
2) Type in: chmod -R 755 /path/to/tomato/applications/templates & hit enter
3) Type in: chmod -R 755 /path/to/tomato/temp & hit enter
4) Type in: chmod -R 755 /path/to/tomato/upload & hit enter
And we have to repeat the process for a couple of more things or you will get some nasty Zend errors...
Those files are:
/path/to/tomato/application/modules/mail/config/config.ini
/path/to/tomato/application/modules/seo/config/config.ini
Once you have these set, hit refresh and make sure that the wizard thinks you're ready. When it says everything is good, click Next to the next step.
Step 3
At the third step, enter your website information.
The important thing here is that you have to enter the correct database information.
Use the port number, username, password, and database name which was created.
NOTE: If you do not see drop down menu here with your type of database (MySQL, PostgreSQL, etc.) your php PDO is either not installed or enabled. You may have to adjust your php.ini and restart your web server.
MySQL Note: You may also need to adjust your my.cnf to either allow for only localhost or adjust your settings here for the IP address. For MySQL the *default* port is 3306 but again, you need to check YOUR configuration file for YOUR server.
PostgreSQL Note: The *default* port for PostgreSQL is 5432 but you should verify this in your configuration file and make sure that your hba.conf allows for the access you need.
After fill information, click on the Next button, you will have to waiting for a few minutes.
Step 4
The final step informs that you have just installed TomatoCMS successfully.
It generated a random password. Copy it and save it to somewhere.
You HAVE TO press one of two that buttons to complete the installation.
Ideally, you should click on the "Go to Administrator" button.
At the sign in page, use admin as username, and the password you got from the final step of Install Wizard, and click on the Login button.
SECURITY TIP: Log in and change your password right away. Use a strong password.
Should click on the Go to the administrator button.
After logging in successfully, click on the Account > Change Password menu item.
Enter and confirm your new password, and press the Save button to change your password.
From now, you can use admin as the username and the password you have just set above to access the back-end section.
To view the front-end, you can click on the Visit Website link on the top of any back-end page.
