ThothLink - インストールガイド

オープンソース・ソリューション・テクノロジ (株)更新日2017 年 7 月 10 日

目次
12

はじめに

1.1

本書の目的. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2

1.2

前提条件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2システム要件32.1

ソフトウェア要件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

32.2

ハードウェア要件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

32.3

対応ブラウザ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

32.4

パッケージ構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3

インストールと基本設定

53.1

トートリンク・パッケージのインストール . . . . . . . . . . . . . . . . . . . .

53.2

トートリンクの基本設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

53.3

トートリンクの起動. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5234

高度な設定

64.1

HTTPS 設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

64.2

HA(高可用性) 構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

65

詳細設定項目

86ログ設定107ライセンス111

1 はじめに
1.1 本書の目的
本文書は、弊社提供のトートリンクソフトウェアパッケージのインストールと初期設定を実施するための手順書です。トートリンクのインストールやアップデートの際には、必ず本文書の内容を確認してから作業を実施してください。
本文書に関する記載内容について疑問点等がある場合には、弊社サポート窓口までお問い合わせください。

1.2 前提条件
本書は、特に指示がない限り、以下のような条件を前提に記述しています。これと異なる場合は、適宜内容を読み替えるか、必要な作業を別途実施してください。

• 作業者が OS と関連ソフトウェアの管理や操作手順についての一般的な知識を有すること。

• OS と関連ソフトウェアの基本設定が適切になされていること。
• 管理ユーザー root のシェル端末で作業すること。(作業ユーザーを指定している場合を除く)• OSSTech 製品パッケージファイル群をインストール対象 OS 環境の/opt/osstech/tmpディレクトリ以下にコピーしておくこと。

• ネットワーク内で対象となるファイルサーバー (CIFS サーバー) が動作している事。

2

2 システム要件
2.1 ソフトウェア要件• RedHat Enterprise Linux 7 (x86_64)• CentOS 7 (x86_64)• RedHat Enterprise Linux 6 (x86_64)• CentOS 6 (x86_64)

2.2 ハードウェア要件• メモリ:1GB 以上• ディスク– インストール領域: /opt/osstech 1GB 以上– キャッシュ領域: 1GB 以上 (アップロードするファイルサイズに依存)

2.3 対応ブラウザ
対応ブラウザ一覧は ThothLink ユーザーマニュアルを参照して下さい。

2.4 パッケージ構成
2.4.1 製品パッケージ
トートリンクと関連パッケージのファイル名一覧は以下の通りです。
ファイル名のうち、「OS」には OS の略称とメジャーバージョン番号、「arch」にはアーキテクチャ名が入ります。CentOS のパッケージは RHEL と共通です。

• OSSTech ソフトウェア製品基本パッケージ– osstech-base-3.1-x.OS.arch.rpm• OSSTech Samba パッケージ– osstech-libiconv-1.10-r.OS.arch.rpm– osstech-samba-common-4.5.x-r.OS.arch.rpm– osstech-samba4.5-libs-4.5.x-r.OS.arch.rpm
3• OSSTech Python パッケージ– osstech-python34-3.4.6-r.OS.arch.rpm– osstech-python34-mod_wsgi-4.3.0-r.OS.arch.rpm• OSSTech ThothLink パッケージ– osstech-thothlink-2.1-r.OS.arch.rpm– osstech-thothlink-semodule-2.1-r.OS.arch.rpm

4

3 インストールと基本設定
3.1 トートリンク・パッケージのインストール
付属の install.sh を実行して RPM パッケージ一式をインストールします。

3.1.1 インストール手順# tar xf thothlink-2.1-r.tar.gz# cd thothlink-2.1-r# ./install.sh

3.1.2 ThothLink 1.0 からのアップデート方法
ThothLink 1.0 から 2.1 へのアップデートは幾つかのファイルが競合するため、そのままアップデートできません。ThothLink 1.0 の付属パッケージを一度削除し、改めて 2.1 をインストールしてください。

# rpm -e osstech-mod_wsgi osstech-thothlink# ./install.sh

3.2 トートリンクの基本設定/opt/osstech/etc/thothlink/thothlink.py をテキストエディタで開き、以下の様にCIFS サーバー (Samba) の NetBIOS 名もしくは FQDN を指定します。
SERVERS = [ ' サーバー名' ]3.3 トートリンクの起動設定が完了したら WEB サーバーを再起動します。

# service httpd restart

WEB ブラウザで http://ホスト名/ にアクセスし、動作確認を行って下さい。
5

4 高度な設定
4.1 HTTPS 設定
トートリンクはデフォルトで HTTP プロトコル (80 番ポート) で動作します。

