Skip to content
This repository has been archived by the owner on Mar 30, 2022. It is now read-only.

1. Installation

Jump to bottom
Aaron Heidorn edited this page May 26, 2017 · 7 revisions

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
  1. 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
  1. 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.
<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>
  1. Navigate to /var/www/html/amsys and download/install Composer with the commands on the site.
  2. 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
  3. Install dependencies by running php composer.phar install, if you a 'Killed' message see Troubleshooting below
  • Provide configuration details when prompted (These can be edit later via amsys/app/config/parameters.yml)
  1. 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
  1. Navigate to /var/www/html/amsys/app/config and check the values of your Parameters.yml for accuracy
  2. Navigate to /var/www/html/amsys, run php app/console doctrine:schema:update --force to create database tables
  3. Run php app/console amsys:settings:populate to create default settings
  4. Run php app/console amsys:sde:update to download latest SDE from Fuzzworks
  5. Run php app/console amsys:cache:update to pull all Ore/Minerals/Ice/Gas/PI prices and create the cache
  6. Restart Apache
sudo systemctl restart apache2
  1. Navigate to the web address (the the virtual host points to) and you should see the login page

Creating User Account

  1. Navigate to http://your.com/register and register an account, API is used ONLY to confirm that you own that character
  2. Login to PHPMyAdmin and load the Users table, change role from ROLE_USER to ROLE_ADMIN and save.
  3. Logout of Amsys and log back in, you now have admin permissions

Auto Update Cache

Add Cron Job to pull Ore/Minerals/Ice/Gas/PI prices every 15 minutes.

  1. crontab -e
  2. */15 * * * * php /var/www/html/amsys/app/console amsys:cache:update

Troubleshooting

Composer 'Killed' error

This is due to the server not having any swap space, add swap space.

Updating your Installation

Easiest way is to create an update script

  1. Navigate to /var/www/html/amsys and create update.sh
  2. Make is executable, chmod +x update.sh
  3. Edit update.sh
git pull https://username:[email protected]/binarygod/amsys.git
php app/console cache:clear --env=prod
  1. To do an update and get new changes, simply navigate to /var/www/html/amsys and run ./update.sh, this will pull the new code and refresh the cache

Roles

I never coded an interface in for Groups and permissions, I was the sole coder so it wasn't high priority. Current Roles are as follows

  1. ROLE_ADMIN: ROLE_OFFICER, ROLE_EDITOR - GOD!
  2. ROLE_OFFICER: ROLE_MEMBER, ROLE_EDITOR - All of below, can't actually remember what else
  3. ROLE_EDITOR: ROLE_MEMBER - Can use buyback, gets discounted rate, can Edit/Create 'Pages'
  4. ROLE_MEMBER: ROLE_USER - Can use buyback, gets discounted rate, can access 'Pages'
  5. ROLE_USER - Can use buyback, gets discounted rate, cannot access 'Pages'
Clone this wiki locally