この記事では、Liferay Portal 6.1 EE GA3 または 6.2 EE を Tomcat 8 Server にセットアップする方法を説明します。
解像度
1. 必要なファイルを集める
- Tomcat 8の最新版をダウンロードし、解凍してください。
- 最新の 6.1 EE GA3 SP5 war または Liferay 6.2 .war ファイルをダウンロードしてください。
- 6.1 EE GA3 または 6.2 EE のバンドルと依存関係のファイルをダウンロードします。
2. 依存性ジャー
- tomcat サーバーを解凍したら、
{$TOMCAT_HOME}/lib/ext
フォルダを作成します。 - ダウンロードした6.2 Tomcatバンドルから、バンドル内の
{$TOMCAT_HOME}/lib/ext
のファイルをすべてコピーし、この新しいTomcatサーバーの{$TOMCAT_HOME}/lib/ext
フォルダに配置します。 その後、 ステップ6にスキップします。 - ただし、Liferay Portal を構築し、依存関係にそれを使用している場合は、依存関係のファイルを
{$TOMCAT_HOME}/lib/ext
に展開します。 -
{$build}/lib/development
から$TOMCAT_HOME/lib/ext
に以下の jar をコピーします(これらは既存のバンドルから取得することも可能です)。activation.jar
jms.jar
jta.jar
jutf7.jar
mail.jar
persistence.jar
-
ccpp.jar
を{$build}/lib/portal
から{$TOMCAT_HOME}/lib/ext
へコピーする。 -
OPTIONAL: 以下の jar を
{$build}/lib/development
から{$TOMCAT_HOME}/temp/liferay/com/liferay/portal/deploy/dependencies
へコピーします。 - 最新のMySQL JDBCドライバ MySQL Connector をダウンロードし、
mysql-connector-java-{$version}-bin.jar
を{$TOMCAT_HOME}/lib/ext
に展開します。
3. ドメインを設定する
- 作成
setenv.bat|sh
in[$TOMCAT_HOME}/bin
- Windows環境では、
setenv.bat
ファイルに以下を追加して編集してください:
if exist "%CATALINA_HOME%/jre@java.version@/win" ( if not "%JAVA_HOME%" == "" ( set JAVA_HOME= ) set "JRE_HOME=%CATALINA_HOME%/jre@java.version@/win" ) set "JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF8 -Djava.net.preferIPv4Stack=true -Dorg.apache.catalina.loader.WebappClassLoader.ENABLE_CLEAR_REFERENCES=false -Duser.timezone=GMT -Xmx1024m -XX:MaxPermSize=384m"
-
Unix/Linux の環境で、setenv.sh ファイルに以下を追加して編集してください:
CATALINA_OPTS="$CATALINA_OPTS -Dfile.encoding=UTF8 -Djava.net.preferIPv4Stack=true -Dorg.apache.catalina.loader.WebappClassLoader.ENABLE_CLEAR_REFERENCES=false -Duser.timezone=GMT -Xmx1024m -XX:MaxPermSize=384m"
-
なお、Unix、Linux環境では、
export
コマンドを使用します(set
ではありません)。 - Unix、Linux環境では、デフォルトのJAVAパスとは異なるJAVA_HOME、JRE_HOMEを設定することが可能です。 例えば、複数のJDKとJREがインストールされており、システム管理者が同じサーバーで異なるポータルバージョンの複数のLiferayバンドルを実行するような場合です。 また、システム管理者がTomcat 8上のLiferayに限定されたシステムアクセスを許可し、バンドルがグローバル設定を使用しないようにしたい場合もよくあるシナリオです。
以下は古い例です(フォルダディレクトリやJDKのバージョンは必要に応じて変更してください)。
export JAVA_HOME=/usr/java/jdk1.7.0_21
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=$JAVA_HOME/jre/lib/ext:$JAVA_HOME/lib/tools.jar注:これらの設定は永続的なものではなく、シェルコンソールを閉じた場合、設定は保存されません。 設定を保存するには、設定が保存されている場所(例:CentOSの場合はetc/profile.d)に設定を追加してください。
- Windows環境では、
- ディレクトリの作成
{$TOMCAT_HOME}/conf/Catalina/localhost
-
ROOT.xml
in{%TOMCAT_HOME}/conf/Catalina/localhost
を作成します。 -
ROOT.xml
を編集し、以下を追加します:<Context path="" crossContext="true"> <!-- JAAS --> <!--<Realm className="org.apache.catalina.realm.JAASRealm" appName="PortalRealm" userClassNames="com.liferay.portal.kernel.security.jaas.PortalPrincipal" roleClassNames="com.liferay.portal.kernel.security.jaas.PortalRole" />--> <!-- Uncomment the following to disable persistent sessions across reboots. --> <!-- <Manager pathname="" /> --> <!-- Uncomment the following to not use sessions. See the property "session.disabled" in portal.properties. --> <!-- <Manager className="com.liferay.support.tomcat.session.SessionLessManagerBase" /> --> </Context>
-
{$TOMCAT_HOME}/conf/catalina.properties
を編集し、置き換える。common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jarwith
common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar,${catalina.home}/lib/ext,${catalina.home}/lib/ext/*.jar
-
{$TOMCAT_HOME}/conf/server.xml
を編集し、置き換える。<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />with
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" />
-
{$TOMCAT_HOME}/webapps
に移動し、support-catalina.jar が存在する場合は削除してください。 -
{$TOMCAT_HOME}/conf
に移動し、context.xml を開く。 で内容を置き換えてください(ユーザー名、パスワード、urlパラメータは、必ずご自身の環境を指すように名前を変えてください):<?xml version='1.0' encoding='utf-8'?> <Context> <WatchedResource>WEB-INF/web.xml</WatchedResource> <WatchedResource>${catalina.base}/conf/web.xml</WatchedResource> <Resources cachingAllowed="true" cacheMaxSize="100000" /> <Resource name="jdbcliferay" auth="Container" type="javax.sql.DataSource" maxActive="64" maxIdle="16" maxWait="1000" username="root" password="" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost/lp_621_ga2_patched?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false&autoReconnect=true" validationQuery="select 1" /> </Context>
4. Liferayをデプロイする
-
{$TOMCAT_HOME}/webapps/ROOT
に移動し、内容を削除してください。 - Liferay Portal 6.1 EE GA3 SP5 .war または liferay-portal-6.2.0.war の内容を
{$TOMCAT_HOME}/webapps/ROOT
に解凍してください。 -
{$LIFERAY_HOME}
に portal-ext.properties ファイルを作成し、データソースの設定を示すために以下の行を追加します。 jdbc.default.jndi.name=jdbcliferay -
{$TOMCAT_HOME}/bin
にコマンドコンソールを開き、startup.bat(Unix/Linuxでは./catalina.sh run
)と入力し、サーバーを起動します。