クロスプラットフォーム版 - CData Arc Documentation

のクロスプラットフォーム版には組み込みEclipse Jetty Web サーバーが含まれ、外部サーバー構成なしでを実行できます。さらに、インストールにはApache Tomcat、Eclipse Jetty、またはIBM WebSphere Liberty などのJava サーブレットコンテナにデプロイ可能なWAR ファイルが含まれています。の使用には、Java 17 またはそれ以降のバージョンがマシンにインストールされている必要があります。外部Java サーブレットコンテナへのデプロイにはサーブレット3.0（Jetty 8+、Tomcat 7+、WebSphere Liberty 8.5+、など）が必要です。

のデプロイ方法に関わらず、AppDirectory 内のファイルおよびフォルダは、アプリケーションを実行するユーザーによって読み取り / 書き込み可能である必要があります。Java 版のセットアップに同梱されるサービスインストーラーは、cdatarc を実行しているユーザーとして使用します。アプリケーションが別のユーザーで以前実行されていて、cdatarc ユーザーがアプリケーションを実行するために必要な権限を復元したい場合は、以下のようなコマンドを使用してください：sudo chown -R cdatarc:cdatarc /opt/arc

Windows

Windows の場合、はサービスとしてデフォルトでインストールされます。アプリケーションにアクセスするには、まず、サービスが起動していることを確認する必要があります。サービスが起動したら、Web ブラウザを開いてURL にhttp://localhost:8080/ を入力すると、管理コンソールにアクセスできます。また、サービスを使用せずにjava コマンドを介してアプリケーションを実行することもできます。はサービスの利用を推奨していますが、特定の構成ではこちらの方法が有効です。

サービスの起動と停止

サービスの開始と停止は、次のいずれかの方法で行います：

スタートメニューのショートカット（推奨）
サービス管理コンソール
コマンドプロンプトコマンド

スタートメニューのショートカット

インストーラーは、アプリケーションを簡単に使用できるスタートメニューのショートカットを作成します。これらのショートカットにアクセスするには、スタートメニューを開いてフォルダを展開します。以下のショートカットが利用可能です：

管理コンソールを起動：デフォルトのWeb ブラウザでWeb ブラウザウィンドウを開き、管理コンソールURL http://localhost:8080/ にアクセスします。サービスが起動していない場合、Web ブラウザはエラーを返します。
を起動：サービスを開始します。デフォルトでは、このサービスはWindows 起動時に実行されるため、アプリケーションを実行するたびにこのコマンドを実行する必要はありません。
を停止：サービスを停止します。このアクションは、のアップグレード時に必要です。

サービス管理コンソール

サービス管理コンソールを開くには、スタートメニューを開きサービスと入力します。表示されたサービスアプリケーションを選択します。というサービスが表示されるまでスクロールダウンします。サービスが起動している場合は、状態カラムに実行中と表示されます。サービスを右クリックすると、サービスを開始、停止、再開するオプションにアクセスできます。

コマンドプロンプト

高度なユーザーは、Windows のコマンドプロンプトを使用して、サービスに対して手動でコマンドを発行することができます。コマンドプロンプトを開き、ディレクトリをインストールフォルダに変更します（デフォルトはC:\Program Files\CData\CData Arc です）。

Microsoft PowerShell ウィンドウを使用してこれらのコマンドを発行することもできますが、構文が若干異なります。PowerShell を使用する際は、コマンドを適宜修正してください。

サービスを開始するには、次のコマンドを実行します：

arc.exe -start

サービスを再開または停止するには、次のコマンドを実行します：

arc.exe --restart --ServiceName "CData Arc"
arc.exe --stop --ServiceName "CData Arc"

サービスを使わずに起動

サービスを開始せずにを実行するには、インストールフォルダでコマンドプロンプトを開きます。アプリケーションを開始するには、次のコマンドを実行します：

java -jar arc.jar

Linux

を任意の場所にインストールしたら、をサービスとして実行するか、アプリケーションを手動で実行することができます。は、重要なアプリケーションにを使用する場合は、サービスの使用をお勧めします。

をサービスとして実行

をサービスとして実行すると、アプリケーションをユーザープロセスから独立して実行し、再起動時に自動的に再起動することができます。これは、重要なアプリケーションに推奨される方法です。では、Linux 上でアプリケーションを管理するデーモンの作成を推奨しています。インストールパッケージに含まれるスクリプトで、これを自動的に行うことができます。必要に応じて、手動でデーモンを作成することも可能です。システムが systemd デーモンマネージャーを使用している場合に、デーモンを設定する最も安全な方法は、インストールパッケージに含まれているスクリプトを実行することです：

bash ./service.sh

このスクリプトは、arc.service という名前のデーモンを作成します。その後、systemctl を使用してデーモンを管理できます：

systemctl enable arc
systemctl start arc

スタンドアロンアプリケーションの実行

サービスを作成せずにを開始するには、ターミナルでインストールディレクトリのarc.jar ファイルを開き、次のように設定ファイルを引数として指定します：

java -jar arc.jar

組み込みJetty サーバーの構成

は、あらゆる環境ですぐに動作するようあらかじめ設定されています。ただし、インストールディレクトリにarc.properties ファイルを生成することで、で公開されているデータへのアクセス方法をカスタマイズできます（Windows の場合、インストールディレクトリのデフォルトはC:\Program Files\CData\CData Arc です）。すべてのarc.properties 設定オプションについて詳しくは、arc.properties Configuration を参照してください。

これらの設定オプションは、実装内のすべての.properties ファイルで利用可能です。

arc.properties ファイルの生成

組み込みJetty サーバーをカスタマイズする前に、arc.properties ファイルを作成する必要があります。arc.jar があるインストールディレクトリで以下のコマンドを実行します：

java -jar arc.jar -GenerateProperties

これで、インストールディレクトリにarc.properties ファイルが作成されます。このファイルには、ポートを変更したりTLS/SSL を有効化したりするために変更できるパラメータが含まれています。

一度このファイルを生成すると、へのアップグレードでは上書きされません。

ポートの変更

組み込みサーバーがリッスンするポートを変更するには：

InstallationDirectory にあるarc.properties ファイルを見つけ、テキストエディタで開きます。
ポートが設定されている次の行を探します： cdata.http.port=8080
この値を、希望するポート番号に変更します。

TLS/SSL の有効化

TLS/SSL 接続（HTTPS）を有効化する場合にも、以下のように、 InstallationDirectory のarc.properties ファイルを修正します：

cdata.tls.keyStoreType 設定を、使用するキーストアのタイプに設定します。有効な値には、jks、pkcs12、およびjceks が含まれます。
cdata.tls.keyStorePath 設定を、使用するキーストアのパスに設定します。${cdata.home} は、 InstallationDirectory を参照するために使用される場合があることに注意してください。
cdata.tls.keyStorePassword 設定を、キーストアのパスワードに設定します。
cdata.tls.port 設定を、サーバーをホストするために使用するポートに設定します。
（オプション）cdata.http.port 設定を、プレーンテキスト接続を無効にするために空の文字列に設定します。

