1. Installation

AmSYS

AmSYS, originally developed for The Amarr Republic/Allied Industries, is an application designed to assist in Eve Online Corp or Alliance logistical activities.

---

Deployment Guide

I personally have deployed this to remote hosted (DigitalOcean - $5/month) Ubuntu 16 and self hosted Ubuntu 16, Windows, and MacOS. The following guide will explain how to install on Ubuntu 16 (specifically using DigitalOcean, although it should apply to any Ubuntu 16 server).

1. Install LAMP stack (Apache2, MySQL, PHP 7.x) DigitalOcean Ubuntu 16 LAMP
2. If running with low available memory, add Swap to the server - this improves performance DigitalOcean Adding SWAP
3. Install PHPMyAdmin, it will assist with database maintenance DigitalOcean Secure PHPMyAdmin Install
4. Install php7-zip and bz2

sudo apt-get install php7.0-zip
sudo apt-get install php7.0-bz2

4. Clone Git Repository to /var/www/html this will create a folder called 'amsys'

cd /var/www/html
git clone https://github.com/binarygod/AmSYS.git

5. Edit /etc/apache2/sites-enabled/000-default.conf and add new VirtualHost using your own information. The important parts are the DocumentRoot and Directory configuration. (NOTE: Apache ^2.4 uses Require all granted instead of Order Allow,Deny & Allow from All)

<VirtualHost *:80>
        ServerName sub.yourdomain.com
        ServerAlias sub.yourdomain.com

        DocumentRoot /var/www/html/amsys/web
        <Directory /var/www/html/amsys/web>
                AllowOverride All
                Order Allow,Deny
                Allow from All
        </Directory>
</VirtualHost>

6. Navigate to /var/www/html/amsys and download/install Composer with the commands on the site.
7. Using PHPMyAdmin create two databases, one is for Amsys data, the other is for Eve SDE data. Create a user and GRANT full access on both databases. The name doesn't really matter, I name mine 'amsys' and 'evedata'.
8. Create SSO Information
   1. Access Eve Developers and login using SSO.
   2. Click create new application
   3. Provide Name and Description
   4. Select 'Authentication & API Access'
      1. Select all scopes, don't worry not all will be used! This just helps avoid mismatches
   5. Callback URL is 'http://yourdomain.com/sso/callback'
   6. Save
   7. Click on created application and record the Client Id and Secret Key.
9. Install dependencies by running php composer.phar install, if you a 'Killed' message see Troubleshooting below
   1. Provide configuration details when prompted (These can be edit later via amsys/app/config/parameters.yml)
10. Fix permissions on the application, from the /var/www/html/amsys directory, run the following (If ACL isn't installed you will need to sudo apt-get install acl, as of Ubuntu 12 ACL is already enabled on the filesystem)

HTTPDUSER=`ps axo user,comm | grep -E '[a]pache|[h]ttpd|[_]www|[w]ww-data|[n]ginx' | grep -v root | head -1 | cut -d\  -f1`
sudo setfacl -R -m u:"$HTTPDUSER":rwX -m u:`whoami`:rwX app/cache app/logs
sudo setfacl -dR -m u:"$HTTPDUSER":rwX -m u:`whoami`:rwX app/cache app/logs

10. Navigate to /var/www/html/amsys/app/config and check the values of your Parameters.yml for accuracy
11. Navigate to /var/www/html/amsys, run php app/console doctrine:schema:update --force to create database tables
12. Run php app/console amsys:settings:populate to create default settings
13. Run php app/console amsys:sde:update to download latest SDE from Fuzzworks
14. Run php app/console amsys:cache:update to pull all Ore/Minerals/Ice/Gas/PI prices and create the cache
15. Restart Apache

sudo systemctl restart apache2 

16. Navigate to the web address (the the virtual host points to) and you should see the login page

---

After installation, the next step is to create a System Admin User