スタンドアロンのインデックスサーチサーバーの設定
インデックスサーチサーバーをスタンドアロンモードでインストールした場合は、次の手順を実行します。
|
|
Java 8 以降を使用していることを確認します。そうでない場合は、以下のコマンドを実行する前に SOLR_JAVA_HOME 環境変数を設定します。
• Windows: SET SOLR_JAVA_HOME=<Java 8 へのパス>
• Unix: export SOLR_JAVA_HOME=<Java 8 へのパス>
|
Solr サーバー: 起動および停止コマンド
Solr サーバーを起動または停止するには、次のコマンドを実行します。
• 起動コマンド
◦ Solr の起動 (Windows):
<インデックスサーチホーム>/bin/Index_Search_Server.bat start
◦ Solr の起動 (Unix):
sh <インデックスサーチホーム>/bin/Index_Search_Server.sh start
• 停止コマンド
◦ Solr の停止 (Windows):
<インデックスサーチホーム>/bin/Index_Search_Server.bat stop
◦ Solr の停止 (Unix):
sh <インデックスサーチホーム>/bin/Index_Search_Server.sh stop
Solr コア (スタンドアロンモード) の作成
1. コマンドプロンプトを開き、以下のコマンドを使用して Solr を起動します。
◦ Solr の起動 (Windows):
<インデックスサーチホーム>/bin/Index_Search_Server.bat start
◦ Solr の起動 (Unix):
sh <インデックスサーチホーム>/bin/Index_Search_Server.sh start
ここで、<インデックスサーチホーム> はインデックスサーチサーバーがインストールされているインストールディレクトリです。
2. コマンドプロンプトから<インデックスサーチホーム>/solr/bin に移動し、次のコマンドを実行して、必要なモジュールのコアを作成します。
Windchill Index Search
▪ Windows:
solr.cmd create -c wblib -n wblib -d D:\ptc\IndexSearchServer\SolrServer\solr_schemas\wblib
▪ Unix:
solr create -c wblib -n wblib -d /opt/ptc/IndexSearchServer/SolrServer/solr_schemas/wblib
Windchill PartsLink
▪ Windows:
solr.cmd create -c clfstructurelib -n clfstructurelib -d D:\ptc\IndexSearchServer\SolrServer\solr_schemas\clfstructurelib
▪ Unix:
solr create -c clfstructurelib -n clfstructurelib -d /opt/ptc/IndexSearchServer/SolrServer/solr_schemas/clfstructurelib
S1000D
▪ Windows:
solr.cmd create -c sisaadlib -n sisaadlib -d D:\ptc\IndexSearchServer\SolrServer\solr_schemas\sisaadlib
▪ Unix:
solr create -c sisaadlib -n sisaadlib -d /opt/ptc/IndexSearchServer/SolrServer/solr_schemas/sisaadlib
|
|
オプションのモジュールがインストールされていない場合でも、Windchill Index Search、Windchill PartsLink、および S1000D のコアを作成することをお勧めします。作成しておくと、これらのモジュールを後でインストールする場合に、そのコアを作成する必要がありません。
|
3. Solr 管理者インタフェースを開き、Solr が実行されていることとコアが使用可能であることを確認します。
http://<Solr ホスト名>:<Solr ポート>/solr
スタンドアロンサーバーの Solr スキーマの更新 (省略可能)
Solr スキーマを更新するには、次の手順に従います。
1. <インデックスサーチホーム>/solr/server/solr に移動し、必要な更新を行います。
2. Solr 管理者インタフェースを開き、「Core Admin」を選択します。
3. スキーマを更新したコアを選択し、「Reload」をクリックします。
Solr の基本認証の設定 (スタンドアロンモード)
1. 以下のコマンドを使用して Solr を停止します。
◦ Windows
<インデックスサーチホーム>/bin/Index_Search_Server.bat stop
◦ Unix
sh <インデックスサーチホーム>/bin/Index_Search_Server.sh stop
2. 次のファイルを開きます。
<インデックスサーチホーム>/solr/server/etc/webdefault.xml
以下のようにコンテンツを編集します (変更はハイライトされています)。
3. 次のファイルを開きます。
<インデックスサーチホーム>/solr/server/etc/jetty.xml
末尾の </Configure> タグの前に次のセクションを追加します。
4. Jetty によって提供される次のユーティリティを使用して、暗号化されたフォーマットのパスワードを生成します。
a. コマンドプロンプトを開き、<インデックスサーチホーム>/solr/server に移動します。
b. プレーンテキストのパスワードを引数として使用して、次のコマンドを実行します。
java -cp lib/jetty-util-9.2.13.v20150730.jar org.eclipse.jetty.util.security.Password <ユーザー名> <パスワード>
たとえば、次のコマンドを実行します。
java -cp lib/jetty-util-9.3.8.v20160314.jar org.eclipse.jetty.util.security.Password solr SolrRocks
結果として、次の出力が生成されます。
| PTC は、このツールを使用する場合に最も安全な暗号化オプションとして CRYPT を推奨します。 |
5. 新規ファイルを作成します。
<インデックスサーチホーム>/solr/server/etc/realm.properties
次のフォーマットを使用して、前のステップで生成された、暗号化されたパスワードを追加します。
<ユーザー名>: CRYPT:<暗号化されたパスワード>,<役割>
以下に例を示します。
solr: CRYPT:so3oR2FANmQ4Y,admin
6. 次のコマンドを使用して Solr を起動します。
◦ Windows
<インデックスサーチホーム>/bin/Index_Search_Server.bat start
◦ Unix
sh <インデックスサーチホーム>/bin/Index_Search_Server.sh start
7. Solr 管理者インタフェースを開き、ユーザー名とパスワードの入力を求められることを確認します。
http://<Solr ホスト名>:<Solr ポート>/solr
Solr のユーザーまたはパスワードの変更
Solr のユーザーまたはパスワードを変更するとき、Windchill Index Search のクライアントとサーバーの両方を更新する必要があります。
1. Windchill シェルを開き、以下のコマンドを実行して、Windchill Index Search クライアントのパスワードまたはユーザーを変更します。
xconfmanager -s wt.index.solrAdminUser=<新規ユーザー> -t codebase/WEB-INF/conf/index.solrAuth.properties -p
xconfmanager -s wt.index.solrAdminPassword=<新規パスワード> -t codebase/WEB-INF/conf/index.solrAuth.properties -p
2. Windchill を再起動します。
3. コマンドプロンプトから <インデックスサーチホーム>/bin に移動し、以下のコマンドを実行して、Windchill Index Search サーバーのパスワードまたはユーザーを変更します。
◦ Windows:
xconfmanager -s wt.index.server.solrAdminUser=<新規ユーザー> -t config/solrserver.properties -p
xconfmanager -s wt.index.server.solrAdminPassword=<新規パスワード> -t config/solrserver.properties -p
◦ Unix:
sh xconfmanager -s wt.index.server.solrAdminUser=<新規ユーザー> -t config/solrserver.properties -p
sh xconfmanager -s wt.index.server.solrAdminPassword=<新規パスワード> -t config/solrserver.properties -p
4. 前述の手順に従って <インデックスサーチホーム>/solr/server/etc/realm.properties を更新します。
5. Solr を再起動します。
スタンドアロンのインデックスサーチサーバー (Solr) の SSL の設定
開始する前に、証明書とキーが単一のファイルとして PEM フォーマットに変換されている必要があります。
| 証明書のみのファイルが使用できない場合、必要に応じて証明書とキーのファイルから生成できます。 1. keytool ユーティリティを使用して、JKS キーストアを PKCS12 フォーマットに変換します。 keytool -importkeystore -srckeystore solr-ssl.keystore.jks -destkeystore solr-ssl.keystore.p12 -srcstoretype jks -deststoretype pkcs12 2. openssl コマンドを使用して、認証書のみが含まれ、キーは含まれていない PKCS12 フォーマットのキーストアを PEM フォーマットに変換します。 openssl pkcs12 -nokeys -in solr-ssl.keystore.p12 -out solr-ssl.cacert.pem |
Windchill Index Search クライアントの設定
1. Windchill シェルを開き、次のコマンドを実行して、インデックスサーチクライアントがインデックスサーチサーバーに接続するときに使用するプロトコルを HTTPS に設定します。
xconfmanager -s wt.index.solrProtocol=https -t codebase/wt.properties -p
2. Windchill を再起動します。
Windchill Index Search サーバーの設定
1. 証明書 (JKS) ファイルを <インデックスサーチホーム>/solr/server/etc にコピーします。
2. 共通の SSL 関連のシステムプロパティを設定します。
SSL 設定をアクティブ化するには、次のファイルの SOLR_SSL_* で始まるプロパティをコメント解除し、更新します。
◦ Windows: bin\solr.in.cmd
以下に例を示します。
set SOLR_SSL_KEY_STORE=etc/solr-ssl.keystore.jks
set SOLR_SSL_KEY_STORE_PASSWORD=secret
set SOLR_SSL_TRUST_STORE=etc/solr-ssl.keystore.jks
set SOLR_SSL_TRUST_STORE_PASSWORD=secret
REM Require clients to authenticate
set SOLR_SSL_NEED_CLIENT_AUTH=false
REM Enable clients to authenticate (but not require)
set SOLR_SSL_WANT_CLIENT_AUTH=false
◦ Unix: bin/solr.in.sh
以下に例を示します。
bin/solr.in.sh example SOLR_SSL_* configuration
SOLR_SSL_KEY_STORE=etc/solr-ssl.keystore.jks
SOLR_SSL_KEY_STORE_PASSWORD=secret
SOLR_SSL_TRUST_STORE=etc/solr-ssl.keystore.jks
SOLR_SSL_TRUST_STORE_PASSWORD=secret
# Require clients to authenticate
SOLR_SSL_NEED_CLIENT_AUTH=false
# Enable clients to authenticate (but not require)
SOLR_SSL_WANT_CLIENT_AUTH=false
ここで、"secret" は証明書の作成時に指定されたパスワードです。
Solr キーストアのデフォルトパスワードを修正する場合、Solr サーバーの起動時に問題が発生しないようにするため、以下の手順を実行します。
a. solr.in.cmd (Windows) または solr.in.sh (Unix) でパスワードが正しいことを確認します。
b. <INDEX_SEARCH_HOME>/solr/server/etc/jetty-ssl.xml ファイルを開きます。
c. 以下のプロパティの値を正しいパスワードによって更新します。
<Set name="KeyStorePassword"><Property name="solr.jetty.keystore.password"
default="<enter the correct password>"/></Set>
<Set name="TrustStorePassword"><Property name="solr.jetty.truststore.password"
default="<enter the correct password>"/></Set>
d. jetty-ssl.xml ファイルを保存して Solr サーバーを起動します。
3. 証明書ファイルを JVM トラストストア (Windchill の JDK/JVM のみ) に追加します。
a. Windchill が使用する Java の場所に移動し、<Java>/jre/lib/security で cacerts ファイルのパスを確認します。
b. <Java>/jre/bin に移動し、新しい証明書をインポートします。cacerts に書き込むためのアクセス許可を持つユーザーとして keytool ユーティリティを実行します。
keytool -import -file <証明書ファイル> -alias <一意の名前> -keystore <cacerts ファイルへのパス>
次に例を示します。
keytool -import -file D:\SolrWithSSL\solr-5.4.1\server\etc\solr-ssl.cacert.pem -alias Key_Alias -keystore ../lib/security/cacerts
4. SSL を使用するように Windchill が設定されている場合、Windchill の外部で使用されている Java クライアントが接続するには証明書が必要です。
このため、インデックスサーチサーバーによって使用されている JVM に証明書をインポートする必要があります。これにより、インデックスサーチサーバーは Windchill に接続し、インデックシング用のドキュメントをダウンロードできます。
証明書ファイルを JVM トラストストア (Solr サーバーの JDK/JVM) に追加します。
a. Solr サーバーが使用する Java の場所に移動し、<JAVA>/jre/lib/security で cacerts ファイルのパスを確認します。
b. <Java>/jre/bin に移動し、証明書をインポートします。cacerts に書き込むためのアクセス許可を持つユーザーとして keytool ユーティリティを実行します。
keytool -import -file <証明書ファイル> -alias <一意の名前> -keystore <cacerts ファイルへのパス>
次に例を示します。
keytool -import -file D:\SolrWithSSL\solr-5.4.1\server\etc\solr-ssl.cacert.pem -alias Key_Alias -keystore ../lib/security/cacerts
| JVM キーストアのデフォルトのパスワードは "changeit" です。 |
5. Windchill とインデックスサーチサーバーを再起動し、Solr 管理インタフェースに移動して、Solr が SSL とともに実行されていることを確認します。
| SSL の既知の問題については、次のサイトを参照してください。 |