最終的にはこのようになります：

;; HTTP
cdata.http.port=

;; TLS
cdata.tls.port=8443
cdata.tls.keyStoreType=PKCS12
cdata.tls.keyStorePath=${cdata.home}/mycertificate.pfx
cdata.tls.keyStorePassword=mypassword

で設定するために外部秘密鍵を取得する場合は、必ず証明書の所有者を（cdatarc:cdatarc）をホストするために使用されるサービスアカウントに変更してください。

を別の.properties ファイルに指定する

-config パラメータを使用して、をデフォルトのarc.properties ファイル以外の設定ファイルに指定します。例えば、次のコマンドを実行すると、はtest.properties ファイルを検索します：

java -jar arc.jar -config test

Jetty XML ファイルの生成

ほとんどのデプロイメントで、arc.properties ファイルは、組み込みJetty サーバーに必要なすべての設定オプションを提供します。ただし、より複雑なデプロイメントが必要な場合は、Jetty XML ファイルを生成し、そこからさらに修正を加えることができます。このファイルを生成するには、arc.jar があるインストールディレクトリで以下のコマンドを実行します：

java -jar arc.jar -GenerateXML

コマンドが完了すると、webapp フォルダにarc.xml 設定ファイルが表示されます。そのフォルダに保存されている限り、アプリケーションの起動に使用されます。

サーバーの起動と停止

service.sh スクリプトを使用してサービスをセットアップする場合は、サービスとして実行を参照してください。それ以外の場合は、インプロセスで実行セクションが該当します。

インプロセスで実行

セットアップ中にアプリケーションダウンロードから抽出されるarc.jar ファイルを実行して、組み込みJetty サーバーを起動します。このファイルを実行してサーバーを起動するには、以下に示すような標準のJava 構文を使用できます：

java -jar arc.jar

サーバーを停止するには、このコマンドに-stop パラメータを渡します：

java -jar arc.jar -stop

サービスとして実行

サービス名としてarc を参照して、標準のシステムサービスコマンドを使用してサービスを操作できます。サービスを起動するには、次のコマンドを送信します：

systemctl start arc

サービスを停止するには、次のコマンドを送信します：

systemctl stop arc

サービスを再開するには、次のコマンドを送信します：

systemctl restart arc

LDAP 認証の設定

次の手順では、組み込みJetty Web サーバーを使用する場合に、LDAP を使用してユーザーを認証するようにを設定します。

arc.properties の設定

まだ存在しない場合は、次のコマンドを使用してデフォルトのarc.properties ファイルを生成します： java -jar arc.jar -GenerateProperties 次の必須設定は、組み込みJetty サーバーにLDAP を認証に使用するよう指示します： cdata.loginService.ldap.enabled=true 他のセクションと同じように、ファイル内でこれをセクション分けすることもできます：

;; LDAP
cdata.loginService.ldap.enabled=true

に必要な最小限の設定に加え、ご利用のLDAP サーバーに必要な追加設定を挿入します。に必要な最小限の設定は次のとおりです：

cdata.loginService.ldap.hostname
cdata.loginService.ldap.bindDn
cdata.loginService.ldap.bindPassword

利用可能な設定のリストは以下のとおりです：

cdata.loginService.ldap.userIdAttribute
cdata.loginService.ldap.debug
cdata.loginService.ldap.forceBindingLogin
cdata.loginService.ldap.bindPassword
cdata.loginService.ldap.roleMemberAttribute
cdata.loginService.ldap.useLdaps
cdata.loginService.ldap.roleBaseDn
cdata.loginService.ldap.bindDn
cdata.loginService.ldap.userPasswordAttribute
cdata.loginService.ldap.hostname
cdata.loginService.ldap.userRdnAttribute
cdata.loginService.ldap.roleObjectClass
cdata.loginService.ldap.port
cdata.loginService.ldap.authenticationMethod
cdata.loginService.ldap.userBaseDn
cdata.loginService.ldap.contextFactory
cdata.loginService.ldap.userObjectClass
cdata.loginService.ldap.roleNameAttribute

以下はarc.properties の完全なLDAP セクションの例です：

;; LDAP
cdata.loginService.ldap.enabled=true
cdata.loginService.ldap.bindDn="CN=ldapuser,DC=example,DC=org"
cdata.loginService.ldap.hostname="127.0.0.1"
cdata.loginService.ldap.bindPassword="Adminpassword1"

cdata.loginService.ldap.port="1389"
cdata.loginService.ldap.debug=true
cdata.loginService.ldap.authenticationMethod="simple"
cdata.loginService.ldap.userBaseDn="DC=example,DC=org"
cdata.loginService.ldap.userRdnAttribute="cn"
cdata.loginService.ldap.userPasswordAttribute="userPassword"
cdata.loginService.ldap.forceBindingLogin="true"
cdata.loginService.ldap.roleBaseDn="DC=example,DC=org"
cdata.loginService.ldap.roleNameAttribute="cn"
cdata.loginService.ldap.roleMemberAttribute="member"
cdata.loginService.ldap.useLdaps="false"

でLDAP ユーザーを作成する

ユーザーがLDAP サーバー経由でにログインできるようにするには、各LDAP ユーザーをに追加する必要があります。これにより、は設定済みのLDAP サーバーでログインしようとしているユーザーを相互参照できるようになります。各ユーザーを作成するには、以下の手順に従います（ユーザー管理の詳細については、ユーザー管理とロールを参照してください）：

を起動し、管理者ユーザーとしてログインします。
へのアクセスが必要なすべてのLDAP ユーザーを作成します。ナビゲーションバーの歯車アイコンをクリックして、ユーザーを選択します。ユーザーはLDAP ユーザーと同一でなければなりません。例えば、LDAP ユーザーがuser01 やuser02 である場合、でも同じユーザー名を使用する必要があります。

すべてのユーザーを追加したら、アプリケーションを停止できます。

設定をテストする

必要なLDAP 設定を記載したarc.properties ファイルを作成し、LDAP ユーザーをに追加し、LDAP サーバーの要件に基づいて構成が正しいことを確認したら、機能をテストすることができます。 java -jar arc.jar を使用してを起動するか、サービスを起動します。ログイン画面が表示されたら、LDAP ユーザーの1つを使ってログインを試みます。LDAP サーバーにあるユーザー名とパスワードを入力します（これはのユーザーセクションに入力したものと同じである必要があります）。ログインプロセスでは、ログインしたユーザーをで設定されたユーザーと照合し、次にLDAP サーバーと照合して、ユーザーが存在し、アプリケーションへのアクセスが許可されていることを確認します。設定が成功した場合、そのユーザーとしてアプリケーションにログインします。

LDAP 設定のトラブルシューティング

LDAP サーバーへの認証に問題がある場合、はApache Directory Studio でLDAP 接続とフィルターをテストすることを推奨します。同じ接続設定と検索フィルターをarc.properties またはlogin.config ファイルに適用できます。

