開発用環境の構築手順

対象OS

Windows

開発に必要なツール一覧

開発に必要なツールをダウンロードしてください。

ツール名	バージョン	ダウンロードURL
Eclipse (Pleiades)	2018-09 Full Edition 以降	http://mergedoc.osdn.jp/
AdoptOpenJDK	8系 / HotSpot	https://adoptopenjdk.net/
Git	最新	https://git-scm.com/
Maven	3系	https://maven.apache.org/download.cgi

動作確認に必要なツール一覧

動作確認に必要なツールをダウンロードしてください。

ツール名	バージョン	ダウンロードURL
Tomcat	9.0系	Pleiades同梱のものを使用するため個別の導入は行わない
Elasticsearch	6.6.1	https://www.elastic.co/jp/downloads/past-releases/elasticsearch-6-6-1
ActiveMQ	5.15系	http://activemq.apache.org/download-archives.html
Nginx	1.14系	http://nginx.org/download/nginx-1.14.0.zip

各種ツールの初期設定

Eclipse

[Window]->[設定]からインストール済のJREにAdoptOpenJDKを追加します。
追加したAdoptOpenJDKをデフォルトに設定します。
[Window]->[設定]からサーバー・ランタイム環境にTomcat9のサーバを追加します。
サーバのJREにはAdoptOpenJDKを設定します。

JDK

環境変数(JAVA_HOME)を設定します。

変数：JAVA_HOME
値：javaのインストールディレクトリパス(例：C:\Program Files\Java\openjdk-1.8.0.191)

システム環境変数Pathに以下を追加します。

%JAVA_HOME%\bin

Git

C:¥Users¥[user]¥.gitconfigに、以下の記述を追加します。

[core]
    autocrlf = false
    ignorecase = false

プロキシ環境下に開発環境を構築する場合、以下も追記します。
※{}の値はユーザ自身の情報を入力します。

[http]
    proxy = {protocol}://{username}:{pass}@{host}:{port}
[https]
    proxy = {protocol}://{username}:{pass}@{host}:{port}

Maven

環境変数(M2_HOME)を設定します。

変数：M2_HOME
値：mavenのインストールディレクトリパス（例：C:\Program Files\apache-maven-3.5.4）

システム環境変数Pathに以下を追加します。

%M2_HOME%\bin

プロキシ環境下に開発環境を構築する場合、apache-maven-3.5.4\conf\settings.xmlに以下の記述を追加します。
※{}の値はユーザ自身の情報を入力します。

<proxies>
  <proxy>
      <id>proxy00</id>
      <active>true</active>
      <protocol>http</protocol>
      <username>{username}</username>
      <password>{pass}</password>
      <host>{host}</host>
      <port>{port}</port>
      <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
  </proxy>
  <proxy>
      <id>proxy01</id>
      <active>true</active>
      <protocol>https</protocol>
      <username>{username}</username>
      <password>{pass}</password>
      <host>{host}</host>
      <port>{port}</port>
      <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
  </proxy>
</proxies>

Elasticsearch

elasticsearch-6.6.1\config\elasticsearch.ymlの修正

elasticsearch.ymlに以下の記述を追加します。

cluster.name: 【任意の名前】

network.host: 0.0.0.0
action.auto_create_index: ".watches,.triggered_watches,.watcher-history-*"
http.cors.enabled: true
http.cors.allow-origin: "*"
indices.fielddata.cache.size: 80%（任意:ヒープメモリの何％をデータキャッシュとして使用するか）

ActiveMQ

特になし

Tomcat

特になし

Nginx

Nginxの初期設定のため、nginx-1.14.0\conf配下のnginx.confファイルを修正します。

httpの中に以下記述を追加します。

    ignore_invalid_headers on;
    proxy_set_header Host $http_host;
    proxy_http_version 1.1;
    large_client_header_buffers 4 55k;

    map $http_upgrade $connection_upgrade {
      default upgrade;
      '' close;
    }

http.server.location /の内容を以下記述に変更します。

            #root   html;
            #index  index.html index.htm;

            if ($request_uri ~ [\x00-\x20\x22\x3c\x3e\x5b-\x5e\x60\x7b-\x7d\x7f]) {
                return 400;
            }

            if ($request_uri ~* ([^?]+)\?(.*)) {
              set $personium_path $1;
              rewrite .* /personium-core$personium_path break;
            }
            if ($is_args = "") {
              rewrite .* /personium-core$request_uri break;
            }

            proxy_pass http://localhost:8080;
            proxy_set_header X-Forwarded-For $remote_addr;
            proxy_set_header X-Forwarded-Proto http;
            proxy_set_header X-Forwarded-Path $request_uri;
            proxy_set_header Host $http_host;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection $connection_upgrade;
            proxy_hide_header X-Powered-By;
            proxy_hide_header X-Rack-Cache;
            proxy_hide_header X-Content-Digest;
            proxy_hide_header X-Runtime;

Eclipseへのプロジェクトインポート

personium-coreとpersonium-engineをプロジェクトとしてインポートします。

GitHubのリポジトリからcloneします。
https://github.com/personium/personium-core.git
https://github.com/personium/personium-engine.git
Eclipseのmavenプロジェクトとしてそれぞれをインポートします。
それぞれの/src/main/resourcesにpersonium-unit-config.propertiesを作成します。

io.personium.core.es.cluster.nameの値はElasticsearchのconfigファイル（elasticsearch.yml）
のcluster.nameで設定した値を指定します。

/personium_core/src/main/resources/personium-unit-config.properties

