Microsoft Word - websdmss-administrators_manual.doc

Transcription

1 ウェブ空間文書管理共有システム 管理者マニュアル 版 2012/12/27 株式会社ピコラボ

2 変更履歴 版 日付 内容 /12/27 構成を NetCommons の管理者マニュアルに合わせる タイトルを 導入手順書 から 管理者マニュアル に変更 現状に合わせてバージョンを変更 CentOS6.3 での導入手順を追記 使用する Java を 1.7 に変更 軽微な文言の修正 /8/31 Twitter モジュール非対応に伴って関連する記述を削除 php53-imap のインストール手順を追記 gcc のインストール手順を追記 mysqld と httpd のサービスへの登録手順を追記 JodConverter のダウンロード & インストール手順を削除 ( 配布パッケージに含むため ) GoeNLP の URL 等の設定手順を追記 操作説明に関する記述を削除( 運用マニュアルに転記 ) WebSDMSS ソースツリーの展開 を修正 画像を PNG 形式に変更 /02/29 OpenOffice.org のサービス起動方法を記載 Twitter ログ収集スクリプトの導入 を追加 Twitter ログ収集スクリプトの導入に伴って WebSDMSS のインストール を修正 Twitter の項目を追加 /02/03 軽微な文言の修正 /09/ wvware の項目を削除 JODConverter の利用に関する制限 の項目を削除 /01/28 機能拡張 /11/10 初版

3 目次 1. WEBSDMSS とは WEBSDMSS のインストール WEBSDMSS をインストールする前に必ずお読みください インストールしやすい組み合わせ NETCOMMONS を使用するには PHP のインストール MySQL のインストールのインストールとサービスの起動 Apache のインストールとサービスの起動 Java SDK(JDK) のインストール soffice のインストールとサービスの起動 インストール方法 サーバ環境の確認 新規インストールの前準備 新規インストール手順 ライセンス表示 フリーソフト利用のためのライセンス JODConverter NETCOMMONS2.0 利用にかかるライセンス i -

4 管理者マニュアル WebSDMSS とは 1. WebSDMSS とは WebSDMSS とは オープンソースの CMS NetCommons2.3 [1] に機能拡張を行い 利用者が投稿したりアップロードしたファイルやドキュメントに含まれる自然言語文章から 文中に含まれる 場所 を表す文字列を抽出するジオパース機能を追加したウェブアプリケーションです 図 1 WebSDMSS の構成 ( 白色はオープンソースオープンソース 黄色黄色が今回今回開発開発したした部分 ) 本書では WebSDMSS の導入手順を解説します ただし WebSDMSS は NetCommons2 を拡張したシステムの為 その導入手順は NetCommons2 のそれと同様です 必要に応じて NetCommons2 のオンライン管理者マニュアル を参照してください 尚 一般的なサーバ管理に関する以下については基本的に取り扱いません ネットワーク環境設定 Unix ユーザ管理 1 NetCommons2.0 は FreeBSD ライセンスで提供されます 詳細は巻末のライセンス表 示をご確認ください - 1 -

5 管理者マニュアル WebSDMSS とは 本システムは一般的な UNIX システム上であれば動作するよう設計してあり 導入手順は CentOS6.3 を例に説明します ただし OS が異なる場合や Linux のディストリビューション バージョンが異なる場合は 必ずしも本書の通りの手順では導入できない場合があります 環境に応じて 適宜 読み替えてインストールするようにしてください また 本書では 入力するコマンドや結果出力の例を示す場合 水色のボックスで囲んで説明文と区別します 一般ユーザとして実行する場合には以下のように示します $ echo Hello world! Hello world! $ 先頭の $ はプロンプトなので入力する必要はありません 太字の部分が実際に入力するコマンドです プロンプトを含むその他の文字は 応答として表示される内容を示します 特に必要がない場合には 説明が冗長になるのを避けるため 応答内容を省略することもあります 同様に root 権限で実行する必要がある場合には プロンプトを # で表します # /etc/init.d/httpd status httpd (pid 2749) is running... # - 2 -