認証失敗のデバッグログの作成

arc.properties ファイルで次の設定を使用してデバッグを有効化できます：cdata.loginService.ldap.debug。追加のログ情報をコンソール出力とWeb サーバーログに送ることもできます。アプリケーションインストールディレクトリ内のarc.properties ファイルおよびwebapps フォルダと同じ場所に、arc.logging.properties という名前のファイルを作成し、以下の内容を記述します：

handlers = java.util.logging.ConsoleHandler, arc.ArcRolloverFileHandler
java.util.logging.ConsoleHandler.level = FINE
arc.ArcRolloverFileHandler.filename = yyyy_mm_dd.log
arc.ArcRolloverFileHandler.formatter = java.util.logging.SimpleFormatter
arc.ArcRolloverFileHandler.level = FINE
# Enable LDAP and Jetty JAAS module debug logs
org.eclipse.jetty.jaas.level = FINE
com.sun.jndi.ldap.level = FINE

サービスを再起動すると、LDAP 認証の試行に関する追加のログがコンソールに出力されます。

Tomcat での設定

WAR ファイルの配布

Tomcat にWAR ファイルを配布するには2つのオプションがあります。

webapps フォルダにWAR ファイルをコピーする。
Tomcat の管理コンソール内でWAR ファイルの配布を行う。Apache Tomcat のドキュメントには、この方法のさらに詳しい説明があります。お使いのTomcat のバージョンのドキュメントを参照してください。

WAR ファイルがTomcat のファイルアップロードで許可されているデフォルトの最大サイズを超える可能性があります。デプロイメント中のエラーを解決するために、Manager アプリケーションのweb.xml ファイルを変更して、より大きなファイルを許可することができます。Tomcat の設定に応じて、このファイルは/usr/share/tomcat7-admin/manager/WEB-INF、または類似ディレクトリにある場合があります。このファイルでは、許容される最大ファイルサイズ（バイト単位）を変更できます。例えば、200MB のWAR ファイルのデプロイメントを許容するには、次の値を変更して許容される最大ファイルサイズを変更します：

<multipart-config>
     <!-- 200 MB max -->
  <max-file-size>209715200</max-file-size>
  <max-request-size>209715200</max-request-size>
  <file-size-threshold>0</file-size-threshold>
</multipart-config>

Java 認証・承認サービス（JAAS）の設定

がアプリケーション内で動的にユーザーを管理できるようにするには、次のガイドで説明するようにJAAS を設定する必要があります。このガイドでは、Tomcat の構成を制御し、コンテキストのオーバーライドを定義するためにarc.xml を使用します。は、Tomcat の構成を制御するためにserver.xml の代わりにarc.xml を使用することを推奨しています。また、APP_DIRECTORY やAPP_DB などのアプリケーションコンテキストをオーバーライドするものは、JAASRealm モジュールが定義されているarc.xml に移動することを推奨します。

これはでTomcat を設定する際に必要な最初のステップです。

ログインモジュールの作成

$CATALINA_BASE/conf/ フォルダに、jaas.config という名前のJAAS コンフィギュレーションファイルを作成します。標準認証を使用するには、jaas.config に次の内容を含めます：

Arc {
  arc.LoginModule required;
};

LDAP を使用する場合は、標準ログインモジュールのセットアップを続行します。完了したら、LDAP を使用してユーザーを認証するの手順に従います。

JAASRealm モジュールの作成（または変更）

$CATALINA_BASE/conf/Catalina/localhost/ にarc.xml ファイルがあるかどうかを確認します。ある場合は、arc.xml を編集して以下のXML コンテンツブロックを追加します。パスにarc.xml が存在しない場合は、作成し、以下のXML コンテンツブロックを追加する必要があります。arc.xml には、この内容のみを含めるようにしてください。
<Context> <Realm className="org.apache.catalina.realm.JAASRealm" appName="Arc" userClassNames="arc.SimplePrincipal" roleClassNames="arc.GroupPrincipal" /> </Context>
Tomcat インスタンスの構成によっては、このパスが若干異なる場合があります。この例では、Catalina はエンジン名、localhost はserver.xml で定義されたホスト名を示します。
Tomcat サーバーのコンフィギュレーションファイルserver.xml の<Host/> 要素を、以下のようにcopyXML 属性をtrue に設定して更新します：
<Host name="localhost" appBase="webapps" unpackWARS="true" autoDeploy="true" copyXML="true"> ... </Host>
アプリケーション固有のコンテキストがserver.xml に存在する場合は、arc.xml よりも優先されます。は、コンテキストのオーバーライドにはserver.xml よりもarc.xml を使用することを推奨しています。次に例を示します：
<Context path="Arc"> ... </Context>

ログインモジュールの表示

コンフィギュレーションを表示するには、Java 仮想マシン（JVM）がログインモジュール（jaas.config）に誘導される必要があります。$CATALINA_BASE/conf/catalina.properties ファイルに次の行を追加して、JVM のjava.security.auth.login.config システムプロパティをjaas.config ファイルのパスに設定します：

java.security.auth.login.config=${catalina.base}/conf/jaas.config

LDAP を使用してユーザーを認証する

Tomcat でLDAP を使用するようにを構成する前に、Java 認証・承認サービス（JAAS）の設定の手順に従って、管理者ユーザーを作成できるようにします。管理者ユーザーは、LDAP ユーザーをに追加する前に必要です。ログインモジュールを設定し、管理者ユーザーとしてに正常にログインできるようになったら、次の手順に従ってLDAP サポートを設定します。

管理者ユーザーとしてにログインします。へのアクセスが必要なすべてのLDAP ユーザーを作成するには、ナビゲーションバーにある設定歯車アイコンをクリックし、ユーザーを選択します。ユーザーはLDAP ユーザーと同一でなければなりません。例えば、LDAP ユーザーがuser01 やuser02 である場合、でも同じユーザー名を使用する必要があります。
ログインモジュールの作成で作成した$CATALINA_BASE/conf/jaas.config ファイルを、LDAP サーバーで動作するように編集します。jaas.config にいくつかの設定オプションを追加する必要があります。 a. com.sun.security.auth.module.LdapLoginModule REQUIRED を追加して、LDAP ログインモジュールが必須であることを確認します。また、以前に作成したログインモジュールをオプションにする必要もあります。これを行うには、arc.LoginModule optional; を設定します。 b. 必要なLDAP モジュールの設定オプションを追加します。少なくとも、次のオプションが必要です：userProvider、authIdentity、userFilter、およびuseSSL。これらのオプションに指定する値は、LDAP サーバーおよび要件に固有のものです。サーバー管理者および / またはLDAP のマニュアルを参照のうえ、値を決定してください。以下は、その設定例です。arc.loginModule がoptional に、com.sun.security.auth.module.LdapLoginModule がREQUIRED に設定されていることに注意してください。
Arc { com.sun.security.auth.module.LdapLoginModule REQUIRED userProvider="ldap://openldap:1389/ou=users,dc=example,dc=org" authIdentity="CN={USERNAME},OU=users,DC=example,DC=org" userFilter="(cn={USERNAME})" useSSL=false; debug=false; arc.LoginModule optional; };
値に特別なトークン{USERNAME} が含まれている場合、そのトークンはログイン時に指定されたユーザー名の値に置き換えられます。