#################################################
# personium-core configurations
#################################################
# general configurations
io.personium.core.masterToken=personiumio
io.personium.core.unitScheme=http
#io.personium.core.unitPort=9998
#io.personium.core.unitPort=8080
io.personium.core.unitPort=
#io.personium.core.unitPath=/personium-core
io.personium.core.unitPath=
io.personium.core.pathBasedCellUrl.enabled=true

io.personium.core.unitUser.issuers=personium-localunit:/unitadmin/ personium-localunit:/unitadmincell/ personium-localunit:/unitusercell/

# cell configurations
io.personium.core.cell.relayhtmlurl.default=https://app-cc-home.demo.personium.io/__/index.html

io.personium.core.es.cluster.name=【elasticsearch.ymlで設定した値】
io.personium.core.es.retryTimes=10

io.personium.core.plugin.path=/personium/plugins
io.personium.core.blobStore.root=/personium_nfs/personium-core/dav
io.personium.core.bar.tmp.dir=/personium_nfs/personium-core/bar
io.personium.core.event.log.current.dir=/personium_nfs/personium-core/eventlog
io.personium.core.cellSnapshot.root=/personium_nfs/personium-core/snapshot

# lock type configurations
io.personium.core.lock.type=inProcess

# cache configurations (memcached protocol)
io.personium.core.cache.type=inProcess
io.personium.core.cache.cell.enabled=false
io.personium.core.cache.box.enabled=false
io.personium.core.cache.schema.enabled=false

# security configurations
io.personium.core.security.secret16=gv7hpmmf5siwj5by
io.personium.core.security.auth.password.salt=voAbizvF
io.personium.core.security.dav.encrypt.enabled=false

# Davlimit configurations
io.personium.core.dav.childresource.maxnum=30
io.personium.core.dav.depth.maxnum=5

# OData $links configurations
io.personium.core.odata.links.NtoN.maxnum=40

/personium_engine/src/main/resources/personium-unit-config.properties

#################################################
# personium-engine configurations
#################################################
# general configurations
io.personium.core.masterToken=personiumio

io.personium.core.blobStore.root=/personium_nfs/personium-core/dav

# security configurations
io.personium.core.security.secret16=secret167pm5m4y6

※各設定の説明はUnitの設定一覧を参照してください。

※Eclipse上でmavenやpom.xml関連のビルドエラーが出ている場合、
以下に記載した手順を実施してください。

コマンドプロンプト等でpom.xmlが存在するディレクトリに移動します。
以下のコマンドを実行します。
```
mvn clean package -DskipTests
```
コマンドがSUCCESSで終了しなかった場合は原因を取り除いて再度実施します。
Eclipse上で対象プロジェクトを右クリック→[Maven]→[プロジェクトの更新]→[OK]を選択します。

起動確認方法

コマンドは管理者権限を持つユーザで実行してください。

1. Elasticsearch起動確認

コマンドプロンプト等でElasticsearchのインストールディレクトリに移動します。

> cd Elasticsearchインストールディレクトリ

以下コマンドを実行します。

> bin\elasticsearch-service install (初回のみ)
> bin\elasticsearch-service start

ブラウザでhttp://localhost:9200にアクセスします。

以下のように出力されると起動成功となります。

{
  "name" : "MODAM",
  "cluster_name" : "【elasticsearch.ymlで設定した値】",
  "cluster_uuid" : "VM2fJ2hXQRSI4PsYhJBtLA",
  "version" : {
    "number" : "6.6.1",
    "build_flavor" : "default",
    "build_type" : "zip",
    "build_hash" : "1fd8f69",
    "build_date" : "2019-02-13T17:10:04.160291Z",
    "build_snapshot" : false,
    "lucene_version" : "7.6.0",
    "minimum_wire_compatibility_version" : "5.6.0",
    "minimum_index_compatibility_version" : "5.0.0"
  },
  "tagline" : "You Know, for Search"
}

2. ActiveMQ起動確認

コマンドプロンプト等でActivemqのインストールディレクトリに移動します。

> cd Activemqインストールディレクトリ

以下コマンドを実行します。

> bin\activemq start

ブラウザでhttp://localhost:8161にアクセスします。
管理画面が表示されると起動成功となります。

bin/win64/InstallService.bat を走行させることでサービス化することもできます。参考: https://activemq.apache.org/java-service-wrapper,

3. 開発用サーバ起動確認

Eclipse上で[personium-core]プロジェクトを右クリック→[実行]→[サーバで実行]を選択します。

サーバは初期設定で追加したTomcat9のサーバを選択して実行します。

※Tomcat9の起動でタイムアウト時間を超えて起動エラーになることがあります。
EclipseでTomcat起動時のタイムアウト時間を変更してください。

ブラウザでhttp://localhost:8080/personium-core/にアクセスします。
以下のように出力されると起動成功となります。

{"unit":{"path_based_cellurl_enabled":true,"url":"http:\/\/localhost\/"}}

4. Nginx起動確認

コマンドプロンプト等でNginxインストールディレクトリに移動します。

> cd Nginxインストールディレクトリ

以下のコマンドを実行します。

> start nginx

ブラウザでhttp://localhostにアクセスします。
以下のように出力されると起動成功となります。

{"unit":{"path_based_cellurl_enabled":true,"url":"http:\/\/localhost\/"}}

Personium

1.7.21

Personiumの準備

アプリの開発

サーバ運用

Unit管理

旧ドキュメント

認可

Box/Barファイル

コレクション