ここでは、スタンドアロン AEM インスタンスのインストール時に使用可能なオプションについて説明します。AEM 6 を新規インストールした後のバックエンドストレージタイプの選択について詳しくは、ストレージ要素も参照してください。
AEMのデフォルトポートは4502です。そのポートが使用できない場合、または既に使用されている場合、Quickstartは、次のように最初に使用可能なポート番号を使用するように自動的に設定します。4502, 8080, 8081, 8082, 8083, 8084, 8085, 8888, 9362, <*random*>
.
また、quickstart jarファイルの名前を変更してポート番号を設定し、ファイル名にポート番号が含まれるようにすることもできます。(例:cq5-publish-p4503.jar
、cq5-author-p6754.jar
)。
クイックスタート jar ファイル名を変更する際に従わなければならない様々なルールがあります。
ファイル名を変更する場合は、cq5-publish-p4503.jar
のようにcq;
と開始する必要があります。
ポート番号の直前には -p を付けることをお勧めします。例えば、cq5-publish-p4503.jar または cq5-author-p6754.jar のように指定します。**
ポート番号の抽出の際には以下の点にご注意ください。
-p
を付ける必要があります。開始コマンドの-port
オプションを使用して、ポート番号を変更することもできます。
Oracle Java 11(または一般にバージョン 8 より新しい Java)を実行している場合は、AEM の起動時にコマンドラインにさらにスイッチを追加する必要があります。
stdout.log
内の関連するリフレクションアクセスの警告メッセージを防ぐためには、-add-opens
スイッチを追加する必要があります。--add-opens=java.desktop/com.sun.imageio.plugins.jpeg=ALL-UNNAMED --add-opens=java.base/sun.net.www.protocol.jrt=ALL-UNNAMED --add-opens=java.naming/javax.naming.spi=ALL-UNNAMED --add-opens=java.xml/com.sun.org.apache.xerces.internal.dom=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/jdk.internal.loader=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED -Dnashorn.args=--no-deprecation-warning
-XX:+UseParallelGC
スイッチを使用する必要があります。以下は、Java 11 で AEM を起動するときに指定する追加の JVM パラメータのサンプルです。
-XX:+UseParallelGC --add-opens=java.desktop/com.sun.imageio.plugins.jpeg=ALL-UNNAMED --add-opens=java.base/sun.net.www.protocol.jrt=ALL-UNNAMED --add-opens=java.naming/javax.naming.spi=ALL-UNNAMED --add-opens=java.xml/com.sun.org.apache.xerces.internal.dom=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/jdk.internal.loader=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED -Dnashorn.args=--no-deprecation-warning
最後に、AEM 6.3 からアップグレードしたインスタンスを実行する場合は、で次のプロパティが truesling.properties
に設定されていることを確認します。
felix.bootdelegation.implicit
実行モードを使用すれば、特定の目的(オーサー、パブリッシュ、テスト、開発、イントラネットなど)に合わせてAEM インスタンスを調整できます。これらのモードでは、サンプルコンテンツの使用を制御することもできます。このサンプルコンテンツは、クイックスタートの構築前に定義され、パッケージや設定などを含めることができ、実稼働の準備が完了したインストール環境をサンプルコンテンツを含まないスリムな状態に保つ場合に特に便利です。詳しくは、次のページを参照してください。
デフォルトでは、crx-quickstart/install
フォルダーはファイルの監視対象です。
このフォルダーは存在しませんが、実行時に作成できます。
このディレクトリに追加されたバンドル、設定またはコンテンツパッケージは自動的に選択およびインストールされます。削除された場合は、アンインストールされます。
これは、バンドル、コンテンツパッケージまたは設定をリポジトリに追加するためのもう 1 つの方法です。
この方法は次に示すいくつかの事例で特に有効です。
crx-quickstart/install
フォルダーを作成して、そこにパッケージを追加できます。例については、サーバー起動時にCRXパッケージを自動的にインストールする方法も参照してください。
管理者としてログオンする際に次の手順を実行するか、またはコンテキストメニューの「管理者として実行」オプションを使用して手順を開始/実行してください。
管理者権限を持つユーザーとしてログオンしただけでは不十分です。管理者としてログオンしていない状態でこれらの手順の完了すると、「アクセスが拒否されました」というエラーが表示されます。
AEM を Windows サービスとしてインストールして起動するには:
crx-quickstart\opt\helpers\instsrv.bat ファイルをテキストエディターで開きます。
64ビットWindowsサーバーを設定する場合は、prunsrvのすべてのインスタンスを、オペレーティングシステムに応じて、次のいずれかのコマンドに置き換えます。
このコマンドは、32ビットJavaではなく64ビットJavaのWindowsサービスデーモンを開始する適切なスクリプトを呼び出します。
プロセスが複数のプロセスに分岐しないようにするには、最大ヒープサイズと PermGen JVM パラメーターの値を増やします。set jvm_options
コマンドを探し、値を次のように設定します。
set jvm_options=-XX:MaxPermSize=256M;-Xmx1792m
コマンドプロンプトを開き、現在のディレクトリを AEM インストールの crx-quickstart/opt/helpers フォルダーに変更し、次のコマンドを入力してサービスを作成します。
instsrv.bat cq5
サービスが作成されたことを確認するには、管理ツールコントロールパネルで「サービス」を開くか、コマンドプロンプトで「start services.msc
」と入力します。 cq5サービスがリストに表示されます。
次のいずれかの方法でサービスを起動します。
Windowsは、サービスが実行中であることを示します。AEM開始とprunsrv実行可能ファイルがタスクマネージャーに表示されます。 Webブラウザーで、AEM(例えば、AEMを使用している開始ーにhttps://localhost:4502
)に移動します。
instsrv.bat ファイル内のプロパティ値は、Windows サービスの作成時に使用されます。instsrv.bat 内のプロパティ値を編集する場合は、サービスをアンインストールしてから再インストールする必要があります。
AEMをサービスとしてインストールする場合は、Configuration Managerのcom.adobe.xmp.worker.files.ncomm.XMPFilesNComm
のlogsディレクトリの絶対パスを指定する必要があります。
サービスをアンインストールするには、コントロールパネルの「サービス」で「停止」をクリックするか、コマンドラインでフォルダーに移動して、"instsrv.bat -uninstall cq5
" と入力します。"" と入力すると、コントロールパネルの「サービスnet start
」のリストまたはコマンドライン内のリストからサービスが削除されます。
Javaマシンの一時フォルダーのデフォルトの場所は/tmp
です。AEMは、例えばパッケージの作成時に、このフォルダーも使用します。
一時フォルダーの場所を変更する場合(例えば、空き容量の多いディレクトリが必要な場合)は、JVMパラメーターを追加して* <new-tmp-path>
*を定義します。
-Djava.io.tmpdir="/<*new-tmp-path*>"
定義先は次のいずれかです。
その他のオプションや名前の変更規則については、クイックスタートヘルプファイルを参照してください。このファイルは —helpオプションから利用できます。ヘルプにアクセスするには、次のように入力します。
java -jar cq5-<*version*>.jar -help
Loading quickstart properties: default
Loading quickstart properties: instance
Setting properties from filename '/Users/Desktop/AEM/cq-quickstart-5.6.0.jar'
--------------------------------------------------------------------------------
Adobe Experience Manager Quickstart (build 20130129)
--------------------------------------------------------------------------------
Usage:
Use these options on the Quickstart command line.
--------------------------------------------------------------------------------
-help (--help,-h)
Show this help message
-quickstart.server.port (-p,-port) <port>
Set server port number
-contextpath (-c,-org.apache.felix.http.context_path) <contextpath>
Set context path
-debug <port>
Enable Java Debugging on port number; forces forking
-gui
Show GUI if running on a terminal
-nobrowser (-quickstart.nobrowser)
Do not open browser at startup
-unpack
Unpack installation files only, do not start the server (implies
-verbose)
-v (-verbose)
Do not redirect stdout/stderr to files and do not close stdin
-nofork
Do not fork the JVM, even if not running on a console
-fork
Force forking the JVM if running on a console, using recommended
default memory settings for the forked JVM.
-forkargs <args> [<args> ...]
Additional arguments for the forked JVM, defaults to '-Xmx1024m
-XX:MaxPermSize=256m '. Use -- to specify values starting with -,
example: '-forkargs -- -server'
-a (--interface) <interface>
Optional IP address (interface) to bind to
-pt <string>
Process type (main/fork) - do not use directly, used when forking a
process
-r <string> [<string> [<string> [<string> [<string> [<string> [<string> [<string> [<string> [<string>]]]]]]]]]
Runmode(s) - Use this to define the run mode(s)
-b <string>
Base folder - defines the path under which the quickstart work folder
is created
-low-mem-action <string>
Low memory action - what to do if memory is insufficient at startup
-use-control-port
Start a control port
-ll <level>
Define launchpad log level (1 = error...4 = debug)
--------------------------------------------------------------------------------
Quickstart filename options
--------------------------------------------------------------------------------
Usage:
Rename the jar file, including one of the patterns shown below, to set the
corresponding option. Command-line options have priority on these filename
patterns.
--------------------------------------------------------------------------------
-NNNN
Include -NNNN.jar or -pNNNN in the renamed jar filename to run on port
NNNN, for example: quickstart-8085.jar
-nobrowser
Include -nobrowser in the renamed jar filename to avoid opening the
browser at startup, example: quickstart-nobrowser-8085.jar
-publish
Include -publish in the renamed jar filename to run cq5 in "publish"
mode, example: cq5-publish-7502.jar
--------------------------------------------------------------------------------
The license.properties file
--------------------------------------------------------------------------------
The license.properties file stores licensing information, created from the
licensing form displayed on first startup and stored in the folder from where
Quickstart is run.
--------------------------------------------------------------------------------
Log files
--------------------------------------------------------------------------------
Once Quickstart has been unpacked and started, log files can be found under
./crx-quickstart/logs.
--------------------------------------------------------------------------------
Amazon Elastic Compute Cloud(EC2)インスタンスに AEM をインストールする場合は、EC2 インスタンスに作成者と発行の両方をインストールすると、AEM マネージャーのインスタンスのインストールの手順に従って、作成者インスタンスが正しくインストールされます。ただし、発行インスタンスは作成者インスタンスになります。
EC2 環境にパブリッシュインスタンスをインストールする前に、次の手順を実行してください。
インスタンスを初めて起動する前に、パブリッシュインスタンスの jar ファイルを展開します。ファイルを展開するには、次のコマンドを使用します。
java -jar quickstart.jar -unpack
インスタンスを初めて起動した後にモードを変更する場合は、実行モードを変更できません。
次のコマンドを実行してインスタンスを起動します。
java -jar quickstart.jar -r publish
上記のコマンドを実行してインスタンスを展開した後は、最初にそのインスタンスを実行してください。そうしないと、quickstart.properties ファイルが生成されません。このファイルが生成されない場合は、以降の AEM のアップグレードが失敗します。
bin フォルダー内の start スクリプトを開いて、次のセクションを確認します。
# runmode(s)
if [ -z "$CQ_RUNMODE" ]; then
CQ_RUNMODE='author'
fi
実行モードをパブリッシュに変更して、ファイルを保存します。
# runmode(s)
if [ -z "$CQ_RUNMODE" ]; then
CQ_RUNMODE='publish'
fi
インスタンスを停止し、start スクリプトを実行して再起動します。
次のリンクを使用して、インストールが機能していることを確認できます(すべての例では、インスタンスが localhost のポート 8080 で実行されていること、および CRX が /crx に、Launchpad が / の下にインストールされていることを前提としています)。
https://localhost:8080/crx/de
CRXDE Liteコンソール。
https://localhost:8080/system/console
Webコンソール
AEM WCM の様々な設定を行うことができますが、インストール直後には特定のアクションを実行するか、または少なくとも確認が必要な項目があります。
AEM WCM を起動したら、次の場所にアクセスできます。
CRXDE Liteを開くには、ようこそ画面からCRXDE Liteを選択するか、ブラウザを使用して
https://<<i>host</i>>:<<i>port</i>>/crx/de/index.jsp
例::
https://localhost:4502/crx/de/index.jsp
Adobe CQのWebコンソールにアクセスするには、ようこそ画面からOSGiコンソールを選択するか、ブラウザを使用して
https://<host>:<port>/system/console
次に例を示します。
https://localhost:4502/system/console
またはBundlesページ用
https://localhost:4502/system/console/bundles
詳しくは、Web コンソールでの OSGi 設定を参照してください。
インストール中に発生する可能性のある問題の処理について詳しくは、以下を参照してください。
AEM は単一のディレクトリにインストールされるので、アンインストールユーティリティは必要ありません。インストールディレクトリ全体を削除するだけでアンインストールできます。ただし、AEM のアンインストール方法は、その目的および使用している永続ストレージによって変わります。
例えば、デフォルトの TarPM インストールなど、永続ストレージがインストールディレクトリに埋め込まれている場合、フォルダーを削除するとデータも削除されます。
AEM を削除する前にリポジトリをバックアップすることを強く推奨します。<cq-installation-directory> 全体を削除すると、リポジトリも削除されます。削除する前にリポジトリのデータを保管する場合は、<cq-installation-directory>/crx-quickstart/repository フォルダーを他の場所に移動またはコピーしてから、その他のフォルダーを削除するようにしてください。
例えば、データベースサーバーなど、AEM のインストールが外部ストレージを使用している場合、フォルダーを削除してもデータは自動的には削除されませんが、ストレージ設定が削除されるので、JCR コンテンツの復元は困難になります。