これらの手順を完了すると、LDAP ユーザーはにログインできるようになります。

データディレクトリ権限の設定

Java サーブレットコンテナを実行するプロセスのユーザーに、以下のように、適切な場所にあるデータディレクトリへの読み / 書きのアクセス権限を許可します：

Windows： C:\ProgramData\CData\Arc\
Linux： ~/cdata/arc

Tomcat サーバーを再起動して、変更を反映します。これでアプリケーションにログインすることができます。

WebSphere Liberty での設定

WebSphere Liberty でを設定するには、次の手順に従います。

WebSphere Liberty でアプリケーションを作成

このガイドでは、Liberty でのの基本的なインストールについて説明します。よりカスタマイズされたLiberty インストールが必要な場合は、社内で追加の設定やオプションが必要かどうかを確認してください。

Open Liberty またはWebSphere Application Server Liberty 24.0.0.12 からLiberty をダウンロードします。はWeb Profile 8 パッケージを想定しています。
このコマンドを実行してarc という名前のサーバーを作成します：
- Windows：.\bin\server.bat create arc
- Linux：./bin/server create arc
arc.war ファイルを./usr/servers/arc/apps ディレクトリにコピーします。
必要に応じて、./usr/servers/arc/server.xml のhttpEndpoint 要素でHTTP およびHTTPS ポートを変更します（sample server.xml ファイルは以下にあります）。
server.xml ファイルを編集して、追加の構成アプリケーションの更新を行います。
このコマンドを実行してサーバーを起動します：
- Windows：.\bin\server.bat start arc
- Linux：./bin/server start arc

Sample server.xml File

以下は、がLiberty で実行するために必要な設定を含むサンプルのserver.xml ファイルです。JAAS 設定に必要な設定も含まれています。以下のセクションでは、このファイルの一部について詳しく説明します。

<?xml version="1.0" encoding="UTF-8"?>
<server description="Arc server">
  <!-- Enable features -->
  <featureManager>
    <feature>webProfile-8.0</feature>
  </featureManager>
  <!-- To access this server from a remote client add a host attribute to the following element, e.g. host="*" -->
  <httpEndpoint id="defaultHttpEndpoint" host="localhost" httpPort="9080" httpsPort="9443" />
  <!-- Automatically expand WAR files -->
  <applicationManager autoExpand="true"/>
  <!-- Default SSL configuration enables trust for default certificates from the Java runtime -->
  <ssl id="defaultSSLConfig" trustDefaultCerts="true" />
  <webContainer AllowQueryParamWithNoEqual="true" />
  <webApplication id="arc-app" contextRoot="/arc" location="arc.war">
    <!-- Map role to group -->
    <application-bnd>
      <security-role name="cdata_admin">
        <group name="cdata_admin" access-id="group:defaultWIMFileBasedRealm/cn=cdata_admin,o=defaultWIMFileBasedRealm" />
      </security-role>
      <security-role name="cdata_standard">
        <group name="cdata_standard" access-id="group:defaultWIMFileBasedRealm/cn=cdata_standard,o=defaultWIMFileBasedRealm" />
      </security-role>
      <security-role name="cdata_support">
        <group name="cdata_support" access-id="group:defaultWIMFileBasedRealm/cn=cdata_support,o=defaultWIMFileBasedRealm" />
      </security-role>
      <security-role name="cdata_user">
        <special-subject type="ALL_AUTHENTICATED_USERS" />
      </security-role>
    </application-bnd>
  </webApplication>
  <jaasLoginModule id="arcLoginModule" className="arc.LoginModule" controlFlag="REQUIRED" classProviderRef="arc-app">
    <options isWebSphere="true" />
  </jaasLoginModule>
  <jaasLoginContextEntry id="system.WEB_INBOUND" name="system.WEB_INBOUND" loginModuleRef="arcLoginModule, hashtable, userNameAndPassword" />
  <!-- logging is optional -->
  <logging traceSpecification="com.ibm.ws.security.appbnd.*=all:com.ibm.ws.security.authorization.*=all:com.ibm.wsspi.security.authorization.*=all:com.ibm.ws.security.jaas.*=all:com.ibm.ws.security.auth.context.*=all:com.ibm.ws.webcontainer.*=all:arc.*=all:rssbus.*=all"
    consoleLogLevel="INFO"
    logDirectory="${server.config.dir}/logs"
    messageFileName="messages.log"
    traceFileName="trace.log"
    hideMessageIDs="true"/>
</server>

Java 認証・承認サービス（JAAS）の設定

server.xml の以下の設定はJAAS を設定し、がLiberty アプリケーションサーバーで動的にユーザーを管理できるようにします。上記のserver.xml サンプルファイルをコピーした場合、これらの要素はすでに存在します。それ以外の場合は、次の手順に従います：

server.xml に次の要素を追加して、JAAS 認証用にログインモジュールを設定します：

<jaasLoginModule id="arcLoginModule" className="arc.LoginModule" controlFlag="REQUIRED" classProviderRef="arc-app">
   <options isWebSphere="true" />
</jaasLoginModule>
<jaasLoginContextEntry id="system.WEB_INBOUND" name="system.WEB_INBOUND" loginModuleRef="arcLoginModule, hashtable, userNameAndPassword" />

server.xml のwebApplication 要素でユーザーグループとロールマッピングを設定します。

<webApplication id="arc-app" contextRoot="/arc" location="arc.war">
   <!-- Map role to group -->
   <application-bnd>
     <security-role name="cdata_admin">
       <group name="cdata_admin" access-id="group:defaultWIMFileBasedRealm/cn=cdata_admin,o=defaultWIMFileBasedRealm" />
     </security-role>
     <security-role name="cdata_standard">
       <group name="cdata_standard" access-id="group:defaultWIMFileBasedRealm/cn=cdata_standard,o=defaultWIMFileBasedRealm" />
     </security-role>
     <security-role name="cdata_support">
       <group name="cdata_support" access-id="group:defaultWIMFileBasedRealm/cn=cdata_support,o=defaultWIMFileBasedRealm" />
     </security-role>
     <security-role name="cdata_user">
       <special-subject type="ALL_AUTHENTICATED_USERS" />
     </security-role>
   </application-bnd>
</webApplication>

application-bnd セクションはのセキュリティロールをユーザーグループにマッピングし、アプリケーション内で各ユーザーが持つ権限を制御します。各security-role 要素はの権限レベルの1つを定義し、対応するユーザーグループに関連付けます。cdata_admin、cdata_standard、cdata_support、およびcdata_user のsecurity-role 要素が存在することを確認してください。

