installdocs: Update with screenshots & more
* add screenshots from Ubuntu config process * add instructions for updating predeployed VMs * add details on configuring mail server * don't install test gems into prod * no need for bundle exec * small cleanups
This commit is contained in:
parent
73d6014d10
commit
fa965b5f92
|
@ -2,15 +2,37 @@
|
||||||
|
|
||||||
## Install Ubuntu 12.04 with the package groups:
|
## Install Ubuntu 12.04 with the package groups:
|
||||||
|
|
||||||
|
![screenshot of package group selection screen](https://raw.github.com/discourse/discourse-docimages/master/install/ubuntu%20-%20install%20-%20software%20selection.png)
|
||||||
|
|
||||||
* Basic ubuntu server
|
* Basic ubuntu server
|
||||||
* OpenSSH server
|
* OpenSSH server
|
||||||
* Mail server
|
* Mail server
|
||||||
* PostgreSQL database (9.1+)
|
* PostgreSQL database (9.1+)
|
||||||
|
|
||||||
|
You may be working on an already-installed or automatically deployed system, in which case you can install them afterwards:
|
||||||
|
|
||||||
|
# Run these commands as your normal login (e.g. "michael")
|
||||||
|
sudo apt-get update && sudo apt-get -y upgrade
|
||||||
|
sudo tasksel install openssh-server
|
||||||
|
sudo tasksel install mail-server
|
||||||
|
sudo tasksel install postgresql-server
|
||||||
|
|
||||||
### Configure the mail server:
|
### Configure the mail server:
|
||||||
|
|
||||||
|
![screenshot of mail server type configuration screen](https://raw.github.com/discourse/discourse-docimages/master/install/ubuntu%20-%20install%20-%20mail_1%20system%20type.png)
|
||||||
|
|
||||||
In our example setup, we're going to configure as a 'Satellite system', forwarding all mail to our egress servers for delivery. You'll probably want to do that unless you're handling mail on the same machine as the Discourse software.
|
In our example setup, we're going to configure as a 'Satellite system', forwarding all mail to our egress servers for delivery. You'll probably want to do that unless you're handling mail on the same machine as the Discourse software.
|
||||||
|
|
||||||
|
![screenshot of mail name configuration screen](https://raw.github.com/discourse/discourse-docimages/master/install/ubuntu%20-%20install%20-%20mail_2%20mailname.png)
|
||||||
|
|
||||||
|
You probably want to configure your 'mail name' to be the base name of your domain. Note that this does not affect any email sent out by Discourse itself, just unqualified mail generated by systems programs.
|
||||||
|
|
||||||
|
![screenshot of relay host configuration screen](https://raw.github.com/discourse/discourse-docimages/master/install/ubuntu%20-%20install%20-%20mail_3%20relayconfig.png)
|
||||||
|
|
||||||
|
If you have a mail server responsible for handling the egress of email from your network, enter it here. Otherwise, leave it blank.
|
||||||
|
|
||||||
|
## Additional system packages
|
||||||
|
|
||||||
Install necessary packages:
|
Install necessary packages:
|
||||||
|
|
||||||
# Run these commands as your normal login (e.g. "michael")
|
# Run these commands as your normal login (e.g. "michael")
|
||||||
|
@ -139,9 +161,15 @@ Change to the 'discourse' user:
|
||||||
|
|
||||||
Install RVM if doing a single-user RVM installation:
|
Install RVM if doing a single-user RVM installation:
|
||||||
|
|
||||||
|
# As 'discourse'
|
||||||
# Install RVM
|
# Install RVM
|
||||||
\curl -s -S -L https://get.rvm.io | bash -s stable
|
\curl -s -S -L https://get.rvm.io | bash -s stable
|
||||||
. ~/.profile
|
. ~/.bash_profile
|
||||||
|
|
||||||
|
# rvm added shell initialization code to ~/.bash_profile,
|
||||||
|
# move it to ~/.profile instead
|
||||||
|
cat ~/.bash_profile >> ~/.profile
|
||||||
|
rm ~/.bash_profile
|
||||||
|
|
||||||
# Install necessary packages for building ruby
|
# Install necessary packages for building ruby
|
||||||
rvm requirements
|
rvm requirements
|
||||||
|
@ -163,9 +191,9 @@ Continue with discourse installation
|
||||||
git checkout latest-release
|
git checkout latest-release
|
||||||
|
|
||||||
# Install necessary gems
|
# Install necessary gems
|
||||||
bundle install --deployment
|
bundle install --deployment --without test
|
||||||
|
|
||||||
_If you have errors building the native extensions, ensure you have sufficient free system memory. 1GB with no swap won't cut it._
|
_If you have errors building the native extensions, ensure you have sufficient free system memory. 1GB with no swap isn't enough, we recommend having 2GB as a minimum._
|
||||||
|
|
||||||
Configure discourse:
|
Configure discourse:
|
||||||
|
|
||||||
|
@ -209,8 +237,8 @@ Initialize the database:
|
||||||
# Run these commands as the discourse user
|
# Run these commands as the discourse user
|
||||||
# The database name here should match the production one in database.yml
|
# The database name here should match the production one in database.yml
|
||||||
createdb discourse_prod
|
createdb discourse_prod
|
||||||
RUBY_GC_MALLOC_LIMIT=900000000 RAILS_ENV=production bundle exec rake db:migrate
|
RUBY_GC_MALLOC_LIMIT=900000000 RAILS_ENV=production rake db:migrate
|
||||||
RUBY_GC_MALLOC_LIMIT=900000000 RAILS_ENV=production bundle exec rake assets:precompile
|
RUBY_GC_MALLOC_LIMIT=900000000 RAILS_ENV=production rake assets:precompile
|
||||||
|
|
||||||
## nginx setup
|
## nginx setup
|
||||||
|
|
||||||
|
@ -229,7 +257,7 @@ Configure bluepill:
|
||||||
|
|
||||||
# Run these commands as the discourse user
|
# Run these commands as the discourse user
|
||||||
gem install bluepill
|
gem install bluepill
|
||||||
echo 'alias bluepill="bluepill --no-privileged -c ~/.bluepill"' >> ~/.bash_aliases
|
echo 'alias bluepill="NOEXEC_DISABLE=1 bluepill --no-privileged -c ~/.bluepill"' >> ~/.bash_aliases
|
||||||
rvm wrapper $(rvm current) bootup bluepill
|
rvm wrapper $(rvm current) bootup bluepill
|
||||||
rvm wrapper $(rvm current) bootup bundle
|
rvm wrapper $(rvm current) bootup bundle
|
||||||
|
|
||||||
|
@ -254,14 +282,13 @@ Congratulations! You've got Discourse installed and running!
|
||||||
# Run these commands as the discourse user
|
# Run these commands as the discourse user
|
||||||
bluepill stop
|
bluepill stop
|
||||||
# Pull down the latest release
|
# Pull down the latest release
|
||||||
cd discourse
|
cd ~/discourse
|
||||||
git checkout master
|
git checkout master
|
||||||
git pull
|
git pull
|
||||||
git fetch --tags
|
git fetch --tags
|
||||||
# To run on the latest version instead of bleeding-edge:
|
# To run on the latest version instead of bleeding-edge:
|
||||||
#git checkout latest-release
|
#git checkout latest-release
|
||||||
bundle install --deployment
|
bundle install --without test --deployment
|
||||||
RUBY_GC_MALLOC_LIMIT=900000000 RAILS_ENV=production bundle exec rake db:migrate
|
RUBY_GC_MALLOC_LIMIT=900000000 RAILS_ENV=production rake db:migrate
|
||||||
RUBY_GC_MALLOC_LIMIT=900000000 RAILS_ENV=production bundle exec rake assets:precompile
|
RUBY_GC_MALLOC_LIMIT=900000000 RAILS_ENV=production rake assets:precompile
|
||||||
cd
|
|
||||||
bluepill start
|
bluepill start
|
||||||
|
|
Loading…
Reference in New Issue