HTTPS で動作させる場合は、HTTPS のディレクティブに以下の設定を追加して下さい。
(RHEL の場合、/etc/httpd/conf.d/ssl.conf)<VirtualHost _default_:443>(略)Include /opt/osstech/etc/thothlink/httpd.conf</VirtualHost>
同時に /etc/httpd/conf.d/thothlink.conf の Include 文をコメント化します。

<VirtualHost *:80>(略)# Include /opt/osstech/etc/thothlink/httpd.conf</VirtualHost>
最後に WEB サーバーを再起動します。

# service httpd restart

WEB ブラウザで https://ホスト名/ にアクセスし、動作確認を行って下さい。

4.2 HA(高可用性) 構成
トートリンクは負荷分散機などを利用して可用性を高める事ができます。この際 2 台以上のサーバーでログインセッションを共有する為にセッションサーバーの導入が必要となります。
以下の手順でセッションサーバーの導入とトートリンクの設定を行って下さい。

1. セッションサーバー (memecached) のインストールと起動

6

# yum install memcached# chkconfig memcached on# service memcached start

2. ThothLink の設定 /opt/osstech/etc/thothlink/thothlink.py に以下を追記
SESSION_STORE = {'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache','LOCATION': '127.0.0.1:11211',}
複数のセッションサーバーに分散する場合は以下の様に設定します。

SESSION_STORE = {'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache','LOCATION': ['1 台目の IP アドレス:11211','2 台目の IP アドレス:11211',]}
3. ThothLink の再起動
# service httpd restart7

5 詳細設定項目
トートリンクの設定は /opt/osstech/etc/thothlink/thothlink.py に行います。設定ファイルの編集
後 WEB サーバーの再起動が必要です。

5.0.1 SERVERSCIFS サーバー (Samba) の NetBios 名を指定します。
例)

SERVERS = [ ' サーバー名' ]複数指定することも可能です。
例)

SERVERS = [ ' サーバー 1', ' サーバー 2' ]5.0.2 DEBUG
問題調査時に使用します、デフォルトで False です。
例)

DEBUG = True

5.0.3 JS_DEBUG
JavaScript の問題調査時に使用します、デフォルトで False です。
例)

JS_DEBUG = True

5.0.4 TOP_REDIRECT
トップページにアクセスした際、特定のサーバーのログイン画面へリダイレクトを行います。対象の CIFS サーバーが一つしかない場合に使用します。デフォルトは無効です。
例)8

TOP_REDIRECT = '/link/サーバー名'

5.0.5 DOMAIN
設定項目 DOMAIN は廃止となりました。替りに DOMAINS を利用してください

5.0.6 DOMAINS
利用するドメインのリストを指定します。
例)

DOMAINS = [' ドメイン 1', ' ドメイン 2']と設定すると、利用可能なドメインのプルダウンが表示されます。
既定では先頭の「ドメイン 1」で認証を行います。また、従来通りログイン時に「ユーザー名\任意のドメイン」と指定したい場合、DOMAINS = ['', ' ドメイン 1', ' ドメイン 2']という様に空文字を指定することもできます。

5.0.7 JS_TIMEOUT
ブラウザと ThothLink の通信タイムアウト時間を設定します。規定値は 15000 ミリ秒です。
タイムアウト値を 20 秒に変更する場合以下のように設定します。
例)

JS_TIMEOUT = 20000

5.0.8 COOKIE_SECURE
Cookie に secure 属性を付与します。これにより、http 通信時に Cookie が送出されなくなります。既定では False です。
例)

COOKIE_SECURE = True

96 ログ設定
ThothLink のアクセスログは Apache HTTP Server のログとして記録されます。標準では/var/log/httpd/access_log、HTTPS を利用している場合は/var/log/httpd/ssl_access_logに出力されます。
アクセスログに認証済みユーザ名を記録する場合は Apache HTTP Server の設定ファイル(/etc/httpd/conf/httpd.conf) を以下のように編集します。
LogFormat "%h %l %u %t \"%r\" %>s %b %{X-USERNAME}o" common
CustomLog logs/access_log common
httpd.conf の設定変更後は httpd の再起動が必要となります。
# service httpd restart10

7 ライセンス
トートリンクは GNU 一般公衆利用許諾契約書 (バージョン 2 以降) に基づいてリリースされています。GPL ライセンスの正式な条件については、http://www.fsf.org/licenses/ を参照してください。
トートリンクは以下のアイコンを使用しています。

• Crystal Clear– http://www.everaldo.com/crystal/• Farm-Fresh Web Icons– http://www.fatcow.com/free-icons/

11