webContainer 要素にAllowQueryParamWithNoEqual プロパティを追加して、等号（=）なしのクエリパラメータを有効にします。この設定により、は等号を含まない特定のURL クエリパラメータを適切に処理できるようになります。
<webContainer AllowQueryParamWithNoEqual="true" />
Liberty を再起動します。

これでにアクセスでき、ログインモジュールで使用できるようになりました。これにより、アプリケーションレベルでユーザーを確実に管理できます。LDAP を設定するには、次のセクションを参照してください。

LDAP を使用したユーザー認証

Liberty でLDAP を使用するようにを設定する前に、Java 認証・承認サービス（JAAS）の設定の手順に従って、ローカル管理者ユーザーを作成してください。LDAP ユーザーをに追加するには、管理者ユーザーが必要です。ログインモジュールを設定し、管理者ユーザーとしてに正常にログインできるようになったら、次の手順に従ってLDAP サポートを設定します。

server.xml を編集して、LDAP リポジトリをLiberty に追加します。

featureManager 要素に、新しいフィーチャーldapRegistry-3.0 を追加します。

<!-- Enable features -->
<featureManager>
  <feature>webProfile-8.0</feature>
  <feature>ldapRegistry-3.0</feature>
</featureManager>

webContainer 要素の後にLDAP レジストリの詳細を追加します。

<!-- A LDAP registry sample connects to Microsoft Active Directory. The default activedFilters is used here.
     For more ldap types: https://www.openliberty.io/docs/latest/reference/config/ldapRegistry.html
  -->
<ldapRegistry id="arcLdapRegistry" realm="testADRealm"
              host="192.168.0.122" port="389" ignoreCase="true"
              baseDN="CN=Users,DC=ka,DC=com"
              bindAuthMechanism="simple"
              bindDN="ka\nancyw"
              bindPassword ="xA123456"
              ldapType="Microsoft Active Directory">
</ldapRegistry>

arc.LoginModule のコントロールフラグをOPTIONAL に変更します。

<jaasLoginModule id="arcLoginModule" className="arc.LoginModule" controlFlag="OPTIONAL" classProviderRef="arc-app">
     <options isWebSphere="true" />
</jaasLoginModule>

ローカル管理者ユーザーとしてにログインします。でLDAP ユーザーを作成するには、ナビゲーションバーの設定歯車アイコンをクリックして、ユーザーを選択します。ユーザーはLDAP サーバーのユーザーと同一でなければなりません。例えば、LDAP ユーザーがuser01 やuser02 である場合、でも同じユーザー名を使用する必要があります。
変更を保存し、Liberty を再起動してプロセスを完了します。正常に構成されると、にサインインするユーザーはLDAP 経由で認証されます。

デバッグ設定

sample server.xml ファイルには、セキュリティ、認証、Web コンテナ操作、および固有のコンポーネントの詳細なトレース情報をキャプチャする包括的なログ設定が含まれています。これは、LDAP やその他の設定で構成上の問題が発生している場合に役立ちます。

<!-- logging is optional -->
<logging traceSpecification="com.ibm.ws.security.appbnd.*=all:com.ibm.ws.security.authorization.*=all:com.ibm.wsspi.security.authorization.*=all:com.ibm.ws.security.jaas.*=all:com.ibm.ws.security.auth.context.*=all:com.ibm.ws.webcontainer.*=all:arc.*=all:rssbus.*=all"
  consoleLogLevel="INFO"
  logDirectory="${server.config.dir}/logs"
  messageFileName="messages.log"
  traceFileName="trace.log"
  hideMessageIDs="true"/>

traceSpecification 属性は、セキュリティバインディング、承認、JAAS 認証、Web コンテナ操作、およびすべてのとRSSBus モジュールを含むいくつかの主要なコンポーネントグループに対してall に設定されています。この構成は、認証の問題、承認の問題、およびアプリケーション固有のエラーのトラブルシューティングに役立つ詳細な診断情報を提供します。ログは${server.config.dir}/logs ディレクトリに、メッセージ（messages.log）とトレースデータ（trace.log）の別々のファイルとして書き込まれます。本番環境では、パフォーマンスを向上させ、ログファイルの増大を最小限に抑えるために、ログの冗長性を減らすことを検討するとよいでしょう。これを行うには、特定のトレース仕様をall からinfo に変更するか、監視する必要のないコンポーネントを削除します。例えば、セキュリティの問題をトラブルシューティングしていない場合は、構成をtraceSpecification="arc.*=all:rssbus.*=all" に簡略化して、固有のログのみに焦点を当てることができます。逆に、トラブルシューティング中にさらに詳細な診断が必要な場合は、一時的にtraceSpecification="*=all" に設定して、すべてのLiberty コンポーネントにわたる包括的なログを有効にできます。これは大きなログファイルをすぐに生成するため、短期間のデバッグにのみ使用すべきであることに注意してください。

データディレクトリ権限の設定

Java サーブレットコンテナを実行するプロセスのユーザーに、データディレクトリへの読み書きのアクセス権限を許可します：

Windows： C:\ProgramData\CData\Arc\
Linux： ~/cdata/arc

Liberty サーバーを再起動して、変更を反映します。これでアプリケーションにログインすることができます。

Jetty での設定

にはJetty Web サーバーが組み込まれていますが、アプリケーションを外部のJetty 設定で使用することもできます。

WAR ファイルとarc.xml の配布

arc.war を${JETTY_BASE} のwebapps フォルダにコピーします。また、arc.xml ファイルも同じ${JETTY_BASE} フォルダに配置します。arc.xml がない場合は、作成する必要があります。少なくとも、Jetty の標準構成では、arc.xml ファイルに次の内容が含まれている必要があります：

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure.dtd">
<Configure id="arcServer" class="org.eclipse.jetty.webapp.WebAppContext">
  <Set name="contextPath">/</Set>
  <Set name="war">/var/lib/jetty/webapps/arc.war</Set>
  <Set name="securityHandler">
    <New class="org.eclipse.jetty.security.ConstraintSecurityHandler">
      <Set name="loginService">
        <New class="org.eclipse.jetty.jaas.JAASLoginService">
          <!-- This name is the same as **login-config > realm-name** in web.xml.  -->
          <Set name="name">ArcRealm</Set>
          <!-- LoginModuleName must match the name of your LoginModule, as declared in your login-module configuration file. -->
          <Set name="loginModuleName">Arc</Set>
          <!-- Set the principal class name for the custom role. -->
          <Set name="roleClassNames">
            <Array type="java.lang.String">
              <Item>arc.GroupPrincipal</Item>
            </Array>
          </Set>
        </New>
      </Set>
    </New>
  </Set>
</Configure>

Java 認証・承認サービス（JAAS）の設定

JAAS を設定してがアプリケーションのユーザーを管理できるようにするには、次のセクションで説明する手順を実行する必要があります。

JAAS モジュールの追加

