はじめに

このページでは Ubuntu 18.04 に Alfresco Search Services をインストールする手順について説明します。

前提として、Alfresco SSL Generator を実行済みであるとします。

インストール対象の Alfresco Content Services でサポートされているバージョンのものを選択してください。

https://docs.alfresco.com/content-services/latest/support/

本手順に記載のバージョンは、適宜読み替えてください。

1．事前準備

あらかじめ契約している Alfresco のサポートポータルから alfresco-search-services の zip ファイルをインストール先のサーバに配置しておきます。

Alfresco 実行用ユーザを作成していない場合は次のコマンドで作成します。

実行コマンド

$ sudo useradd alfresco

2．Alfresco Search Services のインストール

ログ格納用ディレクトリを作成します

実行コマンド

$ sudo mkdir -p /var/log/alfresco/solr \
&& sudo chown -R alfresco:alfresco /var/log/alfresco

Alfresco Search Services のインストールディレクトリを作成します。

実行コマンド

$ sudo mkdir /opt/alfresco

あらかじめ配置した alfresco-search-services の zip ファイルを展開します。

実行コマンド

$ cd /opt/alfresco/ \
&& sudo unzip /home/ubuntu/alfresco-search-services-2.0.1.zip \
&& sudo mv alfresco-search-services search-services

Alfresco SSL Generator で作成された keystores ディレクトリ配下の solr ディレクトリの中身を keystore フォルダに配置します（Keystore directory structure）

実行コマンド