6 2. WebSDMSS のインストール 2.1. WebSDMSS をインストールする前に必ずお読みください インストールしやすい組み合わせ WebSDMSS は次の環境で動作します PHP5.1.6 以降 MySQL5.0 以降 Apache1.3 もしくは 2 以降 特に以下の組み合わせをお勧めしていています PHP5.3.3 MySQL5.1.66, Apache OS は CentOS 5 をお勧めしています CentOS6.3 では動作確認済みです 2.2. NetCommons を使用するには WebSDMSS を実際に使用するにはまず Apache MySQL PHP JAVA soffice が既にインストールされたサーバが必要です サーバにこれらのソフトウェアがインストールされていることをご確認ください インストールされていない場合は 以下の手順を参考にインストールするようにしてください PHP のインストール PHP は公式のパッケージをそのまま利用します php53-imap は OS や OS のバージョンによって (CentOS 6.x など ) は php-imap をインストールする必要があるので注意してください # yum install -y php php-mbstring php-xml php-pear pear php-mysql php53-imap インストールが完了したら使用するタイムゾーンの設定を行います 設定の変更は /etc/php.ini を編集するのが一般的ですが CentOS の場合には /etc/php.d/*.ini を読み込むように設定されているため /etc/php.d/websdmss.ini に以下の内容を書き込みます # vi /etc/php.d/ php.d/websdmss websdmss.ini date.timezone = Asia/Tokyo; PHP のバージョンが 5.2 より古い場合 JSON extension をインストールする必要があります php のバージョンを調べるには version オプションをつけて php を実行します $ php --version PHP (cli) (built: Jul :53:21) Copyright (c) The PHP Group Zend Engine v2.3.0, Copyright (c) Zend Technologies - 3 -

7 必要な場合は 以下の手順で JSON extension をインストールし php の設定を変更します # yum install -y php-devel php-pecl pecl gcc # pecl install json # vi /etc/php.d/websdmss websdmss.ini ; Enable json extension module extension=json.so さらに WebSDMSS の日誌 (g) モジュールに搭載されている一括登録機能を快適に利用するため websdmss.ini に以下の設定を行います # vi /etc/php.d/websdmss.ini max_execution_time = 30 -> 0 upload_max_filesize = 20M します 一括登録では 3M 以上に設定することをお勧め MySQL のインストールのインストールとサービスの起動 MySQL は公式のパッケージをそのまま利用します 特に追加設定などは必要ありません # yum install -y mysql-server server # /sbin/chkconfig mysqld on # /etc/rc.d/init.d/mysqld start Apache のインストールとサービスの起動 (1) Apache のインストール Apache は公式のパッケージをそのまま利用します OS によっては 最初から httpd パッケージがインストール済みの場合もあります # yum install -y httpd (2) PHP モジュールの設定 Apache から php スクリプトを実行するには httpd.conf の修正が必要です ただし CentOS の httpd パッケージでは http.conf 内に /etc/http/conf.d/ 以下の設定ファイルを動的に読み込むように書かれているため このディレクトリ以下に設定ファイルを追加していきます また php を使うための設定は php パッケージをインストールすると自動的に /etc/httpd/conf.d/php.conf として作成されますので 特に作業の必要はありません (3) SELinux およびファイアウォールの設定外部から web サーバへアクセスできるようにするため SELinux とファイアウォールの設定を行ってください CentOS6 で SELinux の設定を Permissive にするには以下のコマンドを実行します # setenforce 0-4 -

8 # vi /etc/sysconfig/selinux inux SELINUX=permissive ファイアウォールの設定を変更するためのコマンドをインストールして実行します コマンドを実行したらファイアウォール有効のまま カスタマイズから WWW(HTTP) にチェックを入れて許可するように設定してください # yum install -y system-config config-firewall firewall-tui # system-config config-firewall firewall-tui CentOS5 では SELinux とファイアウォールの設定をまとめて変更できます 以下のコマンドを実行して SELinux の設定を Permissive に ファイアウォールは WWW(HTTP) を許可するように設定してください # system-config config-securitylevel securitylevel-tui tui (4) Apache の起動以下のコマンドを実行して Apache がサーバの起動時に自動起動するように設定したうえで Apache を起動してください # /sbin/chkconfig httpd on # /etc/init.d/httpd start (5) PHP スクリプトの動作テスト Apache が php スクリプトを実行できていることを確認するため /var/www/html/test.php に以下のようなテストスクリプトを作成します # vi /var/www/html/test.php <?php phpinfo();?> ウェブブラウザから ウェブサーバ名 ]/test.php へアクセスし 図 2 のような画面が表示されれば Apache と PHP の設定は問題ありません 画面をスクロールして PHP のバージョンや mbstring, pdo_mysql, imap などが表示されていることも確認してください 確認ができたら test.php は削除してください # rm /var/www/html/test.php - 5 -