JAAS モジュールをインストールするには、次のコマンドを送信します：

java -jar start.jar --add-modules=deploy,jsp,http,jaas

ログインモジュールの作成

Arc {
    arc.LoginModule required debug=true;
};

セキュリティハンドラの更新

セキュリティハンドラの設定は、arc.xml 設定ファイルにあります。WAR ファイルとarc.xml の配布の内容を使用してarc.xml ファイルを作成した場合は、この変更がすでにその内容に含まれているため、この手順をスキップできます。そうでない場合は、securityHandler ブロックを以下のように変更します：

<Set name="securityHandler">
  <New class="org.eclipse.jetty.security.ConstraintSecurityHandler">
   <Set name="loginService">
     <New class="org.eclipse.jetty.jaas.JAASLoginService">
          <!-- This name is the same as **login-config > realm-name** in web.xml.  -->
       <Set name="name">ArcRealm</Set>
          <!-- LoginModuleName must match the name of your LoginModule, as declared in your login-module configuration file. -->
       <Set name="loginModuleName">Arc</Set>
       <!-- Set the principal class name for the custom role. -->
       <Set name="roleClassNames">
           <Array type="java.lang.String">
             <Item>arc.GroupPrincipal</Item>
           </Array>
         </Set>
     </New>
   </Set>
  </New>
</Set>

Jetty でのLDAP

Jetty でを実行する際にLDAP を設定するには、標準のログインモジュールを使用してJetty で実行されるようにを設定する必要があります。がJetty でログインモジュールを使用して起動したら、次の手順に従ってJetty がユーザー認証にLDAP を使用するように構成します。

LDAP ユーザーをに追加します。
1. にLDAP ユーザーを追加するには、管理者ユーザーとしてログインします。でLDAP ユーザーを作成するには、ナビゲーションバーの設定歯車アイコンをクリックして、ユーザーを選択します。ユーザーはLDAP サーバーのユーザーと同一でなければなりません。例えば、LDAP ユーザーがuser01 やuser02 である場合、でも同じユーザー名を使用する必要があります。
2. 完了したらを停止します。
login.conf で、Jetty LDAP ログインモジュールのJAAS 構成を作成します。
1. ${JETTY_BASE}/etc/login.conf にあるlogin.conf ファイルを開き、Jetty LDAP モジュール用のJAAS 設定を追加します。さまざまな構成設定が利用可能ですが、JAAS の構成は特定の要件とLDAP サーバーの構成によって異なります。利用可能なJAAS 構成のリストについては、Jetty ドキュメントおよび以下を参照してください：
  debug useLdaps contextFactory hostname port bindDn bindPassword authenticationMethod forceBindingLogin userBaseDn userRdnAttribute userIdAttribute userPasswordAttribute userObjectClass roleBaseDn roleNameAttribute roleMemberAttribute roleObjectClass
2. 以下は、LDAP サーバーで構成されたlogin.conf ファイルの例です。必要な設定と値は、特定の要件とLDAP サーバーの構成によって異なることに注意してください。セットアップに必要な設定と値を決定するには、LDAP 管理者に問い合わせるか、LDAP サーバーのドキュメントを参照してください。
  Arc { arc.LoginModule optional debug=true; org.eclipse.jetty.jaas.spi.LdapLoginModule optional debug="true" contextFactory="com.sun.jndi.ldap.LdapCtxFactory" hostname="openldap" port="1389" bindDn="CN=ldapuser,DC=example,DC=org" bindPassword="Adminpassword1" authenticationMethod="simple" forceBindingLogin="true" userBaseDn="OU=users,DC=example,DC=org" userRdnAttribute="cn" userPasswordAttribute="userPassword" roleBaseDn="DC=example,DC=org" roleNameAttribute="cn" roleMemberAttribute="member" useLdaps="false"; };
  arc.LoginModule とorg.eclipse.jetty.jaas.spi.LdapLoginModule は両方ともオプションに設定されていることに注意してください。これにより、ユーザー認証を行う際に両方のログインモジュールを使用できるようになります。1つのログインモジュールがユーザーの認証に失敗した場合、ログインは2つ目のモジュールにフォールバックします。両方のログインモジュールがユーザー認証に失敗した場合は、ログインは完全に失敗します。
3. login.conf が必要なLDAP 設定で更新されたら、を再起動します。正しく設定されていれば、LDAP ユーザーはにログインできるようになります。

データディレクトリ権限の設定

Java サーブレットコンテナを実行するプロセスのユーザーに、データディレクトリへの読み / 書きのアクセス権限を許可します：

Windows： C:\ProgramData\CData\Arc\
Linux： ~/cdata/arc

Jetty サーバーを再起動して、変更を反映します。これでアプリケーションにログインすることができます。

ユーザー管理

初めて起動する際、はユーザー名とパスワードの資格情報を持つユーザーの作成を要求します。最初のユーザーを作成後、アプリケーションの設定ページのユーザータブで、ユーザーの追加、削除、および管理を行うことができます。を外部のJava サーブレットにデプロイする場合（つまり、アプリケーション付属の組み込みサーバーを使用しない場合）、によるユーザーの管理を可能にするためJAAS の設定が必要です。前のセクションで、特定の外部サーブレットごとにJAAS を設定するプロセスを詳しく説明しています。

アプリケーションディレクトリの検索と設定

の ApplicationDirectory フォルダには、アプリケーションで使用されるすべてのデータ（設定データ、アプリケーションデータ、ログデータ、証明書など）が格納されます。ApplicationDirectory のデフォルトの場所は、が組み込みWeb サーバー経由でホストされているか、外部のJava サーブレットコンテナ経由でホストされているかによって異なります。組み込みWeb サーバーの場合、 ApplicationDirectory は InstallationDirectory と同じです。デフォルトの場所は次のとおりです：

/opt/arc

が外部のJava サーブレットコンテナにホストされている場合、 ApplicationDirectory はサーバーを実行しているユーザーのホームディレクトリからの相対パスです： ~/arc このパスでは、’~’ はアプリケーションをホストするサーバーを実行しているユーザーのホームディレクトリに解決します。 ApplicationDirectory フォルダを構成でき、これはさまざまなシナリオで役立ちます：

の複数インスタンスのクラスタリング
アプリケーションデータ用の共有ネットワークドライブの使用
同じフォルダにアクセスする他のシステム内へのの組み込み

ApplicationDirectory を変更すると、アプリケーションのデータファイルが移動します。ただし、EXE ファイルやJAR ファイルなどの他のアプリケーションリソースは移動しません。これらのリソースは InstallationDirectory フォルダに格納されます。このフォルダは ApplicationDirectory と同じ場合がありますが、 ApplicationDirectory を変更しても、これらのリソースの場所は変わりません。

組み込みJava サーバー