$ sudo mkdir /opt/alfresco/search-services/solrhome/keystore \
&& sudo cp /home/ubuntu/work/alfresco-ssl-generator-master/ssl-tool/keystores/solr/* /opt/alfresco/search-services/solrhome/keystore/

ログの設定を変更します

実行コマンド

$ sudo vi /opt/alfresco/search-services/logs/log4j.properties

編集内容

（省略）
 
#- size rotation with log cleanup.
#log4j.appender.file=org.apache.log4j.RollingFileAppender　←コメントアウト
#log4j.appender.file.MaxFileSize=4MB　←コメントアウト
#log4j.appender.file.MaxBackupIndex=9　←コメントアウト
 
#- File to log to and log format
log4j.appender.file=org.apache.log4j.DailyRollingFileAppender　←追加
log4j.appender.file.File=${solr.log}/solr.log
log4j.appender.file.Append=true　←追加
log4j.appender.file.DatePattern='.'yyyy-MM-dd　←追加
log4j.appender.file.layout=org.apache.log4j.PatternLayout　←追加
log4j.appender.file.layout.ConversionPattern=%d{yyyy-MM-dd} %d{ABSOLUTE} %-5p [%c] [%t] %m%n　←追加
#log4j.appender.file.layout=org.apache.log4j.EnhancedPatternLayout
#log4j.appender.file.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss.SSS} %-5p (%t) [%X{collection} %X{shard} %X{replica} %X{core}] %c{1.} %m%n　←コメントアウト
 
（省略）

solr.in.sh ファイルを編集します（Installing and configuring Search Services with mutual TLS）

実行コマンド

$ sudo vi /opt/alfresco/search-services/solr.in.sh

編集内容

（省略）
 
SOLR_LOGS_DIR=/var/log/alfresco/solr ←編集
LOG4J_PROPS=/opt/alfresco/search-services/logs/log4j.properties ←編集
 
SOLR_ALFRESCO_PORT=8983 ←追加
#SOLR_SSL_KEY_STORE=/opt/alfresco/search-services/solrhome/keystore/ssl.repo.client.keystore ←編集
#SOLR_SSL_KEY_STORE_PASSWORD=alfresco ←編集
#SOLR_SSL_KEY_STORE_TYPE=JCEKS ←編集
#SOLR_SSL_TRUST_STORE=/opt/alfresco/search-services/solrhome/keystore/ssl.repo.client.truststore ←編集
#SOLR_SSL_TRUST_STORE_PASSWORD=alfresco ←編集
#SOLR_SSL_TRUST_STORE_TYPE=JCEKS ←編集
#SOLR_SSL_NEED_CLIENT_AUTH=true ←編集
#SOLR_SSL_WANT_CLIENT_AUTH=false ←編集
 
（中略）
 
##### 以下は Content Services と Search Services を別のサーバにそれぞれ立てる場合に必要
SOLR_SOLR_HOST=<Search Services のホスト>
SOLR_ALFRESCO_HOST=<Content Services のホスト>

組織間で複数の言語を使用する場合は、shared.properties ファイルを更新します

実行コマンド

$ sudo vi /opt/alfresco/search-services/solrhome/conf/shared.properties

編集内容

alfresco.cross.locale.datatype.0={http://www.alfresco.org/model/dictionary/1.0}text ←コメント解除
alfresco.cross.locale.datatype.1={http://www.alfresco.org/model/dictionary/1.0}content ←コメント解除
alfresco.cross.locale.datatype.2={http://www.alfresco.org/model/dictionary/1.0}mltext ←コメント解除
 
##### 以下はスペルチェック機能がらみ
alfresco.suggestable.property.0={http://www.alfresco.org/model/content/1.0}name ←コメント解除
alfresco.suggestable.property.1={http://www.alfresco.org/model/content/1.0}title  ←コメント解除
alfresco.suggestable.property.2={http://www.alfresco.org/model/content/1.0}description  ←コメント解除
alfresco.suggestable.property.3={http://www.alfresco.org/model/content/1.0}content ←コメント解除

デフォルトでは、スケーラビリティの目的で提案が無効になっているため、スペルチェック機能はSearch Servicesでは機能しません。

solrcore.properties ファイルを編集します（参考： Setting up your certificates , Solr core configuration properties）

実行コマンド

$ sudo vi /opt/alfresco/search-services/solrhome/templates/rerank/conf/solrcore.properties

編集内容

alfresco.secureComms=https
alfresco.host=localhost
alfresco.port=8080
alfresco.port.ssl=8443

conf ディレクトリ配下にファイルをコピーします

実行コマンド

$ sudo cp -p /home/ubuntu/work/alfresco-ssl-generator-master/ssl-tool/keystores/solr/* /opt/alfresco/search-services/solrhome/templates/rerank/conf/

所有者を Alfresco 実行用ユーザに変更します。

実行コマンド

$ sudo chown -R alfresco:alfresco /opt/alfresco/ \
&& find /opt/alfresco/ ! -user alfresco | wc -l

実行結果

Alfresco 実行用ユーザに切り替えます。

実行コマンド

$ sudo su - alfresco

初回起動します（2回目以降の起動時はオプション不要）

実行コマンド

$ /opt/alfresco/search-services/solr/bin/solr start -a "-Dcreate.alfresco.defaults=alfresco,archive"

ブラウザで以下の URL にアクセスし、画面が遷移することを確認します。

	項目名	値
1	URL	http://<IPアドレスもしくはホスト名>:8983/solr

遷移できることを確認したら、停止します。

実行

$ /opt/alfresco/search-services/solr/bin/solr stop
$ exit

solr.in.sh ファイルを編集します（Installing and configuring Search Services with mutual TLS）

実行コマンド

# vi /opt/alfresco/search-services/solr.in.sh

編集内容

（省略）
 
SOLR_SSL_KEY_STORE=/opt/alfresco/search-services/solrhome/keystore/ssl.repo.client.keystore　←コメント解除
SOLR_SSL_KEY_STORE_PASSWORD=alfresco　←コメント解除
SOLR_SSL_KEY_STORE_TYPE=JCEKS　←コメント解除
SOLR_SSL_TRUST_STORE=/opt/alfresco/search-services/solrhome/keystore/ssl.repo.client.truststore　←コメント解除
SOLR_SSL_TRUST_STORE_PASSWORD=alfresco　←コメント解除
SOLR_SSL_TRUST_STORE_TYPE=JCEKS　←コメント解除
SOLR_SSL_NEED_CLIENT_AUTH=true　←コメント解除
SOLR_SSL_WANT_CLIENT_AUTH=false　←コメント解除
 
（省略）

3．サービス設定

Alfresco Search Services のサービスファイルを作成します。

実行コマンド

$ sudo vi /etc/systemd/system/search-services.service

編集内容

[Unit]
Description=Alfresco Search Services
   
[Service]
Restart=no
Type=forking
User=alfresco
ExecStart=/opt/alfresco/search-services/solr/bin/solr start
ExecStop=/opt/alfresco/search-services/solr/bin/solr stop
     
[Install]
WantedBy=multi-user.target

Alfresco Search Services の自動起動を設定します。

実行コマンド

$ sudo systemctl daemon-reload \
&& sudo systemctl enable search-services \
&& systemctl is-enabled search-services \
&& systemctl list-unit-files --type=service | grep search-services

実行結果

Created symlink from /etc/systemd/system/multi-user.target.wants/search-services.service to /etc/systemd/system/search-services.service.
enabled
search-services.service                       enabled

4．起動

Alfresco Search Services を起動します。

実行コマンド

$ sudo systemctl start search-services && systemctl is-active search-services

実行結果

active

Alfresco Content Services Documentation

Alfresco Search Services のインストール（Ubuntu）

Analytics

はじめに

1．事前準備

2．Alfresco Search Services のインストール

3．サービス設定

4．起動

Related content