TrekToursInstaller

The repository within which the applications will be installed. Sources:

• Deployment helpers scripts
• TrekTours flyer website application
• TrekTours API application

Requirements

You need:

• Git and a Github account
• Composer
• NodeJS package manager (for Bower install in the website application)
• A PHP 7 server (The API will not work with PHP 5). Checkout MAMP for MAC or XAMP for Windows, Linux and MAC
• MySQL 5 server and a root user with no password. You can easily create that user with MySQL workbench

Local setup and installation on Linux and Macintosh computers

The installers are setup so that your DocumentRoot is /www/sites and your folder structure will be:

www
  |__ sites
          |__ api
          |__ deploy
          |__ public

The folders "api", "deploy" and "public" will be created with the installer "first-install-locally-mac.sh" script.

Please follow the following step to setup your machine. Run those commands with Terminal:

cd ~
mkdir wwww
cd wwww
# clone this repository
git clone https://github.com/Puzzlout/TrekToursInstaller.git
# Rename TrekToursInstaller to sites
mv TrekToursInstaller sites
# Install the applications
bash sites/global/first-install.sh /www/sites/ local

While the installers are running:

1. You should not see any error except for the api database warm up. If you are reinstalling from scratch and you didn't drop the database, you will see a constraint violation when adding the admin user. Let the installer finish.
2. When prompted about the parameters for the API, hit return if you want to keep the default (recommended). If you want to use the custom local database settings, just specify a name and an existing user/password.
3. When prompted about the parameters for the Flyer, input the API service URL to http://localhost/api/web or the URL to the API if you decided to use the virtual host.

First install

Local setup and installation on Windows computers

Coming soon...

Cloud 9 IDE installation

• Create a new workspace and input https://github.com/Puzzlout/TrekToursInstaller.git in "Clone from Git".
• Run bash c9/first-install.sh (READ THE NOTES BEFORE RUNNING THIS COMMAND)

Note 1: it will update the server and the PHP version to 7.0.8. Check out the script php-upgrade.sh in the deploy folder

Note 2: when prompted for the API database name, input "c9".

Note 3: when prompted for the API service URL during the website installation, input "https://***{{your workspace name}}-{{your c9 username}}***.c9users.io/api/web/app.php.

Liquid Web VPS

Please request access to this document.

Deployment workflow

Please request access to this document