README.md

Joinup on macOS without Docker

Here you will find the steps to run the Joinup project on your mac without Docker.

Prerequisites

• Brew, Composer, Drush, Apache and PHP: Install Apache & Multiple php versions
• MySql & Apache Virtual Hosts & DnsMasq: Install mysql & Apache Virtual Hosts & Dnsmasq
• Redis: Install and config Redis

Installation

1. Uncomment these lines on http.conf file /usr/local/etc/httpd/httpd.conf

   LoadModule vhost_alias_module lib/httpd/modules/mod_vhost_alias.so
   Include /usr/local/etc/httpd/extra/httpd-vhosts.conf
   

2. Add virtual-host /usr/local/etc/httpd/extra/http-vhosts.conf

   <VirtualHost *:80>
     ServerName joinup.test
     # Replace with your project path.
     DocumentRoot "/Users/.../.../joinup-dev/web"
     # Replace with your project path.
     <Directory "/Users/.../.../joinup-dev/web">
       AllowOverride all
       Require all granted
     </Directory>
   </VirtualHost>
   

3. Add new host in /private/etc/hosts

   127.0.0.1   joinup.test
   

4. Restart Apache

   $ sudo apachectl -k restart

5. Only if you have XDebug installed check php.ini file for the config:

   [xdebug]
   ;zend_extension=“xdebug.so”
   xdebug.remote_enable=1
   xdebug.remote_autostart=0
   xdebug.max_nesting_level=256
   ;xdebug.collect_params=3
   ;xdebug.profiler_enabled=1
   ;xdebug.profiler_output_dir=/tmp/
   ;xdebug.profiler_enable_trigger=1
   

Setting up the project

1. Clone the respository of this project

   $ git clone https://github.com/ec-europa/joinup-dev.git

2. Create a local task runner configuration file

   In order to override any configuration of the task runner (./vendor/bin/run), create a runner.yml file in the project's top directory. You can override there any default runner configuration, or any other declared in ./resources/runner files or in runner.yml.dist. Note that the runner.yml file is not under VCS control.

3. Setup environment variables

Sensitive data will be stored in environment variables. See .env.dist for details.

! Important: For the ASDA settings please contact your local developer !

3. Run composer

   $ composer install

4. Run toolkit:build-dev

   $ ./vendor/bin/run toolkit:build-dev

5. Install and/or relink

   $ brew unlink unixodbc
   $ brew install virtuoso
   $ brew unlink virtuoso
   $ brew link unixodbc
   $ brew link --overwrite virtuoso

6. Setup Virtuoso

   $ ./vendor/bin/run virtuoso:setup
   $ ./vendor/bin/run virtuoso:start

Check Virtuoso

7. Run toolkit:install-clean

   $ ./vendor/bin/run toolkit:install-clean

8. Setup Solr and check if it's running

    $ ./vendor/bin/run solr:setup

   Check Solr

9. Download production Databases

   $ ./vendor/bin/run dev:download-databases

10. Rebuild environment

$ ./vendor/bin/run toolkit:install-clone

12. Unblock the admin user

$ drush user:unblock

13. Login with the admin user

$ drush uli

Switching between branches

This is needed when you'll have to switch a branch and keep your content up to date:

$ ./vendor/bin/composer install
$ ./vendor/bin/run toolkit:build-dev
$ ./vendor/bin/run toolkit:install-clone