復旦sakaiインストールガイド
13023 ワード
OS:お金システムCentos 64
tomcat 7
jdk1.8.5
注意:sakaiはtomcat 6をサポートしていません(理由:jdbc poolはエラーを報告し、tomcat 7はjdbc poolをサポートします)
ソース:北郵便のソースを使用
0.説明
Sakai復旦共有版のインストール方式はSakai公式版とほぼ一致しているため、Sakai公式インストールドキュメントを完全に参照してインストールすることができる.以下、復旦Sakai共有版のインストール状況のみで説明します.
1.オペレーティングシステムのインストール
SakaiはJava言語で開発され、理論的にはJVM仮想マシンがインストールされているオペレーティングシステムはすべてインストールできます.Sakaiコミュニティで提供されている情報を見ると、Linux、Windows、Solarisには対応するインストールインスタンスがあります.復旦大学はDebian Linuxをオペレーティングシステムとして使用している.以下の説明は、Debian Linux 7(Wheezy)を例として示す.
Debianの公式サイトでは、詳しいインストール指導があります.
2.運転環境の準備
2.0 sudoのインストール(オプション)
安全上の考慮に基づいて、オペレーティングシステムのインストールが完了した後、sudoをインストールすることを強くお勧めします.rootアカウントを使用して日常的な操作を行うには、大きなセキュリティ上の危険性があります.以下に示すコマンドでは、#で開始すると管理者として実行する必要があり、$で開始すると、一般ユーザーが権限のあるディレクトリで実行できることを示します.一般ユーザーはsudoコマンドで権限を上げることができます.#$とはコマンドラインプロンプトであり、コマンドの一部ではありません.
2.1 JVMのインストール
Open JDK 6とOpen JDK 7はいずれもSakaiの要件を満たすことができますが、OracleはOracle JDKのパッチの公開を停止しています.Open JDK 7の復旦版を使用することをお勧めします.2.9.3.1以降、JDK 7のみをサポートします.
2.2 Apache Mavenのインストール
SakaiはApache Mavenを使用してプロジェクト管理を行います.私たちはmavenを通じてSakaiに対して関連するコンパイル、ユニットテスト、配置などの仕事を行うことができます.注意:Sakai 2.8.xはMaven 2.xを使用します.Sakai 2.9.x Maven 3.xを使用
2.3 MySQLのインストール(必須)
Sakaiの公式ドキュメントによると、現在安定してサポートされているデータベースには、Oracle、MySQL、HSQLDBの3種類が含まれており、本番環境でHSQLDBを使用することは推奨されていません.復旦大学はMySQLをデータベースサーバとして使用しています.Debian 7のMySQLバージョンは5.5
MySQLのデフォルト文字をUTF-8としてエンコードするには、MySQLのプロファイル(/etc/mysql/my.cnf)に次の構成を追加する必要があります.
mysqldセグメントに追加
サービスmysqld start追加の構成を行わない場合、SakaiはHSQLDBをデフォルトデータベースとして使用します.
2.4 Apache Tomcatのインストール
Sakai 10.xは現在7.0バージョンのTomcatのみをサポートしています.注意:apt-getを使用してTomcatをインストールしないでください.そうしないと、構成が非常に複雑になります.
vi/etc/profile
export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE HISTCONTROL export JAVA_HOME=/usr/java/jdk1.8.0_05 export TOMCAT_HOME=/usr/share/tomcat export CATALINA_HOME=/usr/share/tomcat6 export HADOOP_HOME=/usr/local/hadoop/hadoop-1.0.1 export JRE_HOME=$JAVA_HOME/jre export ANT_HOME=/usr/local/ant export PATH=$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$HADOOP_HOME/bin:$ANT_HOME/bin:/usr/lib64/qt4/bin/:$PATH export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar export JAVA_HOME HADOOP_HOME PATH CLASSPATH ANT_HOME
Tomcatに付属するいくつかの例、すなわち%TOMCAT_を削除HOME%/webappsディレクトリの下にあるすべてのディレクトリ
2.5分散バージョン管理ソフトウェアMercurialのインストール(オプション)
カスタマイズしながら、公式バージョンの更新を取得できるようにします.復旦Sakai共有版はMercurialを使用してバージョン管理を行います.いくつかのパッチを蓄積した後にマイルストーンバージョンをリリースしますが、最新バージョンのソースコードを取得するにはMercurialを使用して更新する必要があります.
次にapt-getを使用してmercurialをインストールします
3.復旦共有版Sakaiのインストール
3.1ソースコードのダウンロード
ダウンロードページから復旦Sakai共有版のsrc版をダウンロードしたり、Mercurialで最新版をダウンロードしたりすることができます
[root@gdc1000 tomcat]# ls/home/gftp/kb/devkb/sakai/ sakai-bupt-src-10.3-fudan.r1.zip [root@gdc1000tomcat]#ls/home/gftp/kb/devkb/sakai/このコマンドは、現在のディレクトリの下にfudan-sakaiというディレクトリを作成し、最新バージョンのソースコードを更新します.以下、%SAKAI_SRC%はこのディレクトリを表します.
3.2 Apache Mavenを使用してソースコードをコンパイルし、Tomcatに配備する
3.2.1 Mavenのデフォルト構成の変更
Sakaiをフルコンパイルする場合、プロジェクト全体が大きいため、Mavenはデフォルトの構成でメモリオーバーフローが発生する可能性があります.次のコマンドでMavenのメモリ量を増やすことができます.
3.2.2コードのコンパイルと配置
%SAKAI_SRC%ディレクトリの下で次のコマンドを実行してコンパイルし、結果をTomcat、コマンドの%TOMCAT_に配置します.HOME%対応するTomcatディレクトリに置き換えてください
このコマンドの実行中、プログラムは実行に必要なファイルを自動的にダウンロードするので、この過程で安定した国際ネットワーク接続が必要です.
このコマンドを初めて実行する場合は、ネットワークの状況に応じて1～2時間かかる場合があります.
-DSkipTestsは、すべてのテストを省略したことを示します.
3.3 Tomcatの構成
以下の構成は、Tomcatのみで導入する場合に適用されます.これに基づいて、Apache HTTP Serverを使用して、トップページの自動ジャンプ、負荷分散など、より柔軟な構成を提供できます.
3.3.1トップページの自動ジャンプページを追加する(オプション)
Sakaiのデフォルトのトップページパスは/portalなので、トップページジャンプページを増やして自動ジャンプする必要があります.%TOMCAT_HOME%/webappsディレクトリの下にROOTディレクトリ(大文字と小文字に注意)を作成し、ROOTディレクトリの下にファイルindex.htmlを作成します.内容は以下の通りです.
3.3.2 setenv.shを追加してTomcat運転パラメータを設定する(オプション)
%TOMCAT_HOME%/binディレクトリの下にsetenv.shを新規作成します.内容は以下の通りです.
そのうち%JAVA_HOME%はJDKのインストールディレクトリに設定します;%TOMCAT_HOME%がTomcatのインストールディレクトリに設定されていますので、具体的な機器環境に合わせて設定してください.
3.3.3 server.xmlの変更
変更%TOMCAT_HOME%/conf/server.xml、GETメソッドのUTF-8文字サポートを追加
次のように変更
3.3.4 catalina.propertiesの変更
変更%TOMCAT_HOME%/conf/catalina.propertiesは
次のように変更
将
次のように変更
将
次のように変更
3.4 MySQLの構成(必須)
3.4.1 Sakaiデータベース表領域の作成
mysql -u root -p
MySQL管理者アカウントを使用してMySQLデータベースにログインし、Sakaiに必要な表領域を作成します.
3.4.2 sakai.propertiesの構成
FIXME sakai.propertiesかlocal.propertiesか
%TOMCAT_HOME%でsakaiディレクトリを作成し、%TOMCAT_HOME%/sakaiディレクトリの下にsakai.propertiesファイルを作成sakai.propertiesファイルに次の内容を追加します.
内[email protected]の値は、関連するMySQL JDBC接続文字列で置き換えてください[email protected]の値はMySQLのユーザー名で代用してください[email protected]の値はMySQLのパスワードで代用してください
3.4.3 MySQLのJDBCライブラリの配備
MySQL公式サイトから最新のMySQL JDBCライブラリをダウンロードし、ダウンロードしたファイルを解凍するとmysql-connector-java-5..1.xx-bin.jarというファイルが得られ、このファイルを%TOMCAT_にコピーするHOME%/common/libディレクトリの下
3.5中国語フォントのインストール
Sakaiでは、PDFエクスポート機能をサポートするツールが一部ありますが、PDFフォーマットの制限により、中国語のデフォルトサポートが不十分なため、オペレーティングシステムに対応する中国語フォントをインストールし、PDFエクスポート時に使用するフォントを指定する必要があります.復旦大学の配置では「AR PL UMing CN」を使用しています.この機能はSakai復旦共有版特有の機能で、現在Sakai公式版ではこの問題は修正されていません.
3.5.1インストールフォント(デフォルトcentosでfixmeがインストールされています)
3.5.2 SakaiにPDFファイルをエクスポートするときのデフォルトフォントを指定
%TOMCAT_HOME%/sakai/ディレクトリ(手動で作成する必要がある場合があります)でsakai.propertiesファイルを作成します.以下の内容を加える
4 Sakaiの起動/停止
Tomcatの起動/停止によるSakaiの起動/停止
4.1 Tomcatの起動
%TOMCAT_HOME%/binディレクトリで、実行
4.2 Tomcatの停止
%TOMCAT_HOME%/binディレクトリで、実行
5 Sakaiへのアクセス
任意のWebブラウザを開き、http://localhost:8080 .
リファレンス
http://sakai.fudan.edu.cn/projects/fudan-sakai/wiki/Src%E7%89%88%E5%AE%89%E8%A3%85%E8%AF%B4%E6%98%8E%2829%29
tomcat 7
jdk1.8.5
注意:sakaiはtomcat 6をサポートしていません(理由:jdbc poolはエラーを報告し、tomcat 7はjdbc poolをサポートします)
ソース:北郵便のソースを使用
0.説明
Sakai復旦共有版のインストール方式はSakai公式版とほぼ一致しているため、Sakai公式インストールドキュメントを完全に参照してインストールすることができる.以下、復旦Sakai共有版のインストール状況のみで説明します.
1.オペレーティングシステムのインストール
SakaiはJava言語で開発され、理論的にはJVM仮想マシンがインストールされているオペレーティングシステムはすべてインストールできます.Sakaiコミュニティで提供されている情報を見ると、Linux、Windows、Solarisには対応するインストールインスタンスがあります.復旦大学はDebian Linuxをオペレーティングシステムとして使用している.以下の説明は、Debian Linux 7(Wheezy)を例として示す.
Debianの公式サイトでは、詳しいインストール指導があります.
2.運転環境の準備
2.0 sudoのインストール(オプション)
安全上の考慮に基づいて、オペレーティングシステムのインストールが完了した後、sudoをインストールすることを強くお勧めします.rootアカウントを使用して日常的な操作を行うには、大きなセキュリティ上の危険性があります.以下に示すコマンドでは、#で開始すると管理者として実行する必要があり、$で開始すると、一般ユーザーが権限のあるディレクトリで実行できることを示します.一般ユーザーはsudoコマンドで権限を上げることができます.#$とはコマンドラインプロンプトであり、コマンドの一部ではありません.
# apt-get install sudo2.1 JVMのインストール
Open JDK 6とOpen JDK 7はいずれもSakaiの要件を満たすことができますが、OracleはOracle JDKのパッチの公開を停止しています.Open JDK 7の復旦版を使用することをお勧めします.2.9.3.1以降、JDK 7のみをサポートします.
# apt-get install openjdk-7-jdk2.2 Apache Mavenのインストール
SakaiはApache Mavenを使用してプロジェクト管理を行います.私たちはmavenを通じてSakaiに対して関連するコンパイル、ユニットテスト、配置などの仕事を行うことができます.注意:Sakai 2.8.xはMaven 2.xを使用します.Sakai 2.9.x Maven 3.xを使用
# apt-get install maven2.3 MySQLのインストール(必須)
Sakaiの公式ドキュメントによると、現在安定してサポートされているデータベースには、Oracle、MySQL、HSQLDBの3種類が含まれており、本番環境でHSQLDBを使用することは推奨されていません.復旦大学はMySQLをデータベースサーバとして使用しています.Debian 7のMySQLバージョンは5.5
# apt-get install mysql-serverMySQLのデフォルト文字をUTF-8としてエンコードするには、MySQLのプロファイル(/etc/mysql/my.cnf)に次の構成を追加する必要があります.
mysqldセグメントに追加
character-set-server=utf8サービスmysqld start追加の構成を行わない場合、SakaiはHSQLDBをデフォルトデータベースとして使用します.
2.4 Apache Tomcatのインストール
Sakai 10.xは現在7.0バージョンのTomcatのみをサポートしています.注意:apt-getを使用してTomcatをインストールしないでください.そうしないと、構成が非常に複雑になります.
centos6 epel ， vi/etc/profile
export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE HISTCONTROL export JAVA_HOME=/usr/java/jdk1.8.0_05 export TOMCAT_HOME=/usr/share/tomcat export CATALINA_HOME=/usr/share/tomcat6 export HADOOP_HOME=/usr/local/hadoop/hadoop-1.0.1 export JRE_HOME=$JAVA_HOME/jre export ANT_HOME=/usr/local/ant export PATH=$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$HADOOP_HOME/bin:$ANT_HOME/bin:/usr/lib64/qt4/bin/:$PATH export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar export JAVA_HOME HADOOP_HOME PATH CLASSPATH ANT_HOME
Tomcatに付属するいくつかの例、すなわち%TOMCAT_を削除HOME%/webappsディレクトリの下にあるすべてのディレクトリ
$ rm -rf %TOMCAT_HOME%/webapps/* 2.5分散バージョン管理ソフトウェアMercurialのインストール(オプション)
カスタマイズしながら、公式バージョンの更新を取得できるようにします.復旦Sakai共有版はMercurialを使用してバージョン管理を行います.いくつかのパッチを蓄積した後にマイルストーンバージョンをリリースしますが、最新バージョンのソースコードを取得するにはMercurialを使用して更新する必要があります.
次にapt-getを使用してmercurialをインストールします
# apt-get install mercurial3.復旦共有版Sakaiのインストール
3.1ソースコードのダウンロード
ダウンロードページから復旦Sakai共有版のsrc版をダウンロードしたり、Mercurialで最新版をダウンロードしたりすることができます
$ hg clone http://sakai.fudan.edu.cn/fudan-sakai[root@gdc1000 tomcat]# ls/home/gftp/kb/devkb/sakai/ sakai-bupt-src-10.3-fudan.r1.zip [root@gdc1000tomcat]#ls/home/gftp/kb/devkb/sakai/このコマンドは、現在のディレクトリの下にfudan-sakaiというディレクトリを作成し、最新バージョンのソースコードを更新します.以下、%SAKAI_SRC%はこのディレクトリを表します.
3.2 Apache Mavenを使用してソースコードをコンパイルし、Tomcatに配備する
3.2.1 Mavenのデフォルト構成の変更
Sakaiをフルコンパイルする場合、プロジェクト全体が大きいため、Mavenはデフォルトの構成でメモリオーバーフローが発生する可能性があります.次のコマンドでMavenのメモリ量を増やすことができます.
$ export MAVEN_OPTS='-Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m'3.2.2コードのコンパイルと配置
%SAKAI_SRC%ディレクトリの下で次のコマンドを実行してコンパイルし、結果をTomcat、コマンドの%TOMCAT_に配置します.HOME%対応するTomcatディレクトリに置き換えてください
$ mvn install sakai:deploy -Dmaven.tomcat.home=%TOMCAT_HOME% -DskipTestsこのコマンドの実行中、プログラムは実行に必要なファイルを自動的にダウンロードするので、この過程で安定した国際ネットワーク接続が必要です.
このコマンドを初めて実行する場合は、ネットワークの状況に応じて1～2時間かかる場合があります.
-DSkipTestsは、すべてのテストを省略したことを示します.
3.3 Tomcatの構成
以下の構成は、Tomcatのみで導入する場合に適用されます.これに基づいて、Apache HTTP Serverを使用して、トップページの自動ジャンプ、負荷分散など、より柔軟な構成を提供できます.
3.3.1トップページの自動ジャンプページを追加する(オプション)
Sakaiのデフォルトのトップページパスは/portalなので、トップページジャンプページを増やして自動ジャンプする必要があります.%TOMCAT_HOME%/webappsディレクトリの下にROOTディレクトリ(大文字と小文字に注意)を作成し、ROOTディレクトリの下にファイルindex.htmlを作成します.内容は以下の通りです.
<html> <head> <title>Redirecting to /portal</title> <meta http-equiv="Refresh" content="0:URL=/portal"> </head> <body bgcolor="#ffffff" onLoad="javascript:window.location='/portal';"> <div style="margin:18px;width:288px;background-color:#cccc99;padding:18px;border:thin solid #666600;text-align:justify"> <p style="margin-top:0px"> You are being redirected to the Sakai portal. If you are not automatically redirected, use the link below to continue: <br/> <a href="/portal">Take me to the Sakai portal</a> </p> </body> </html> 3.3.2 setenv.shを追加してTomcat運転パラメータを設定する(オプション)
%TOMCAT_HOME%/binディレクトリの下にsetenv.shを新規作成します.内容は以下の通りです.
export JAVA_HOME="%JAVA_HOME" export JAVA_OPTS="-server -Xms512m -Xmx2048m -XX:PermSize=128m -XX:MaxPermSize=512m -XX:NewSize=192m -XX:MaxNewSize=384m -Djava.net.preferIPv4Stack=true -Djava.awt.headless=true -Dhttp.agent=Sakai -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Dsun.lang.ClassLoader.allowArraySyntax=true -Duser.language=zh -Duser.region=CN" export CATALINA_HOME=%TOMCAT_HOME% そのうち%JAVA_HOME%はJDKのインストールディレクトリに設定します;%TOMCAT_HOME%がTomcatのインストールディレクトリに設定されていますので、具体的な機器環境に合わせて設定してください.
3.3.3 server.xmlの変更
変更%TOMCAT_HOME%/conf/server.xml、GETメソッドのUTF-8文字サポートを追加
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" /> 次のように変更
<Connector port="8080" protocol="HTTP/1.1" URIEncoding="UTF-8" connectionTimeout="20000" redirectPort="8443" /> 3.3.4 catalina.propertiesの変更
変更%TOMCAT_HOME%/conf/catalina.propertiesは
common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar次のように変更
common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar,${catalina.home}/common/lib/*.jar将
shared.loader=次のように変更
shared.loader=${catalina.base}/shared/lib/*.jar将
org.apache.catalina.startup.ContextConfig.jarsToSkip=次のように変更
org.apache.catalina.startup.ContextConfig.jarsToSkip=*.jar3.4 MySQLの構成(必須)
3.4.1 Sakaiデータベース表領域の作成
mysql -u root -p
MySQL管理者アカウントを使用してMySQLデータベースにログインし、Sakaiに必要な表領域を作成します.
CREATE SCHEMA `sakai` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci ;3.4.2 sakai.propertiesの構成
FIXME sakai.propertiesかlocal.propertiesか
%TOMCAT_HOME%でsakaiディレクトリを作成し、%TOMCAT_HOME%/sakaiディレクトリの下にsakai.propertiesファイルを作成sakai.propertiesファイルに次の内容を追加します.
# MySQL settings - make sure to alter as appropriate
[email protected]=mysql
[email protected]=com.mysql.jdbc.Driver
hibernate.dialect=org.hibernate.dialect.MySQLDialect
[email protected]=jdbc:mysql://127.0.0.1:3306/sakai?useUnicode=true&characterEncoding=UTF-8
[email protected]=show variables like 'version'
[email protected]=TRANSACTION_READ_COMMITTED
[email protected]=sakai
[email protected]=********
内[email protected]の値は、関連するMySQL JDBC接続文字列で置き換えてください[email protected]の値はMySQLのユーザー名で代用してください[email protected]の値はMySQLのパスワードで代用してください
3.4.3 MySQLのJDBCライブラリの配備
MySQL公式サイトから最新のMySQL JDBCライブラリをダウンロードし、ダウンロードしたファイルを解凍するとmysql-connector-java-5..1.xx-bin.jarというファイルが得られ、このファイルを%TOMCAT_にコピーするHOME%/common/libディレクトリの下
3.5中国語フォントのインストール
Sakaiでは、PDFエクスポート機能をサポートするツールが一部ありますが、PDFフォーマットの制限により、中国語のデフォルトサポートが不十分なため、オペレーティングシステムに対応する中国語フォントをインストールし、PDFエクスポート時に使用するフォントを指定する必要があります.復旦大学の配置では「AR PL UMing CN」を使用しています.この機能はSakai復旦共有版特有の機能で、現在Sakai公式版ではこの問題は修正されていません.
3.5.1インストールフォント(デフォルトcentosでfixmeがインストールされています)
yum install cjkuni-uming-fonts3.5.2 SakaiにPDFファイルをエクスポートするときのデフォルトフォントを指定
%TOMCAT_HOME%/sakai/ディレクトリ(手動で作成する必要がある場合があります)でsakai.propertiesファイルを作成します.以下の内容を加える
fop.pdf.default.font=AR PL UMing CN4 Sakaiの起動/停止
Tomcatの起動/停止によるSakaiの起動/停止
4.1 Tomcatの起動
%TOMCAT_HOME%/binディレクトリで、実行
$ sh startup.sh4.2 Tomcatの停止
%TOMCAT_HOME%/binディレクトリで、実行
$ sh shutdown.sh5 Sakaiへのアクセス
任意のWebブラウザを開き、http://localhost:8080 .
リファレンス
http://sakai.fudan.edu.cn/projects/fudan-sakai/wiki/Src%E7%89%88%E5%AE%89%E8%A3%85%E8%AF%B4%E6%98%8E%2829%29