自訂獨立安裝 custom-standalone-install

本節說明安裝獨立AEM執行個體時可用的選項。 您也可以閱讀 儲存元素 以取得全新安裝AEM 6後選擇後端儲存型別的詳細資訊。

重新命名檔案以變更連線埠號碼 changing-the-port-number-by-renaming-the-file

AEM的預設連線埠為4502。 如果該連線埠無法使用或已使用,Quickstart會自動設定為使用第一個可用的連線埠號碼,如下所示:4502、8080、8081、8082、8083、8084、8085、8888、9362 <*random*>.

您也可以重新命名快速入門jar檔案來設定連線埠號碼,讓檔案名稱包含連線埠號碼;例如, cq5-publish-p4503.jarcq5-author-p6754.jar.

重新命名快速入門jar檔案時,有多種規則需要遵循:

  • 當您重新命名檔案時,它必須以 cq; 原樣 cq5-publish-p4503.jar.

  • 建議您最好使用 一直 在連線埠號碼前面加上 — p;,如cq5-publish-p4503.jar或cq5-author-p6754.jar。

NOTE
這是為了確保您不需要擔心要執行用來擷取連線埠號碼的規則:
  • 連線埠號碼必須是4或5位數
  • 這些數字必須位於破折號之後
  • 如果檔案名稱中有任何其他數字,則連線埠號碼必須加上前置詞 -p
  • 檔案名稱開頭的「cq5」首碼會被忽略
NOTE
您也可以使用變更連線埠號碼 -port 選項。

Java 11考量事項 java-considerations

如果您執行OracleJava 11 (或通常是8以上的Java版本),啟動AEM時必須在命令列新增其他引數。

  • 下列專案 — -add-opens 需要新增引數,以防止相關的反射存取中的警告訊息 stdout.log
--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

執行模式 run-modes

執行模式 可讓您針對特定目的調整AEM執行個體;例如,製作或發佈、測試、開發、內部網路等。 這些模式也可讓您控制範例內容的使用。 此範例內容是在建置快速入門之前定義,可包含套件、設定等。 如果您想要讓安裝保持精簡且沒有範例內容,這對於生產就緒型安裝特別有用。 如需詳細資訊,請參閱:

新增檔案安裝提供者 adding-a-file-install-provider

預設為資料夾 crx-quickstart/install 會觀看檔案。
此資料夾不存在,但只可在執行階段建立。

如果將套件、設定或內容套件放入此目錄中,則會自動擷取並安裝。 如果移除,則會解除安裝。
這是將套件組合、內容套件或設定放入存放庫的另一種方式。

以下幾種使用案例特別有趣:

  • 在開發期間,將內容放入檔案系統可能會更容易。
  • 如果發生錯誤,將無法存取Web主控台和存放庫。 透過此功能,您可以將其他套件組合放入此目錄中,並且應該安裝這些套件。
  • crx-quickstart/install 資料夾可在快速入門開始之前建立,並且可將其他套件放置在該處。

安裝和啟動Adobe Experience Manager as a Windows Service installing-and-starting-adobe-experience-manager-as-a-windows-service

NOTE
請務必在以管理員身分登入時執行以下程式,或使用啟動/執行這些步驟。 以管理員身分執行 內容功能表選取範圍。
以具有管理員許可權的使用者登入為 不足. 如果您在完成這些步驟時沒有以管理員身分登入,您將會收到 存取遭拒 錯誤。

若要安裝並啟動AEM as a Windows服務:

  1. 以文字編輯器開啟crx-quickstart\opt\helpers\instsrv.bat檔案。

  2. 如果您正在設定64位元Windows伺服器,請根據您的作業系統,使用下列其中一個命令來取代所有prunsrv執行個體:

    • prunsrv_amd64
    • prunsrv_ia64

    這個命令會叫用適當的指令碼,以啟動64位元Java而不是32位元Java中的Windows服務精靈。

  3. 若要防止流程分叉至多個流程,請增加PermGen JVM引數。 找到 set jvm_options 命令並設定值,如下所示:

    set jvm_options=-Xmx1792m

  4. 開啟命令提示字元,將目前目錄變更為AEM安裝的crx-quickstart/opt/helpers資料夾,然後輸入以下命令以建立服務:

    instsrv.bat cq5

    若要確認服務已建立,請開啟「管理工具」控制檯中的「服務」,或鍵入 start services.msc 在命令提示字元中。 cq5服務會出現在清單中。

  5. 執行下列任一項作業來啟動服務:

    • 在「服務」控制檯中,按一下cq5並按一下「開始」。

    chlimage_1-11

    • 在命令列中,輸入net start cq5。

    chlimage_1-12

  6. Windows指出服務正在執行。 AEM會啟動,且prunsrv可執行檔會顯示在「工作管理員」中。 在您的網頁瀏覽器中,導覽至AEM,例如, https://localhost:4502 以開始使用AEM。

    chlimage_1-13

