Studioと連動させるためのTomcat構成の変更

Studioをデプロイするには、いくつかのTomcat構成ファイルを変更する必要があります。

Tomcat構成の更新を完了する手順は次のとおりです。

  1. endeca-portal/apache-tomcat-<version>/bin/ディレクトリで、JAVA_OPTSの値を設定することで、catalina.bat (Windowsの場合)またはcatalina.sh (Linuxの場合)を変更し、サーバーのメモリ・サイズを増やし、Studio用のセキュリティ構成を確立します。

    Execute The Requested Commandの下に設定を追加します。設定は単一行(改行なし)として追加する必要があり、パラメータはスペースで区切ります。

    Windowsの場合、追加する行は次のとおりです。

    set JAVA_OPTS=%JAVA_OPTS% -Xmx1024m -XX:MaxPermSize=256m -Dfile.encoding=UTF8
    -Duser.timezone=GMT -Djava.security.auth.login.config="%CATALINA_HOME%/conf/jaas.config"
    -Dorg.apache.catalina.loader.WebappClassLoader.ENABLE_CLEAR_REFERENCES=false
    -Djavax.xml.transform.TransformerFactory
    =com.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImpl
    -Djavax.xml.parsers.DocumentBuilderFactory
    =com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl
    -Djavax.xml.parsers.SAXParserFactory
    =com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl

    Linuxの場合、追加する行は次のとおりです。

    JAVA_OPTS="$JAVA_OPTS -Xmx1024m -XX:MaxPermSize=256m 
    -Dfile.encoding=UTF8 -Duser.timezone=GMT 
    -Djava.security.auth.login.config="$CATALINA_HOME"/conf/jaas.config 
    -Dorg.apache.catalina.loader.WebappClassLoader.ENABLE_CLEAR_REFERENCES=false 
    -Djavax.xml.transform.TransformerFactory=com.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImpl 
    -Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl 
    -Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl"
  2. ファイルendeca-portal/apache-tomcat-<バージョン>/conf/catalina.propertiesを次のように変更して、共通クラス・ローダーにextディレクトリを追加します。
    common.loader=
        ${catalina.base}/lib,\
        ...\
        ${catalina.home}/lib/ext/*.jar
  3. Studioを/eidという推奨コンテキスト・パスにデプロイするには、endeca-portal/apache-tomcat-<version>/conf/Catalina/localhost/eid.xmlという新しいファイルを作成します。

    Studioをそれ以外のコンテキストにデプロイするには、<コンテキスト・ルート>.xmlという新しいファイルをendeca-portal/apache-tomcat-<バージョン>/conf/Catalina/localhost/で作成します。

    マルチレベル・コンテキスト・パスでは、名前を#で区切ります。たとえば、コンテキスト・パスが/sales/eastの場合、ファイル名はsales#east.xmlになるはずです。

    ディレクトリはすでにROOT.xmlというファイルを含んでおり、このファイルはTomcatのルート・コンテキストへのアクセスを提供します。

  4. 前の手順で作成したXMLファイルを変更して、次のものを追加します。
    <Context crossContext="true" />
  5. UTF-8 URIエンコーディングをサポートするには、endeca-portal/apache-tomcat-<バージョン>/confディレクトリにあるserver.xmlファイルを、次のように編集します。
    <!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
        <Connector port="8080" protocol="HTTP/1.1" 
            connectionTimeout="20000" 
            redirectPort="8443"
            URIEncoding="UTF-8"
        />