Team2021Group19

h1. HowTo Setup the Environment on Ubuntu 18.04

{{>toc}}

h2. Step 0: Download the ISO

Grab the latest and greatest 18.04 "here":https://www.ubuntu.com/download/desktop

Just a heads up it is a 1.8Gb download.

h2. Step 1: Install

Boot the ISO in a new VM (recommended) or from a flash drive via the BIOS if you want to replace your OS / dual boot. (not recommended)

Complete the Ubuntu installation steps and reboot when it asks to.

Welcome to 18.04

h2. Step 2: Install MySQL

(NOTE: install MySQL-Server first or you’re going to have a bad time)

Open the terminal and run the command: 

<pre>sudo apt install mysql-server</pre>

h2. Step 3: Install the rest

Now that MySQL is installed, we can install all the other bells and whistles: 

<pre>sudo apt install apache2 curl vim php ssh phpmyadmin php-curl php-zip php-bcmath net-tools git</pre>

h2. Step 4: Creating a MySQL super user

So apparently 18.04 doesn't allow authentication via password for the root user.

So we get around this by creating our own super user. (NOTE: Do not do this on a production server.)

<pre>sudo mysql</pre>

(NOTE: change mypassword in the following segment of code to be whatever password you want the super user to have.)

<pre>CREATE USER 'admin'@'localhost' IDENTIFIED BY 'mypassword';

GRANT ALL PRIVILEGES ON *.* TO 'admin'@'localhost';

GRANT GRANT OPTION ON *.* TO 'admin'@'localhost';

FLUSH PRIVILEGES;</pre>

h2. Step 5: Create the Apache virtual host config file​

<pre>sudo vim /etc/apache2/sites-available/local.321project.com.au.conf</pre>

<pre><VirtualHost *:80>

    ServerAdmin ​username@email.com

    Server​Name local.onko.com.au

    ServerSignature Off

    # Turn off mod_security filtering.

    <IfModule mod_security2.c>

        SecFilterEngine Off

    </IfModule>

    DocumentRoot /home/​myname​/workspace/321project

    <Directory />

        Options FollowSymLinks MultiViews

        DirectoryIndex index.php

        AllowOverride All

        Header always set Access-Control-Allow-Origin "*"

        Header set Access-Control-Allow-Credentials "true"

        Header always set Access-Control-Allow-Methods "GET, PUT, POST, DELETE, OPTIONS"

        Header always set Access-Control-Allow-Headers "DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Authorization,X-CSRF-Token"

        Require all granted

        # Modify the RewriteBase if you are using Drupal in a subdirectory and the  RewriteBase /

    </Directory>

    ErrorLog /var/log/apache2/error.log

    # Possible values include: debug, info, notice, warn, error, crit,

    # alert, emerg.

    LogLevel warn

    CustomLog /var/log/apache2/access.log combined

</VirtualHost></pre>

h2. Step 6: Configuring all the things

Apache config stuff

<pre>sudo a2enmod headers rewrite

sudo a2ensite local.onko.com.au</pre>

Edit the hosts file 

<pre>cd /etc

sudo vim hosts</pre>

and add the following line near the top (‘i’ to insert in vim): 

<pre>

127.0.0.1        local.onko.com.au 

</pre>

<esc> :wq //escape to exit insert mode,   :wq to write and quit 

restart Apache so the changes take effect

<pre>systemctl restart apache2</pre>

h2. Step 7: Install Composer

<pre>php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

php -r "if (hash_file('SHA384', 'composer-setup.php') === '544e09ee996cdf60ece3804abc52599c22b1f40f4323403c44d44fdfdd586475ca9813a858088ffb c1f233e9b180f061') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

php composer-setup.php

php -r "unlink('composer-setup.php');" 

sudo mv composer.phar /usr/local/bin/composer

</pre>

h2. Step 8: Installing the Service Club Base

The Drupal Base install can be found at: https://github.com/didymo/service_club_base

Use the following commands to git clone it to your workspace folder.

<pre>

cd

mkdir workspace

cd workspace

git clone https://github.com/didymo/service_club_base.git

cd service_club_base

composer install

</pre>

h2. Step 9: Drupal configuration

Open your favourite internet browser and go to: http://local.onko.com.au

Follow the drupal site install instructions, and you will have a working local site!