This Installation Guide is prepared for Ubuntu Operating System. Of course, you can use any unix-based system, but in this case you need to adopt this manual by youself. Before your start make sure your have a dedicated (virtual) server with root permission. On a usual hosting the system will not work!
This section will describe how to prepare server for an installation of AtroCore Application.
- Apache web server preparation (RECOMMENDED)
- Nginx web server preparation
This section describes how to install AtroCore Application on the prepared web server.
if the directory already exists, remove everything inside the directory.
To create the directory, run the command:
mkdir /var/www/my-atrocore-project
my-atrocore-project – project name
cd /var/www/my-atrocore-project
Git may be used for this step, so make sure that git is installed. Please note, it is still possible to install the application without having
git(see 3.6).
It is essential, that you use the composer version, which is embedded in our software, because this version contains some of our modifications needed for backup and restoring of the system files and the database. That is why
php composer.phar updateis used. Please DO NOT use composer, which is installed on your server as it does not contain the required modifications.
run
git clone https://github.com/atrocore/skeleton-pim.git . && php composer.phar self-update && php composer.phar update
run
git clone https://github.com/atrocore/skeleton-pim-no-demo.git . && php composer.phar self-update && php composer.phar update
run
git clone https://github.com/atrocore/skeleton-dam.git . && php composer.phar self-update && php composer.phar update
run
git clone https://github.com/atrocore/skeleton-dam-no-demo.git . && php composer.phar self-update && php composer.phar update
Please install AtroDAM and than remove AtroDAM module via Administration > Module Manager.
If you have no git installed you may still copy the files to the project folder manually.
You can download the files from one of this directory:
- https://github.com/atrocore/skeleton-pim
- https://github.com/atrocore/skeleton-pim-no-demo
- https://github.com/atrocore/skeleton-dam
- https://github.com/atrocore/skeleton-dam-no-demo
Than upload the files to your project folder and run
php composer.phar update
chown -R www-data:www-data /var/www/my-atrocore-project/
Ubuntu and Debian use www-data as a standard user for the webserver. This can also be one of the following: www, apache2, psacln etc.
find . -type d -exec chmod 755 {} + && find . -type f -exec chmod 644 {} +;
find client data custom upload -type d -exec chmod 775 {} + && find client data custom upload -type f -exec chmod 664 {} +
6.1. Open crontab for your webserver user, which is www-data in our case:
crontab -e -u www-data
6.2. Add the following configuration:
* * * * * /usr/bin/php /var/www/my-atrocore-project/index.php cron
Please consider that
/usr/bin/phpis the correct path to PHP in our case. You may have other path. "cron" is the required parameter and should be definitely included for appropriate functioning.
User must have all privileges for the database, which should be used for the AtroCore Application. You can create database and user with all privileges by executing next few commands:
If MySQL Database is not installed, you need to install it.
Connect to MySQL as a root user:
mysql -u root -p
Create the database atrocore:
CREATE DATABASE atrocore;
Create user atrocore_user with password atrocore_password and grant all needed privileges:
CREATE USER 'atrocore_user'@'localhost' IDENTIFIED BY 'atrocore_password';
GRANT ALL ON atrocore.* TO atrocore_user@localhost WITH GRANT OPTION;
Start the installation wizard for your AtroCore Application in the web interface from your URL: http://YOUR_PROJECT/ . Follow the instructions in the wizard.