クロスプラットフォーム版を組み込みJetty サーバーで使用する場合、デフォルトで ApplicationDirectory は InstallationDirectory となります。これを変更するには、arc.properties ファイルを生成します。テキストエディタでファイルを開き、cdata.app.directory 設定を、目的のディレクトリのパスに設定します。次の例は、マウントされたドライブ上の共有フォルダにデータディレクトリを設定した場合を示しています：

cdata.app.directory=/mnt/shared/arc

がcdata.app.directory のパスを見つけることができ、そのパスで読み取りと書き込みができる適切なアクセス許可を持つ場合、指定したディレクトリにデータフォルダを作成します。

外部Java サーバー

クロスプラットフォーム版を外部のJava サーブレット（アプリケーションに含まれるJetty サーバー以外のサーバー）で使用する場合、アプリケーションのデータディレクトリの設定の詳細は使用する特定のサーブレットに依存します。特定のサーブレットに適した構文を使用するAppDirectory 環境変数を必要なディレクトリのパスに設定する必要があります。がAppDirectory のパスを見つけることができ、そのパスで読み取りと書き込みができる適切なアクセス許可を持つ場合、指定したディレクトリにデータフォルダを作成します。

アプリケーションデータベースの設定

のアプリケーションデータベースは、以下のようなアプリケーションデータの複数のテーブルを保存します：

トランザクションログ：アプリケーションによって処理される各トランザクションのメタデータ
アプリケーションログ：アプリケーションレベルのエラーとイベント
アクセスログ：アプリケーションのWeb エンドポイントへのリクエスト
監査ログ：ユーザーによるの設定変更

デフォルトでは ApplicationDirectory に存在するH2 データベースをアプリケーションデータベースとして使用します。このデータベースは最大100,000 トランザクションまでを推奨します。その件数に達したら、は外部データベースへの移行を推奨します。SQL Server、PostgreSQL、MySQL などのエンタープライズデータベースを使用するようにアプリケーションを設定できます。

セキュリティ上の理由から、アプリケーションデータベースを切り替える場合は、必ずintegrityResetTampering オペレーションを実行してハッシュチェーンをリセットする必要があります。

組み込みJava サーバー

クロスプラットフォーム版を組み込みJetty サーバーで使用する場合、デフォルトのアプリケーションデータベースは ApplicationDirectory にあるH2 データベースです。これを変更するには、arc.properties ファイルを生成します。テキストエディタでファイルを開き、cdata.app.db の設定に、必要なデータベースの適切な接続パラメータを含むJava Database Connectivity (JDBC) 接続文字列を設定します。次の例は、この設定をMySQL、PostgreSQL、およびSQL Server について示しています：

MySQL

cdata.app.db=jdbc:cdata:mysql:server=localhost;port=3306;database=mysql;user=MyUserName;password=MyPassword

PostgreSQL

cdata.app.db=jdbc:cdata:postgresql:server=localhost;port=5432;database=postgresql;user=MyUserName;password=MyPassword

SQL Server

cdata.app.db=jdbc:cdata:sql:server=localhost;database=sqlserver;user=MyUserName;password=MyPassword

がcdata.app.db 接続文字列で正常に接続を確立できる場合、そのデータベースをアプリケーションデータベースとして使用します。

アプリケーションデータベースとしてSQL Server を使用する際のデッドロックの可能性を減らすため、ではREAD_COMMITTED_SNAPSHOT が有効化されていることの確認を推奨しています。

暗号化されたデータベース接続文字列の生成

は、アプリケーションのデータベース接続用に暗号化された接続文字列を生成する機能を提供します。この暗号化された接続文字列を使用することで、設定ファイルにログイン認証情報をプレーンテキストで保存することなく、アプリケーションデータベースを指定することができます。暗号化された接続文字列を生成するには、arc.jar があるインストールディレクトリで、接続情報を引用符で囲んだ例の文字列に置き換えて、以下のコマンドを実行します：

java -jar arc.jar -EncryptConnectionString "jdbc:cdata:mysql:Server=serverName;Port=1234;Database=databaseName;User=userName;Password=passwordSample"

コマンドを発行すると、コマンドウィンドウに暗号化された文字列が出力されます。次に例を示します：

ENCRYPTEDA:5TWyjE0U4GBEVNkd51SqbMXaBwVGqj5uyMfTHt48y/F5l3sDPZynNnPMb/ppXzuFTzFPywA1/SSKUgLy9nAuvA7RAdZj7WsKI1xAgDMmEFNQ68/lHjFYZpS10sIaoUloyZVDkj4uLHTZ0SaMD5PPUA==

この暗号化された文字列を、上記のように cdata.app.db のプレーンテキスト値の代わりに使用することができます。

外部Java サーバー

クロスプラットフォーム版を外部のJava サーブレット（アプリケーションに含まれるJetty サーバー以外のサーバー）で使用する場合、アプリケーションのデータベースの設定の詳細は使用する特定のサーブレットに依存します。特定のサーブレットに適した構文を使用する、サーバーを設定する際のアプローチを次のいずれかから選択します：

ターゲットデータベースの接続プロパティを含むJNDI データソースを定義。
APP_DB 環境変数をJDBC 接続文字列に設定。

がJNDI データソースまたはAPP_DB 接続文字列を使用してデータベースに接続できる場合、そのデータベースをアプリケーションデータベースとして使用します。

デフォルト文字セットの指定（MySQL のみ）

MySQL 8.0 以降などのMySQL バージョンでは、データベースおよびそのテーブルのデフォルト文字セット（charset）はUTF8（具体的にはutf8mb4）です。ただし、8.0 より前のバージョンのMySQL では、デフォルトのcharset は通常Latin1 であり、基本ラテン文字以外の文字を含むデータで問題が発生する可能性があります。古いバージョンのMySQL を使用している場合は、代わりにutf8mb4 を使用するようにデータベースを設定することで、これらの問題を回避できます。この変更を行うには2つの方法があります。既存のデータベースを直接更新するか、MySQL のエクスポートおよびインポートツールを使用してデータを新しいUTF8 エンコードのデータベースに移行します。 データベースを直接更新する

データベースをバックアップします：mysqldump -u root -p --default-character-set=latin1 --databases [database name] > backup.sql
デフォルトのcharset をUTF8 に変更します：ALTER DATABASE [database name] CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

すべてのデータベーステーブルのデフォルトのcharset をUTF8 に変更するSQL ステートメントを生成します：

SELECT CONCAT('ALTER TABLE ', table_name, ' CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;') AS alter_sql
FROM information_schema.TABLES
WHERE table_schema = '[database name]' AND table_type = 'BASE TABLE';

前のステップで生成されたSQL ステートメントを実行します。

エクスポートおよびインポートツールを使用する

データ定義言語（DDL）とデータをエクスポートします：

mysqldump -u root -p --default-character-set=latin1 --no-create-info [database name] > data.sql
mysqldump -u root -p --no-data [database name] > schemas.sql

schemas.sql のデフォルトcharset をCHARSET=latin1 からCHARSET=utf8mb4 に変更します。
UTF8 をデフォルトのcharset とする新しいデータベースを作成します：CREATE DATABASE [new database name] CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