9 図 2 test.php の出力画面 Java SDK(JDK) のインストール JDK は公式のパッケージをそのまま利用します # yum install java openjdk soffice のインストールとサービスの起動 OpenOffice.org は公式のパッケージを利用しますが GUI を表示せずにサーバとして利用するために headless モジュールを追加してインストールする必要があります CentOS の場合は公式リポジトリにパッケージが登録されていますので 以下のコマンドで自動インストールしてください # yum install openoffice.org office.org-langpack langpack-ja_jp openoffice.org-writer openoffic e.org-calc openoffice.org-draw openoffice.org-impress impress openoffice.org-headles eadles s - 6 -

10 RedHat の場合は公式リポジトリにパッケージが登録されていませんので まず RPM アーカイブを OpenOffice.org のサイトからダウンロードし 展開 インストールをマニュアルで行います # wget toyama.ac.jp/archives/misc/openoffice/localized/ja/3.3. 0/OOo_3.3.0_Linux_x86-64_install 64_install-rpm rpm-wjre_ja.tar.gz :28: /localized/ja/3.3.0/ooo_3.3.0_linux_x86-64_install-rpm-wjre_ja.tar.gz ring.u-toyama.ac.jp を DNS に問いあわせています ring.u-toyama.ac.jp :80 に接続しています... 接続しました HTTP による接続要求を送信しました 応答を待っています OK 長さ : (181M) [application/x-gzip] `OOo_3.3.0_Linux_x86-64_install-rpm-wJRE_ja.tar.gz' に保存中 100%[======================================>] 189,915, M/s 時間 63s :29:50 (2.86 MB/s) - `OOo_3.3.0_Linux_x86-64_install-rpm-wJRE_j a.tar.gz' へ保存完了 [ / ] # tar xvfz OOo_3.3.0_Linux_x86-64_install 64_install-rpm rpm-wjre_ja.tar.gz OOO330_m20_native_packed-1_ja.9567/ OOO330_m20_native_packed-1_ja.9567/installdata/ OOO330_m20_native_packed-1_ja.9567/installdata/html/ OOO330_m20_native_packed-1_ja.9567/installdata/html/UninstallationOngoing.ht ml OOO330_m20_native_packed-1_ja.9567/installdata/html/AcceptLicense_ja.html ( 中略 ) OOO330_m20_native_packed-1_ja.9567/licenses/ OOO330_m20_native_packed-1_ja.9567/licenses/LICENSE_ja.html OOO330_m20_native_packed-1_ja.9567/licenses/LICENSE_ja # cd OOO330_m20_native_packed-1_ja.9567/ # rpm -Uvh RPMS/*.rpm インストール後 soffice をサービスとして起動するために以下のスクリプトを /etc/init.d/ooo として配置してください # vi /etc/init.d/ooo #!/bin/bash # openoffice.org headless server script # # chkconfig: # description: headless openoffice server script # processname: openoffice # SOFFICE_PATH=/usr/bin/soffice # 環境に合わせて修正してください PIDFILE=/var/run/openoffice-server.pid # 環境に合わせて修正してください LOG_DIR=/var/log/ooo - 7 -

