diff --git a/INSTALL/INSTALL.md b/INSTALL/INSTALL.md index 6db03ff..318bda8 100644 --- a/INSTALL/INSTALL.md +++ b/INSTALL/INSTALL.md @@ -2,27 +2,35 @@ An Ubuntu server (18.04/20.04 should both work fine) - though other linux installations should work too. - apache2, mysql/mariadb, sqlite need to be installed and running -- php extensions for intl, mysql, sqlite need to be installed and running +- php extensions for intl, mysql, sqlite3, mbstring, xml need to be installed and running +- composer ## Cerebrate installation instructions -Simply clone this repository (for example into /var/www/cerebrate) +It should be sufficient to issue the following command to install the dependencies: +``` +sudo apt install apache2 mariadb-server git composer php-intl php-mbstring php-dom php-xml unzip php-ldap php-sqlite3 sqlite libapache2-mod-php php-mysql +``` + +Clone this repository (for example into /var/www/cerebrate) ``` -cd /var/www -git clone git@github.com:cerebrate-project/cerebrate.git +sudo mkdir /var/www/cerebrate +sudo chown www-data:www-data /var/www/cerebrate +sudo -u www-data git clone https://github.com/cerebrate-project/cerebrate.git /var/www/cerebrate ``` Run composer ``` cd /var/www/cerebrate -composer install +sudo -u www-data composer install ``` Create a database for cerebrate +From SQL shell: ``` mysql CREATE DATABASE cerebrate; @@ -32,25 +40,64 @@ GRANT ALL PRIVILEGES ON cerebrate.* to cerebrate@localhost; FLUSH PRIVILEGES; ``` +Or from Bash: +``` +sudo mysql -e "CREATE DATABASE cerebrate;" +sudo mysql -e "CREATE USER 'cerebrate'@'localhost' IDENTIFIED BY 'YOUR_PASSWORD';" +sudo mysql -e "GRANT USAGE ON *.* to cerebrate@localhost;" +sudo mysql -e "GRANT ALL PRIVILEGES ON cerebrate.* to cerebrate@localhost;" +sudo mysql -e "FLUSH PRIVILEGES;" +``` + Load the default table structure into the database ``` -mysql -u cerebrate -p cerebrate < /var/www/cerebrate/INSTALL/mysql.sql +sudo mysql -u cerebrate -p cerebrate < /var/www/cerebrate/INSTALL/mysql.sql ``` create your local configuration and set the db credentials ``` -cp -a /var/www/cerebrate/config/app_local.example.php /var/www/cerebrate/config/app_local.php -vim /var/www/cerebrate/config/app_local.php +sudo -u www-data cp -a /var/www/cerebrate/config/app_local.example.php /var/www/cerebrate/config/app_local.php +sudo -u www-data vim /var/www/cerebrate/config/app_local.php +``` + +Modify the Datasource -> default array's username, password, database fields + +Create an apache config file for cerebrate / ssh key and point the document root to /var/www/cerebrate/webroot/index.php and you're good to go. + +mod_rewrite needs to be enabled: + +``` +sudo a2enmod rewrite ``` Simply modify the Datasource -> default array's username, password, database fields +This would be, when following the steps above: +``` + 'Datasources' => [ + 'default' => [ + 'host' => 'localhost', + 'username' => 'cerebrate', + 'password' => 'YOUR_PASSWORD', + 'database' => 'cerebrate', +``` Create an apache config file for cerebrate / ssh key and point the document root to /var/www/cerebrate/webroot/index.php and you're good to go +For development installs the following can be done: + +``` +# This configuration is purely meant for local installations for development / testing +# Using HTTP on an unhardened apache is by no means meant to be used in any production environment +sudo cp /var/www/cerebrate/INSTALL/cerebrate_dev.conf /etc/apache2/sites-available/ +sudo ln -s /etc/apache2/sites-available/cerebrate_dev.conf /etc/apache2/sites-enabled/ +sudo service apache2 restart +``` + +Now you can point your browser to: http://localhost:8000 + To log in use the default credentials below: -username: admin +Username: admin Password: Password1234 - diff --git a/documentation/logos/logo-hungarian-colors.png b/documentation/logos/logo-hungarian-colors.png index da2dc85..82bcaab 100644 Binary files a/documentation/logos/logo-hungarian-colors.png and b/documentation/logos/logo-hungarian-colors.png differ diff --git a/documentation/logos/logo-hungarian-colors.svg b/documentation/logos/logo-hungarian-colors.svg index c183f30..380d36a 100644 --- a/documentation/logos/logo-hungarian-colors.svg +++ b/documentation/logos/logo-hungarian-colors.svg @@ -104,7 +104,7 @@ inkscape:pageshadow="2" inkscape:zoom="0.94316065" inkscape:cx="-374.91366" - inkscape:cy="599.30769" + inkscape:cy="472.07592" inkscape:document-units="mm" inkscape:current-layer="layer1" showgrid="false" @@ -138,7 +138,9 @@ y="124.71172" rx="0" ry="0" - transform="rotate(9.7671315)" /> + transform="rotate(9.7671315)" + inkscape:export-xdpi="100" + inkscape:export-ydpi="100" /> + transform="rotate(-2.3147481)" + inkscape:export-xdpi="100" + inkscape:export-ydpi="100" /> + transform="rotate(-14.177568)" + inkscape:export-xdpi="100" + inkscape:export-ydpi="100" />