More than 5 years have passed since last update.

CentOSにLMS(学習管理システム)のCanvasをインストールする(Development Ver)

Last updated at 2018-10-06Posted at 2015-07-29

Vagrant上のCentOS7.1にCanvasをインストールする手順を以下に記載します.
ここでは公式手順のQuick-Startをベースにし、商用運用するための手順は別途書く予定です

参考) 公式手順

前提

CentOSはMac上にVagrantでsetupしたものを利用しています.
Vagrant自体はsetup済みとして話を進めていきます

またcanvasはrails上で動くのでruby、及びcssのcompileにnodeを使っています。
それぞれanyenvを利用してsetupするので、以下を参照にしてanyenvをcentosOSにinstallして下さい.
anyenvで開発環境を整える

Version

Centos7.1
使ったVagrantfileはこれ
anyenv
ruby 2.2.1
node v0.12.7

install概要

vagrantでcentos7setup

centOS setup
firewalldの設定をいじる

事前作業

PostgreSQLインストール
redisインストール(必須ではない)

canvasインストール

nokogiriのコンパイルエラー対応
bundle/npm install

canvas環境設定
データベースセットップ
起動

CentOS7 setup

$ cd ~/vagrant
$ mkdir canvas
$ cd canvas

これをVagrantfileとしてcanvasフォルダにコピー

起動とログイン

$ vagrant up
# ssh canvasでお手軽にログインできるように、ssh_configをupdate
$ vagrant ssh-config --host canvas >> ~/.ssh/config
$ ssh canvas

後は環境に合わせてOSを色々変更する.
やったのは以下

ユーザーはcanvasにして、デフォルトのvagrantユーザーは消す
https://github.com/kegamin/dotfiles/blob/master/script/make_user.sh
/home/vagrant/.ssh/authorized_keysをcanvasユーザにコピーし、vagrantは削除
削除後、mac側の./ssh/configのユーザ部分をvagrantからcanvasに
LANGを日本語に
https://github.com/kegamin/dotfiles/blob/master/script/set_jp_lang.sh
yumのrepositoryを色々追加
https://github.com/kegamin/dotfiles/blob/master/script/add_yum_repositories.sh

anyenvを入れて、ndenv/rbenvを使ってnodeとrubyを入れる

$ rbenv install 2.1.6
$ rbenv global 2.1.6
$ rbenv rehash
$ ndenv install v0.12.7
$ ndenv global v0.12.7
$ ndenv rehash

firewalldの設定追加