11 set -e case "$1" in start) if [ -f $PIDFILE ]; then echo "OpenOffice headless server has already started." sleep 5 exit fi echo "Starting OpenOffice headless server" $SOFFICE_PATH -headless -nologo -nofirststartwizard -accept="socket,ho st= ,port=8100;urp" & >> $LOG_DIR/stdout.log 2>> $LOG_DIR/stderr.log touch $PIDFILE ;; stop) if [ -f $PIDFILE ]; then echo "Stopping OpenOffice headless server." killall -9 soffice && killall -9 soffice.bin rm -f $PIDFILE exit fi echo "Openoffice headless server is not running." exit ;; *) echo "Usage: $0 {start stop}" exit 1 esac exit 0 配置したら以下を実行して soffice をサービスに登録して起動します # mkdir /var/log/ooo # chmod +x /etc/init.d/ooo # /sbin/chkconfig --add ooo # /sbin/chkconfig ooo on # /etc/init.d/ooo start 2.3. インストール方法 サーバ環境の確認 WebSDMSS は 通常想定通常想定されるされるサーバサーバ管理技能管理技能およびおよび知識知識をおをお持ちのちのサーバサーバ管理者管理者によ - 8 -

12 って管理管理されるされることを想定して WebSDMSS を配布しております サーバの環境設定を誤ると WebSDMSS に関係なくセキュリティ上の問題が発生する可能性があることは 他のウェブアプリケーションと同様です 多くの CMS と同様に WebSDMSS では htaccess ファイルによるアクセス制限機能を想定しています また http 以外の方法でのアクセスが許可されていないサーバ上に構築されることを想定しています WebSDMSS サイトを構築予定のサーバで 1. htaccess が無効になっている 2. http 以外のアクセス方法を許可している場合 本来外部公開されてはならない情報が公開される可能性がありますので 念のためご確認ください 新規インストールの前準備 まず始めに 以下の点を事前に確認しておいてください ドキュメントルートドキュメントルートとは Web サーバが HTML ファイルを公開するディレクトリへのパスです 必要に応じて以下のように設定してください 1 WebSDMSS をサーバのトップディレクトリとして公開する場合 サーバ名 >/ または サーバ名 >:< ポート番号 >/ でアクセスするサイトとして公開する場合 ディレクトリを virtual host として設定します /etc/httpd/conf.d/websdmss.conf というファイルを作成し 次の内容を書き込みます # vi /etc/httpd/conf.d/websdmss.conf # Settings for WebSDMSS NameVirtualHost *:80 # 公開するポート番号に変更 <VirtualHost *:80> # 公開するポート番号に変更 ServerName websdmss.co.jp # サーバ名に合わせて変更 DocumentRoot "/var/www/websdmss/html/htdocs" DirectoryIndex index.php <Directory "/var/www/websdmss/html/htdocs"> SetEnv LD_LIBRARY_PATH /usr/local/lib:/usr/lib:/lib AllowOverride All Allow from All </Directory> </VirtualHost> websdmss.conf の変更を反映するため Apache を再起動します # /etc/init.d/httpd restart - 9 -

13 2 WebSDMSS をサーバのサブディレクトリとして公開する場合 サーバ名 >/websdmss/ のように サブディレクトリを指定してアクセスするサイトとして公開する場合 ディレクトリを alias として設定します /etc/httpd/conf.d/websdmss.conf というファイルを作成し 次の内容を書き込みます # vi /etc/httpd/conf.d/websdmss.conf # Settings for WebSDMSS Alias /websdmss/ "/var/www/websdmss/html/htdocs/" <Directory "/var/www/websdmss/html/htdocs"> SetEnv LD_LIBRARY_PATH /usr/local/lib:/usr/lib:/lib AllowOverride All Order allow,deny Allow from all </Directory> websdmss.conf の変更を反映するため Apache を再起動します # /etc/init.d/httpd restart MySQl への接続設定 MySQL への接続設定 ( ユーザ名とパスワードとデータベース名 ) を 必要に応じて以下のように設定してください 以下は データベース名は websdmss 管理ユーザは sdmss_user パスワードを sdmss_password の場合の設定例です $ mysql -u root Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 2 Server version: MySQL Community Server (GPL) by Remi Copyright (c) 2000, 2010, Oracle and/or its affiliates. All rights reserved. This software comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to modify and redistribute it under the GPL v2 license Type 'help;' or '\h' for help. Type '\c' to clear the current input statemen t. mysql> CREATE DATABASE websdmss CHARACTER SET utf8 COLLATE utf8_general_ci; Query OK, 1 row affected (0.01 sec) mysql> GRANT ALL ON websdmss.* TO sdmss_user@localhost IDENTIFIED BY 'sdmss_ password'; Query OK, 0 rows affected (0.06 sec) mysql> quit Bye