新しいデータベースにインポートします：

mysql -u root -p [new database name] < schema.sql
mysql -u root -p [new database name] < data.sql

ログインのロックアウト

は、ブルートフォースアタックを防ぐために、不正なパスワードを何度も入力するユーザーを自動的にロックアウトします。デフォルトでは、5分以内に6回不正なパスワードを入力したユーザーは30分間ロックアウトされます。 Web サーバーの動作を規定するXML 設定ファイルを編集することで、ロックアウトの設定を変更できます。この3つの設定はロックアウトに関係します：

LockoutFailedAttempts：ロックアウトのトリガーとなる不正なパスワードの数。ロックアウトを無効にするには、LockoutFailedAttempts を0に設定します。
LockoutMinutes：ロックアウトする時間。デフォルトは30分です。
LockoutTimeCheckPeriod：失敗した試行回数を0にリセットするまでの時間。デフォルトは5分です。

組み込みJetty サーバー

ロックアウト設定を変更するには、arc.properties ファイルを生成し、以下のようにname:value ペアのカンマ区切りのリストをinitParameters に追加します：

cdata.initParameters=LockoutFailedAttempts:0

Tomcat

Tomcat のarc.xml ファイルのロックアウト設定を編集するための構文は以下のとおりです：

<Context>
  <Parameter name="LockoutFailedAttempts" value="0" />
</Context>

一般的な課題と解決方法

このセクションでは、Java 環境にをデプロイする際に遭遇する可能性がある一般的な課題をリストアップします。それぞれの課題について推奨ソリューションを記載します。その他のヘルプについては、テクニカルサポート：support@cdata.co.jp にお問い合わせください。

課題

が起動しない、または期待されるものとは異なるAppDirectory を使用して起動する

このエラーは、が ApplicationDirectory にアクセスするために必要な権限を持っていない可能性があります（ ApplicationDirectory は、ジョブ、接続、変換などの設定に関する重要な情報を保存するフォルダです）。このエラーの原因として考えられるのは、サービスをセットアップする前にローカルユーザーとしてを実行している場合です。この場合、アプリケーションで作成される特定のリソースが、ローカルユーザーの下に作成されている可能性があります。結果として、をサービスとして実行する場合にこれらのリソースを利用できません。

推奨ソリューション

Linux オペレーティング環境で、サービスアカウント（またはを実行させるための他のアカウント）が ApplicationDirectory にアクセスできることを確認する最も簡単な方法は、chown コマンドを使用することです。例えば、 ApplicationDirectory がLinux のデフォルトの場所にあってがサービスアカウントで実行されるべき場合、以下のコマンドでエラーが解決されるはずです：

sudo chown -R cdatarc:cdatarc /opt/arc

サーバーの起動 arc.properties の設定

⌘I

​Windows

​サービスの起動と停止

​スタートメニューのショートカット

​サービス管理コンソール

​コマンドプロンプト

​サービスを使わずに起動

​Linux

​ をサービスとして実行

​スタンドアロンアプリケーションの実行

​組み込みJetty サーバーの構成

​arc.properties ファイルの生成

​ポートの変更

​TLS/SSL の有効化

​ を別の.properties ファイルに指定する

​Jetty XML ファイルの生成

​サーバーの起動と停止

​インプロセスで実行

​サービスとして実行

​LDAP 認証の設定

​arc.properties の設定

​ でLDAP ユーザーを作成する

​設定をテストする

​LDAP 設定のトラブルシューティング

認証失敗のデバッグログの作成

​Tomcat での設定

​WAR ファイルの配布

​Java 認証・承認サービス（JAAS）の設定

​ログインモジュールの作成

​JAASRealm モジュールの作成（または変更）

​ログインモジュールの表示

​LDAP を使用してユーザーを認証する

​データディレクトリ権限の設定

​WebSphere Liberty での設定

​WebSphere Liberty で アプリケーションを作成

​Sample server.xml File

​Java 認証・承認サービス（JAAS）の設定

​LDAP を使用したユーザー認証

​デバッグ設定

​データディレクトリ権限の設定

​Jetty での設定

​WAR ファイルとarc.xml の配布

​Java 認証・承認サービス（JAAS）の設定

​JAAS モジュールの追加

​ ログインモジュールの作成

​セキュリティハンドラの更新

​Jetty でのLDAP

​データディレクトリ権限の設定

​ユーザー管理

​アプリケーションディレクトリの検索と設定

​組み込みJava サーバー

​外部Java サーバー

​アプリケーションデータベースの設定

​組み込みJava サーバー

​MySQL

​PostgreSQL

​SQL Server

​暗号化されたデータベース接続文字列の生成

​外部Java サーバー

​デフォルト文字セットの指定（MySQL のみ）

​ログインのロックアウト

​組み込みJetty サーバー

​Tomcat

​一般的な課題と解決方法

​課題

​ が起動しない、または期待されるものとは異なるAppDirectory を使用して起動する

​推奨ソリューション

Windows

サービスの起動と停止

スタートメニューのショートカット

サービス管理コンソール

コマンドプロンプト

サービスを使わずに起動

Linux

をサービスとして実行

スタンドアロンアプリケーションの実行

組み込みJetty サーバーの構成

arc.properties ファイルの生成

ポートの変更

TLS/SSL の有効化

を別の.properties ファイルに指定する

Jetty XML ファイルの生成

サーバーの起動と停止

インプロセスで実行

サービスとして実行

LDAP 認証の設定

arc.properties の設定

でLDAP ユーザーを作成する

設定をテストする

LDAP 設定のトラブルシューティング

Tomcat での設定

WAR ファイルの配布

Java 認証・承認サービス（JAAS）の設定

ログインモジュールの作成

JAASRealm モジュールの作成（または変更）

ログインモジュールの表示

LDAP を使用してユーザーを認証する

データディレクトリ権限の設定

WebSphere Liberty での設定

WebSphere Liberty でアプリケーションを作成

Sample server.xml File

Java 認証・承認サービス（JAAS）の設定

LDAP を使用したユーザー認証

デバッグ設定

データディレクトリ権限の設定

Jetty での設定

WAR ファイルとarc.xml の配布

Java 認証・承認サービス（JAAS）の設定

JAAS モジュールの追加

ログインモジュールの作成

セキュリティハンドラの更新

Jetty でのLDAP

データディレクトリ権限の設定

ユーザー管理

アプリケーションディレクトリの検索と設定

組み込みJava サーバー

外部Java サーバー

アプリケーションデータベースの設定

組み込みJava サーバー

MySQL

PostgreSQL

SQL Server

暗号化されたデータベース接続文字列の生成

外部Java サーバー

デフォルト文字セットの指定（MySQL のみ）

ログインのロックアウト

組み込みJetty サーバー

Tomcat

一般的な課題と解決方法

課題

が起動しない、または期待されるものとは異なるAppDirectory を使用して起動する

推奨ソリューション