157 lines
5.4 KiB
Markdown
157 lines
5.4 KiB
Markdown
#### Install passenger (e.g. Ubuntu Trusty like this:)
|
|
|
|
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 \
|
|
--recv-keys 561F9B9CAC40B2F7
|
|
sudo apt-get install -y apt-transport-https ca-certificates
|
|
|
|
# Add APT repository
|
|
sudo sh -c 'echo deb https://oss-binaries.phusionpassenger.com/apt/passenger trusty main > /etc/apt/sources.list.d/passenger.list'
|
|
sudo apt-get update
|
|
|
|
# Install Passenger + Nginx (try apache if you would rather not change
|
|
# nginx)
|
|
sudo apt-get install -y nginx-extras passenger
|
|
|
|
#### Setup Postgres
|
|
|
|
sudo apt-get install postgresql-9.4 #specify version!!
|
|
sudo -u postgres psql
|
|
postgres=# CREATE USER metamaps WITH PASSWORD 'mycoolpassword' CREATEDB;
|
|
postgres=# CREATE DATABASE metamap002_production OWNER metamaps;
|
|
postgres=# \q
|
|
|
|
#### Install system-wide rvm:
|
|
|
|
sudo gpg --keyserver hkp://keys.gnupg.net \
|
|
--recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
|
|
\curl -sSL https://get.rvm.io | sudo bash -s stable
|
|
echo "gem: --no-ri --no-rdoc" | sudo tee -a /etc/gemrc
|
|
|
|
#### Create user and setup gemsets for that user
|
|
|
|
sudo adduser --disabled-password metamaps
|
|
sudo adduser metamaps rvm
|
|
|
|
#### Clone github repo and install gems
|
|
|
|
sudo su - metamaps
|
|
rvm user gemsets
|
|
git clone https://github.com/metamaps/metamaps \
|
|
--branch instance/mycoolinstance
|
|
rvm install $(cat metamaps/.ruby-version) #ensure ruby is installed
|
|
cd metamaps
|
|
gem install bundler
|
|
RAILS_ENV=production bundle install
|
|
|
|
#### Connect rails database
|
|
|
|
Run this in the metamaps directory, still as metamaps:
|
|
|
|
# fill in DB_* values, and realtime server at least. Change the
|
|
# SECRET_KEY_BASE to something new. Ctrl+X to save/exit from nano.
|
|
cp .example-env .env
|
|
nano .env
|
|
|
|
# Set up environment variables in your current session
|
|
source .env
|
|
export RAILS_ENV=production
|
|
export NODE_ENV=production
|
|
|
|
# create, load schema, seed
|
|
bundle exec rails db:setup
|
|
|
|
#### Install node & ES6 modules
|
|
|
|
sudo aptitude install nodejs npm
|
|
sudo ln -s /usr/bin/nodejs /usr/bin/node
|
|
npm install
|
|
|
|
#### Precompile assets
|
|
|
|
This step depends on running npm install first; assets:precompile calls `npm install` and `bin/build-apidocs.sh`, both of which require node_modules to be installed. We suggest you run the commands separately this time to better catch any errors.
|
|
|
|
npm run build
|
|
bin/build-apidocs.sh
|
|
bundle exec rails assets:precompile
|
|
bundle exec rails perms:fix
|
|
|
|
#### Nginx and SSL
|
|
|
|
We recommand using Passenger + Nginx to serve your website. You can contact us for our nginx configuration.
|
|
|
|
Get an SSL certificate and encrypt it for the realtime video.
|
|
|
|
#### And finally
|
|
|
|
passenger-config restart-app /home/metamaps/metamaps
|
|
|
|
If this command fails, it may be helpful for debugging to run a test
|
|
server to see what problems show up:
|
|
|
|
RAILS_ENV=production rails server
|
|
|
|
#### Realtime server:
|
|
|
|
sudo npm install -g forever
|
|
(crontab -u metamaps -l 2>/dev/null; echo "@reboot env NODE_REALTIME_PORT=5000 $(which forever) --append -l /home/metamaps/logs/forever.realtime.log start /home/metamaps/metamaps/realtime/realtime-server.js") | crontab -u metamaps -
|
|
|
|
mkdir -p /home/metamaps/logs
|
|
env NODE_REALTIME_PORT=5000 forever --append \
|
|
-c /home/metamaps/metamaps/node_modules/.bin/babel-node \
|
|
-l /home/metamaps/logs/forever.realtime.log \
|
|
start /home/metamaps/metamaps/realtime/realtime-server.js
|
|
|
|
#### Upstart service for delayed_worker:
|
|
|
|
If your system uses upstart for init scripts, put the following code into `/etc/init/metamaps_delayed_job.conf`:
|
|
|
|
description "Delayed Jobs Worker for Metamaps"
|
|
|
|
start on runlevel [2345]
|
|
stop on runlevel [!2345]
|
|
|
|
setuid metamaps
|
|
setgid metamaps
|
|
chdir /home/metamaps/metamaps
|
|
|
|
env HOME=/home/metamaps
|
|
env PATH="/usr/local/rvm/gems/ruby-2.3.0@metamaps/bin:/usr/local/rvm/gems/ruby-2.3.0@global/bin:/usr/local/rvm/rubies/ruby-2.3.0/bin:/usr/local/rvm/bin:/usr/local/bin:/usr/bin:/bin"
|
|
env GEM_PATH="/usr/local/rvm/gems/ruby-2.3.0@metamaps:/usr/local/rvm/gems/ruby-2.3.0@global"
|
|
env RAILS_ENV="production"
|
|
|
|
respawn
|
|
respawn limit 3 30
|
|
|
|
exec bundle exec rails jobs:work
|
|
|
|
Then start the service and check the last ten lines of the log file to make sure it's running OK:
|
|
|
|
sudo service metamaps_delayed_job start
|
|
tail /var/log/upstart/metamaps_delayed_job.log
|
|
|
|
#### Systemd service for delayed_worker:
|
|
|
|
If your system uses systemd for init scripts, ptu the following code into `/etc/systemd/system/metamaps_delayed_job.service`:
|
|
|
|
[Unit]
|
|
Description=metamaps delayed job service
|
|
After=network-online.target
|
|
|
|
[Service]
|
|
ExecStart=/usr/local/rvm/gems/ruby-2.3.0@metamaps/bin/bundle exec rails jobs:work
|
|
WorkingDirectory=/home/metamaps/metamaps
|
|
Restart=always
|
|
User=metamaps
|
|
Group=metamaps
|
|
Environment=HOME=/home/metamaps
|
|
Environment=PATH="/usr/local/rvm/gems/ruby-2.3.0@metamaps/bin:/usr/local/rvm/gems/ruby-2.3.0@global/bin:/usr/local/rvm/rubies/ruby-2.3.0/bin:/usr/local/rvm/bin:/usr/local/bin:/usr/bin:/bin"
|
|
Environment=GEM_PATH="/usr/local/rvm/gems/ruby-2.3.0@metamaps:/usr/local/rvm/gems/ruby-2.3.0@global"
|
|
Environment=RAILS_ENV="production"
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
|
|
Then start the service and check the last ten lines of the log file to make sure it's running OK:
|
|
|
|
sudo systemctl start metamaps_delayed_job
|
|
# ??? how the heck do you check systemd logs??
|