This document describes how to set up ImpressCMS 1.0 Final On Debian Etch. Taken from the ImpressCMS page: “ImpressCMS is a community developed Content Management System for easily building and maintaining a dynamic web site. Keep your web site up to date with this easy to use, secure and flexible system.”
This howto is a practical guide without any warranty – it doesn’t cover the theoretical backgrounds. There are many ways to set up such a system – this is the way I chose.
1 Preliminary Note
I used a minimal Debian Etch system (network install) for this howto. The attached VM is configured as follows:
All passwords: Kreationnext
2 Needed Packages
Let’s install some needed package for this setup.
apt-get install apache2 libapache2-mod-php5 php5-mysql mysql-server mysql-client
3 MySQL Configuration
3.1 Bind Address
In order that the MySQL server will listen on all available interfaces, we have to adjust its configuration.
Search this line …
bind-address = 127.0.0.1
… and comment it so that it looks like this:
# bind-address = 127.0.0.1
Afterwards restart the MySQL server.
3.2 MySQL Root User
First we have to set a password for the MySQL root user.
mysqladmin -u root password %sql_root_password%
mysqladmin -h server1.example.com -u root password %sql_root_password%
3.3 ImpressCMS Database & Database User
Next we create a database for ImpressCMS.
mysqladmin -u root -p create impresscms
After that we create a user for this database.
mysql -u root -p
GRANT CREATE, ALTER, INDEX, DROP, CREATE TEMPORARY TABLES, SELECT, INSERT, UPDATE, DELETE ON impresscms.* TO ‘impresscms_admin’@’localhost’ IDENTIFIED BY ‘%impresscms_admin_password%’;
GRANT CREATE, ALTER, INDEX, DROP, CREATE TEMPORARY TABLES, SELECT, INSERT, UPDATE, DELETE ON impresscms.* TO ‘impresscms_admin’@’localhost.localdomain’ IDENTIFIED BY ‘%impresscms_admin_password%’;
4 ImpressCMS Vhost
Create the document root for ImpressCMS …
… and the ImpressCMS trust directory.
Now we create the vhost configuration file.
It could look like this:
NameVirtualHost 192.168.0.100:80 <VirtualHost 192.168.0.100:80> ServerName server1.example.com ServerAdmin email@example.com DocumentRoot /var/www/impresscms/ LogLevel warn ErrorLog /var/log/apache2/impresscms_error.log CustomLog /var/log/apache2/impresscms_access.log combined </VirtualHost>
After that enable the new vhost …
… and restart Apache to take the changes effect.
5 Get ImpressCMS
Please take a look at http://www.impresscms.org/modules/mastop_publish/?tac=Download to find out which is the latest version. When I was writing this howto it was version 1.0 .
tar xvfz impresscms_1.0_final.tar.gz
Afterwards copy the content of the extracted folder “htdocs” to the vhost document root …
cp -R /tmp/htdocs/* /var/www/impresscms/
… and change the permissions.
chown -R www-data:www-data /var/www/impresscms/ /var/www/impresscms_trust/
chmod -R 755 /var/www/impresscms/uploads/ /var/www/impresscms/cache/ /var/www/impresscms/templates_c/ /var/www/impresscms/mainfile.php
Now we are ready for the installation – open http://server1.example.com/ within your preferred browser. An installation wizard will guide you through the installation process. Note: Additional language files can be found on the ImpressCMS SourceForge page.
The script has checked the server configuration – all results should be green.
The script has checked the file and directory permissions – they should be correct. Change the trust path to “/var/www/impresscms_trust” and create the path (click on the corresponding button).
Insert the database name, user name and password (from step 3.3).
Proceed with the installation.
At this point the script is ready to create the database tables.
The database tables have been created.
Insert the data for the administrator account (I chose “admin” as admin login).
The script is now ready to populate the database.
The database has been populated.
Finished. Click on “Show my site”.
Afterwards, before you log in, delete the install directory and change the permissions of the mainfile.
rm -Rf /var/www/impresscms/install/
chmod 444 /var/www/impresscms/mainfile.php
Now you can log in with the administrator account that you created at step 8/10 in the installation wizard.
- Debian: http://www.debian.org/
- ImpressCMS: http://www.impresscms.org/
- ImpressCMS on SourceForge: http://sourceforge.net/projects/impresscms/