本节介绍安装独立AEM实例时可用的选项。 您也可以阅读 存储元素 有关全新安装AEM 6后选择后端存储类型的详细信息。
AEM的默认端口为4502。 如果该端口不可用或已在使用中,则Quickstart自动将其自身配置为使用第一个可用的端口号,如下所示:4502、8080、8081、8082、8083、8084、8085、8888、9362, <*random*>
.
您还可以通过重命名快速入门jar文件来设置端口号,以便文件名包含端口号;例如, cq5-publish-p4503.jar
或 cq5-author-p6754.jar
.
重命名快速入门jar文件时遵循各种规则:
重命名文件时,该文件必须以 cq;
as in cq5-publish-p4503.jar
.
建议您 始终 为端口号添加前缀 — p;,与cq5-publish-p4503.jar或cq5-author-p6754.jar中一样。
这是为了确保您无需担心如何履行用于提取端口号的规则:
-p
您还可以使用更改端口号 -port
选项。
如果您运行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升级的实例,请确保将以下属性设置为 true 下 sling.properties
:
felix.bootdelegation.implicit
运行模式 允许您针对特定目的调整AEM实例;例如,创作或发布、测试、开发、内联网等。 这些模式还允许您控制示例内容的使用。 此示例内容是在构建快速入门之前定义的,可以包含包、配置等。 当您希望保持安装精简并且没有示例内容时,这对于生产就绪安装尤其有用。 有关详细信息,请参阅:
默认文件夹 crx-quickstart/install
文件受监视。
此文件夹不存在,但只能在运行时创建。
如果将捆绑包、配置包或内容包放入此目录中,则会自动提取并安装该捆绑包。 如果将其删除,则将其卸载。
这是一种将包、内容包或配置放入存储库的另一种方式。
这对于以下几种用例尤其有趣:
crx-quickstart/install
可以在快速入门开始之前创建文件夹,还可以将其他包放置在该文件夹中。另请参阅 如何在服务器启动时自动安装CRX软件包 例如。
确保以管理员身份登录时执行以下步骤,或使用启动/运行这些步骤 以管理员身份运行 上下文菜单选择。
以具有管理员权限的用户身份登录是 不足. 如果您在完成这些步骤时未以管理员身份登录,则会收到 访问被拒绝 错误。
要安装和启动AEM as a Windows服务,请执行以下操作:
在文本编辑器中打开crx-quickstart\opt\helpers\instsrv.bat文件。
如果您正在配置64位Windows服务器,请根据您的操作系统,使用以下命令之一替换prunsrv的所有实例:
此命令调用相应的脚本,该脚本在64位Java而不是32位Java中启动Windows服务守护程序。
要防止进程分叉到多个进程中,请增加PermGen JVM参数。 找到 set jvm_options
命令,并按如下方式设置值:
set jvm_options=-Xmx1792m
打开命令提示符,将当前目录更改为AEM安装的crx-quickstart/opt/helpers文件夹,然后输入以下命令以创建服务:
instsrv.bat cq5
要验证是否已创建服务,请打开“管理工具”控制面板中的“服务”或键入 start services.msc
在命令提示符下。 cq5服务将显示在列表中。
通过执行以下操作之一来启动服务:
Windows指示服务正在运行。 AEM将启动,并且prunsrv可执行文件会显示在任务管理器中。 在Web浏览器中,导航到AEM,例如, https://localhost:4502
以开始使用AEM。
创建Windows服务时,将使用instsrv.bat文件中的属性值。 如果您在instsrv.bat中编辑属性值,则必须卸载然后重新安装该服务。
安装AEM即服务时,必须提供日志目录的绝对路径 com.adobe.xmp.worker.files.ncomm.XMPFilesNComm
从Configuration Manager。
要卸载该服务,请单击 停止 在 服务 在控制面板或命令行中,导航到文件夹并键入 instsrv.bat -uninstall cq5
. 该服务将从的列表中删除 服务 从命令行中的列表输入 net start
.
Java计算机的临时文件夹的默认位置为 /tmp
. AEM也使用此文件夹,例如在构建包时。
如果要更改临时文件夹的位置(例如,如果需要具有更多可用空间的目录),请定义* <new-tmp-path>
*通过添加JVM参数:
-Djava.io.tmpdir="/<*new-tmp-path*>"
更改为:
快速入门帮助文件中介绍了其他选项和重命名约定,该文件可通过 — help选项获得。 要访问帮助,请键入:
java -jar cq-quickstart-6.5.0.jar -help
这些选项自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 (e.g. -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 Elastic Compute Cloud (EC2)实例上安装AEM时,如果您在EC2实例上同时安装了author和publish,则会按照 安装AEM Manager实例;但是,发布实例会变为“创作”。
在EC2环境中安装Publish实例之前,请执行以下操作:
在首次启动实例之前,请解压缩发布实例的jar文件。 要解压缩文件,请使用以下命令:
java -jar quickstart.jar -unpack
如果更改模式 之后 首次启动实例时,无法更改运行模式。
通过运行以下命令启动实例:
java -jar quickstart.jar -r publish
请确保先运行实例,然后再通过运行上述命令将其解包。 否则,将不会生成quickstart.properties填充。 如果没有此文件,任何未来的AEM升级都将失败。
在 纸盒 文件夹,打开 开始 脚本并检查以下部分:
# runmode(s)
if [ -z "$CQ_RUNMODE" ]; then
CQ_RUNMODE='author'
fi
将运行模式更改为 发布 并保存文件。
# runmode(s)
if [ -z "$CQ_RUNMODE" ]; then
CQ_RUNMODE='publish'
fi
停止实例,并通过运行 开始 脚本。
以下链接可用于验证您的安装是否可正常运行(所有示例都基于实例在本地主机的端口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
或“包”页面的
https://localhost:4502/system/console/bundles
参见 使用Web控制台进行OSGi配置 了解更多详细信息。
有关处理安装过程中可能出现的问题的信息,请参阅:
由于AEM安装在单个目录中,因此不需要卸载实用程序。 虽然卸载AEM的方式取决于要实现的目标以及使用哪些永久存储,但卸载过程可能只限于删除整个安装目录。
如果永久存储嵌入在安装目录中(例如,在默认TarPM安装中),则删除文件夹也会删除数据。
Adobe强烈建议您在删除AEM之前备份存储库。 如果您删除整个 <cq-installation-directory>,您将删除存储库。 要在删除之前保留存储库数据,请移动或复制 <cq-installation-directory>/crx-quickstart/repository文件夹中的其他位置,然后再删除其他文件夹。
如果您安装的AEM使用外部存储(例如,数据库服务器),则删除文件夹不会自动删除数据,但会删除存储配置,这会使恢复JCR内容变得困难。