NOTE
建立Windows服務時會使用instsrv.bat檔案中的屬性值。 如果您在instsrv.bat中編輯屬性值,則必須解除安裝再重新安裝服務。
NOTE
安裝AEM as a service時,您必須提供中記錄檔目錄的絕對路徑 com.adobe.xmp.worker.files.ncomm.XMPFilesNComm 從Configuration Manager。

若要解除安裝服務,請按一下 停止服務 在「控制面板」或命令列中,導覽至資料夾並輸入 instsrv.bat -uninstall cq5. 此服務會從的清單中移除, 服務 「控制」面板,或從您鍵入時命令列的清單中選取 net start.

重新定義臨時工作目錄的位置 redefining-the-location-of-the-temporary-work-directory

Java機器之暫存資料夾的預設位置為 /tmp. 例如,AEM在建置套件時也會使用此資料夾。

如果您想要變更暫存資料夾的位置(例如,如果您需要具有更多可用空間的目錄),請定義* <new-tmp-path>*新增JVM引數:

-Djava.io.tmpdir="/<*new-tmp-path*>"

變更為:

  • 伺服器啟動命令列
  • serverctl或啟動指令碼中的CQ_JVM_OPTS環境引數

快速入門檔案中可用的其他選項 further-options-available-from-the-quickstart-file

快速入門說明檔案中會說明其他選項和重新命名慣例,可透過 — help選項取得該檔案。 若要存取說明,請輸入:

  • java -jar cq-quickstart-6.5.0.jar -help
CAUTION
這些選項自AEM 6.5 (6.5.0.0)原始版本起有效。 以後的SP發行版本可能有所變更。
Loading quickstart properties: default
Loading quickstart properties: instance
Setting properties from filename '/Users/Desktop/AEM/cq-quickstart-6.5.0.jar'
--------------------------------------------------------------------------------
Adobe Experience Manager Quickstart (build 20190328)
--------------------------------------------------------------------------------
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
-nointeractive
         Start with no interactivity
-ll <level>
         Define launchpad log level (1 = error...4 = debug)
-n
         Do not install shutdown hook
-D<property>=<value>
         Additional framework properties.
-listener-port <listener-port>
         Set listener port number
-x <string>
         Run a Quickstart extension.
  Options for executing Quickstart extensions:

    -xargs <arg> [<arg> ...]
         Construct an arguments list for a Quickstart extension (for example, -xargs --
         -arg1 val1 -arg2 val2).
--------------------------------------------------------------------------------
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 in "publish" mode,
         example: cq-publish-7502.jar
-dynamicmedia
         Include -dynamicmedia in the renamed jar filename to run in
         "dynamicmedia" mode, example: quickstart-dynamicmedia-4502.jar
-dynamicmedia_scene7
         Include -dynamicmedia_scene7 in the renamed jar filename to run in
         "dynamicmedia_scene7" mode, example:
         quickstart-dynamicmedia_scene7-p4502.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
  /Users/aemdocs/CQInstallationKits/AEM-65150-L8/crx-quickstart/logs.
--------------------------------------------------------------------------------

在Amazon EC2環境中安裝AEM installing-aem-in-the-amazon-ec-environment

在Amazon Elastic Compute Cloud (EC2)例項上安裝AEM時,如果您在EC2例項上同時安裝author和publish,請依照下列程式正確安裝Author例項: 安裝AEM Manager的例項;不過, Publish例項會變成Author。