初期設定でcanvasは3000ポートで起動するので、firewalldで穴あけをしておく.
(macから http://192.168.33.10:3000 のような形でアクセスしたいので)

$ sudo firewall-cmd --permanent --add-port=3000/tcp
$ sudo firewall-cmd --reload
$ firewall-cmd --list-all
public (default, active)
  interfaces: enp0s3 enp0s8
  sources:
  services: dhcpv6-client ssh
  ports: 3000/tcp
  masquerade: no
  forward-ports:
  icmp-blocks:
  rich rules:

canvas事前作業

postgresインストール

MySQLも利用できそうだけど、とりあえずQuick-Startの手順をベースにPostgreSQLをインストール

$ sudo yum install -y postgresql-server postgresql-devel
$ sudo mkdir -p /var/lib/pgsql/data
$ sudo chown postgres:postgres /var/lib/pgsql/data
# ユーザーをpostgresに切り替え
$ sudo -i -u postgres
$ initdb  -D '/var/lib/pgsql/data'
$ exit

PostgreSQL起動と確認

$ sudo systemctl start postgresql.service
# 動作確認 activeになっていればOK
$ sudo systemctl status postgresql.service
postgresql.service - PostgreSQL database server
   Loaded: loaded (/usr/lib/systemd/system/postgresql.service; disabled)
   Active: active (running) since 火 2015-07-28 11:26:16 JST; 23h ago

redisのインストール

必須では無いが、cacheサーバとして合ったほうが早いのでインストールしておく.
今回商用ベースではないので、設定はデフォルトのまま進む

$ sudo yum -y install redis
$ sudo systemctl start redis.service
# 起動しているか確認
$ sudo systemctl status redis.server
$ redis-cli ping
PONG -> PONGが返ってくればOK

canvasのインストール

canvasのソースを取得

事前準備ができたら、canvasのソースを取得してインストールする

$ cd $HOME
$ git clone https://github.com/instructure/canvas-lms.git canvas
$ cd canvas
$ git branch --set-upstream-to origin/stable

nokogiriがうまく入らない問題対応

このまま公式手順通りに行くと、bundle installのnokogiriインストール時につまります.
以下のコマンドを参考に、Gemfileを編集した後、次のbundle installを行う.

参考）nokogiri インストール時のエラー Running ‘patch’ for libxml2 2.8.0… ERROR

# nokogiriに必要なpackageをyumでインストールしておく
$ sudo yum install -y libxml2-devel libxslt-devel
$ vi Gemfile

# 以下のようになるよう、ENV['NOKOGIRI_USE_SYSTEM_LIBRRIES']を追加する.

$ git diff
diff --git a/Gemfile b/Gemfile
index 6480fbe..3802bc9 100644
--- a/Gemfile
+++ b/Gemfile
@@ -12,8 +12,9 @@
 # these gems to prevent regression, and the indentation serves to alert us to the relationship betw
 source 'https://rubygems.org/'
 
+ENV['NOKOGIRI_USE_SYSTEM_LIBRARIES'] = 'YES'
 require File.expand_path("../config/canvas_rails4", __FILE__)
 
 Dir.glob(File.join(File.dirname(__FILE__), 'Gemfile.d', '*.rb')).sort.each do |file|
   eval_gemfile(file)

bundle install

canvasに必要なrubyのpackageをbundleを使ってインストール.

# bundlerのバージョンは指定されているので合わせる
$ gem install bundler -v 1.10.3
# 今回mysqlは使わないのでinstallから外す
$ bundle install --without mysql sqlite

npm install

同じくcanvasに必要なnodeのpackageをnpmを使ってインストール

$ npm install
$ npm install coffee-script@1.6.2

環境設定

canvasのconfig類をexampleをベースに書き換えていく

今回利用するconfig一覧

config	概要
database.yml	使用するデータベース/データベース名等を定義
delayed_jobs.yml	backgroundで実行するｗorkerの数等を定義
domain.yml	canvasのドメイン名を定義
file_store.yml	ファイルの保存先. amazon s3にも可能
outgoing_mail.yml	送信元となるsmtpサーバを定義
security.yml	暗号鍵定義。（どこで使う？
external_migration.yml	移行時にfaileを一時的に置く場所を定義
cache_store.yml	canvasで使用するcacheサーバを定義
redis.yml	cacheでredisを使う場合に定義

configの設定

基本今回は上記ファイルを使うが、exampleがconfigに色々あって邪魔なので、一旦exmpleは退避させておく

$ cd canvas/config/
$ mkdir example
$ mv *.example example/

設定するファイルだけ、config配下にコピーして変更していく

$ for config in database delayed_jobs domain file_store outgoing_mail outgoing_mail security external_migration cache_store redis;
do cp -v config/example/$config.yml.example config/$config.yml; done

変更点した点は以下のとおり

database.yml
developmentなので、今回はそのまま.商用だとpasswdとか変更要
delayed_jobs.yml
これも特に今回は変更無し.商用だとメモリ等状況に従ってworker数などを変更する
domain.yml
domainがlocalhostになっていて、macからアクセスすると色々面倒なので、ここは修正する
```
# vagrantの起動設定に合わせてIPアドレスを設定
development: 
    domain: "192.168.33.10:3000"
```
file_store.yml
保存先はtmpで問題ないのでそのまま.

outgoing_mail.yml
gmailだったら以下のように修正

development:
  address: "smtp.gmail.com"
  port: "587"
  user_name: "you@gmail.com"
  password: "gmail-password"
  authentication: "plain" # plain, login, or cram_md5
  domain: "gmail.com"
  outgoing_address: "you@gmail.com"
  default_name: "Your Name"
  tls: true

security.yml
とりあえず今回はイジらない
external_migration.yml
migrationは今回無視するので変更無し
cache_store.yml
デフォルトだとdevelopmentのcacheはコメントアウトされているので、以下のようにコメントアウトを外しておく
```
development:
  cache_store: redis_store
```
redis.yml
developmentの設定は無いので、以下を最下行に追加する.
```
development:
    servers:
      - redis://localhost
```

補足

おこのみで以下の設定をしても良い。性能は上がるが、設定変更時に再起動が必要になりそうなので要注意.

$ echo -n 'config.cache_classes = true
config.action_controller.perform_caching = true
config.action_view.cache_template_loading = true
' > config/environments/development-local.rb

データベースセットアップ

データベースを作成する

$ sudo -u postgres createuser canvas --no-createdb --no-superuser --no-createrole --pwprompt
$ sudo -u postgres createdb canvas_development --owner=canvas
$ sudo -u postgres createdb canvas_queue_development --owner=canvas

データベースのイニシャライズ

rake db:initial_setupを実行してDBの初期化を行う.
途中で初期ユーザー名（email)とパスワードを聞かれるので設定していく.
また最後に利用データを採取してよいかと聞かれるので、嫌だったら３にする

$ bundle exec rake db:initial_setup
What email address will the site administrator account use? > hogehoge@fuga.com
Please confirm > hogefuga@fuga.com
What password will the site administrator use? > *******
Please confirm > *******
What do you want users to see as the account name? This should probably be the name of your organization. > fugafuga

To help our developers better serve you, Instructure would like to collect some usage data about your Canvas installation. You can change this setting at any time.:
1. Opt in
2. Only send anonymized data
3. Opt out completely
>3
You have opted out.
(中略)
Initial data loaded

File Generation

最後に、各種ファイル等のコンパイルを実施

$ bundle exec rake canvas:compile_assets

起動

以下のコマンドを実行してサーバを起動する。

$ bundle exec rails server

Vagrantfileの設定しだいですが、後は以下のようなURLをブラウザでアクセスすれば完了.

##ハマった所

firewalld
cent7で入ったfirewalldの仕組みがわからなかった…

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up