The following instructions are for installing TAO on MacOS Mojave.
The following instructions are for MacOS Mojave and utilizes /Users/
You will need to install brew on your system if you have not done so previously in order to install various software packages such as http, php, and mariadb:
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Verify your brew installation:
brew --version brew doctor
Install wget, composer and git in order to install TAO:
brew install wget composer git
Install and start PHP 7.2
brew install email@example.com php -v brew services start php
As MAcOS Mojave comes with a default Apache2, we will need to stop and unload it to install our own:
sudo apachectl stop sudo launchctl unload -w /System/Library/LaunchDaemons/org.apache.httpd.plist 2>/dev/null
Now we are ready to install and start httpd:
brew install httpd brew services start httpd
Using the editor of your choice, you will need to configure Apache. If you are using virtual hosts, you will need to follow the Apache instructions which can be found here(https://httpd.apache.org/docs/2.4/vhosts/examples.html)
Configure the port to 80 vs 8080
#Listen 8080 Listen 80
ServerName <hostname or IP>
Set user and group
User <user> Group <group>
Change DocumentRoot and configure directory
DocumentRoot /Users/<user>/tao <Directory /Users/<user>/tao> Options Indexes FollowSymLinks MultiViews AllowOverride All Require all granted </Directory>
You will need to configure Apache to use the mod_rewrite and firstname.lastname@example.org modules:
LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so LoadModule php7_module /email@example.com/lib/httpd/modules/libphp7.so
You will also want to configure Apache to serve PHP pages first by editing the dir_module section to have index.php first.
<IfModule dir_module> DirectoryIndex index.php index.html </IfModule> <FilesMatch \.php$> SetHandler application/x-httpd-php </FilesMatch>
For the database, we will be using MariaDB which we will install with brew:
brew install mariadb brew services start mariadb
At this point you can login to the database as
Create a new database and user for TAO.
mysql create database <database>; create user '<user>'@'localhost' identified by '<password>'; grant all privileges on <database>.* to '<user>@'localhost' with grant option; flush privileges; quit
Download the Tao Package from the website or GitHub and prepare to install
wget https://releases.taotesting.com/TAO_3.3.0-RC2_build.zip unzip TAO_3.3.0-RC2_build.zip sudo mv TAO_3.3.0-RC2_build /Users/<user>/tao
Or use Git to download the latest release from GitHub directly
git clone https://github.com/oat-sa/package-tao.git /Users/<user>/tao cd /Users/<user>/tao git checkout release-3.3-rc02
Verify your Apache configuration and restart Apache:
apachectl configtest brew services restart httpd
Install TAO components on to the server utilizing composer and then change ownership of the newly created tao directory to the Apache user.
cd /Users/<user>/tao composer install
Install MathJax on the server if needed.
sudo wget --no-check-certificate https://hub.taotesting.com/resources/taohub-articles/articles/third-party/MathJax_Install_TAO_3x.sh sudo chmod u+x MathJax_Install_TAO_3x.sh sudo ./MathJax_Install_TAO_3x.sh
You can now complete your installation either on the command line with the following command:
sudo -u www-data php tao/scripts/taoInstall.php \ --db_driver pdo_mysql \ --db_host localhost \ --db_name <db_name> \ --db_user <user> \ --db_pass <password>\ --module_namespace http://<hostname or IP>/first.rdf \ --module_url http://<hostname or IP> \ --user_login <user> \ --user_pass <password> \ -e taoCe
And your TAO instance will be available at:
http://<hostname or IP>
Or you can install TAO in your browser by going to
http://<hostname or IP> if you have followed the above instructions. If you did not follow the above instructions for your Apache configuration you will need to adjust the URL as appropriate.