在EC2環境中安裝Publish執行個體之前,請先執行下列動作:

  1. 在第一次啟動執行個體之前,先解壓縮發佈執行個體的jar檔案。 若要解壓縮檔案,請使用下列命令:

    code language-xml
    java -jar quickstart.jar -unpack
    
    note note
    NOTE
    如果您變更模式 晚於 第一次啟動執行個體時,您無法變更執行模式。
  2. 執行以啟動執行個體:

    code language-xml
    java -jar quickstart.jar -r publish
    
    note caution
    CAUTION
    請務必先執行上述命令,在解壓縮執行個體之後再執行它。 否則,將不會產生quickstart.properties填色。 若沒有此檔案,任何未來的AEM升級都將失敗。
  3. 紙匣 資料夾,開啟 開始 指令碼並核取下列區段:

    code language-xml
    # runmode(s)
    if [ -z "$CQ_RUNMODE" ]; then
     CQ_RUNMODE='author'
    fi
    
  4. 將執行模式變更為 發佈 並儲存檔案。

    code language-xml
    # runmode(s)
    if [ -z "$CQ_RUNMODE" ]; then
     CQ_RUNMODE='publish'
    fi
    
  5. 停止執行個體並透過執行 開始 指令碼。

驗證安裝 verifying-the-installation

下列連結可用來確認您的安裝是否可正常運作(所有範例均以執行個體在localhost的連線埠8080上執行為基礎,且CRX安裝在/crx下,而Launchpad安裝在/下):

  • https://localhost:8080/crx/de
    CRXDE Lite主控台。

  • https://localhost:8080/system/console
    網頁主控台。

安裝後的動作 actions-after-installation

雖然設定AEM WCM有許多可能性,但應執行某些動作,或至少在安裝後立即檢查:

  • 請參閱 安全性檢查清單 用於確保系統安全所需的工作。
  • 檢閱隨AEM WCM安裝的預設使用者和群組清單。 檢查您是否要對任何其他帳戶執行動作 — 請參閱 安全性與使用者管理 以取得更多詳細資料。

存取CRXDE Lite和Web主控台 accessing-crxde-lite-and-the-web-console

AEM WCM啟動後,您就可以存取:

  • CRXDE Lite — 用於存取和管理存放庫
  • 網頁主控台 — 用於管理或設定OSGi套件(也稱為OSGi主控台)

存取CRXDE Lite accessing-crxde-lite

若要開啟CRXDE Lite,您可以選取 CRXDE Lite 從歡迎畫面或使用瀏覽器導覽至

 https://<<i>host</i>>:<<i>port</i>>/crx/de/index.jsp

例如:
https://localhost:4502/crx/de/index.jsp

installcq_crxdelite

存取Web主控台 accessing-the-web-console

若要存取Adobe CQ Web主控台,您可以選取 OSGi控制檯 從歡迎畫面或使用瀏覽器導覽至

 https://<host>:<port>/system/console

例如:
https://localhost:4502/system/console
或適用於「組合」頁面
https://localhost:4502/system/console/bundles

chlimage_1-14

另請參閱 使用Web主控台進行OSGi設定 以取得更多詳細資料。

疑難排解 troubleshooting

如需有關處理安裝期間可能出現問題的資訊,請參閱:

解除安裝Adobe Experience Manager uninstalling-adobe-experience-manager

由於AEM會安裝在單一目錄中,因此不需要解除安裝公用程式。 雖然解除安裝AEM的方式取決於您想要達成的目標以及您使用的永久儲存體,但是解除安裝的方式卻可能像刪除整個安裝目錄一樣簡單。

如果永久儲存裝置內嵌於安裝目錄中(例如,在預設的TarPM安裝中),則刪除資料夾也會移除資料。

NOTE
Adobe強烈建議您先備份存放庫,然後再刪除AEM。 如果您刪除整個 <cq-installation-directory>,您即將刪除存放庫。 若要在刪除之前保留存放庫資料,請移動或複製 <cq-installation-directory>/crx-quickstart/repository資料夾的其他位置,然後再刪除其他資料夾。

如果您安裝的AEM使用外部儲存(例如資料庫伺服器),移除資料夾不會自動移除資料,但會移除儲存設定,因此還原JCR內容相當困難。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2