14 CREATE DATABASE の際に CHARACTER SET と COLLATE を指定しないと インストール後に文字化けが発生することがあるので注意してください WebSDMSS をインストールしたいディレクトリにダウンロードした WebSDMSS 内のディレクトリの全てのファイルを移動します 以下の手順は ドキュメントルートが /var/www/websdmss/html/htdocs で ダウンロードした WebSDMSS アーカイブのファイル名が websdmss-1.0.zip の場合の設定例です # cd /var/www # unzip websdmss-1.0.zip # mv websdmss-1.0 websdmss # chown -R apache:apache websdmss 次に WebSDMSS ソースツリー内の define.inc.php を開き 以下の行を環境に合わせて変更してください # vi /var/www/websdmss/html/webapp html/webapp/config/define.inc.php /config/define.inc.php ( 中略 ) define("java_path", "/usr/bin/java"); 新規インストール手順 設定したウェブサイトにブラウザでアクセスすると WebSDMSS のインストール画面が表示されます 後は画面に従って必要な情報を入力していけばインストールが完了します 詳細は NetCommons のオンライン管理者マニュアルの %E3%83%8B%E3%83%A5%E3%82%A2%E3%83%AB/2_NetCommons%E3%81%AE%E 3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB/2-4_%E6 %96%B0%E8%A6%8F%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%B C%E3%83%AB%E6%89%8B%E9%A0%86 を参考にしてください

15 管理者マニュアルライセンス表示 3. ライセンス表示 3.1. フリーソフト利用のためのライセンス JODConverter JODConverter(the Java OpenDocument Converter) は LGPL によって提供されます 3.2. NetCommons2.0 利用にかかるライセンス 本システムでは NetCommons2.0 のコードを拡張し 利用しています 本システムを再配布する場合にも以下のライセンス条件に従ってください NetCommons2.0 LICENSE NetCommons は 大学共同利用機関法人情報 システム機構国立情報学研究所が開発した PHP によるオープンソースの情報共有基盤システムです 本ソフトウェアの著作権は情報 システム機構およびプログラムを作成した各個人に帰属し FreeBSD ライセンスによって公開されています 本ソフトウェアを利用する方は FreeBSD ライセンスの精神をご理解の上 ご利用ください FreeBSD ライセンス 日本語訳 ense.html 本ソフトウェアはソースコード形式であれバイナリ形式であれ 変更の有無に関わらず 以下の条件を満たす限りにおいて 再配布および使用を許可します ソースコード形式で再配布する場合 上記著作権表示 本条件書および下記責任限定規定を必ず含めてください バイナリ形式で再配布する場合 上記著作権表示 本条件書および下記責任限定規定を 配布物とともに提供される文書および他の資料に必ず含めてください 本ソフトウェアは国立情報学研究所 NetCommons PROJECT によって 現状のまま 提供されるものとします 本ソフトウェアについては 明示黙示を問わず 商用品として通常そなえるべき品質をそなえているとの保証も 特定の目的に適合するとの保証を含め 何の保証もなされません 事由のいかんを問わず 損害発生の原因いかんを問わず 且つ 責任の根拠が契約であるか厳格責任であるか ( 過失その他 ) 不法行為であるかを問わず 情報 システム研究機構 国立情報学研究所 NetCommons P ROJECT および寄与者も 仮にそのような損害が発生する可能性を知らされていたとしても 本ソフトウェアの使用から発生した直接損害 間接損害 偶発的な損害 特別損害 懲罰的損害または結果損害のいずれに対しても ( 代替品またはサービスの提供 ; 使用機会 データまたは利益の損失の補償 ; または 業務の中断に対する補償を含め ) 責任をいっさい負いません

16 管理者マニュアルライセンス表示 本ソフトウェアの名称である NetCommons およびロゴは大学共同利用機関法人情報 システム機構の知的財産として商標登録されています 商標 NetCommons の利用を希望される場合には 大学共同利用機関法人情報 システム機構国立情報学研究所 ( 郵便番号 東京都千代田区一ツ橋 ) までお問い合わせください NetCommons PROJECT