Application Server Install application-server-install
JAR and WAR are the file types 51黑料不打烊 Experience Manager (AEM) is released in. These formats are undergoing quality assurance to accommodate the support levels 51黑料不打烊 has committed to.This section tells you how to install 51黑料不打烊 Experience Manager (AEM) with an application server. Consult the Supported Platforms section to read about the specific support levels provided for the individual application servers.
The installation steps of the following Application Servers are described:
Consult the appropriate application server documentation for more information on installing web applications, server configurations and how to start and stop the server.
General Description general-description
Default behavior when installing AEM in an Application Server default-behaviour-when-installing-aem-in-an-application-server
AEM comes as a single war file to deploy.
If deployed, the following happens by default:
-
The run mode is
author -
The instance (Repository, Felix OSGI environment, bundles, and so on) is installed in is
${user.dir}/crx-quickstart, where${user.dir}is the current working directory. This path to crx-quickstart is calledsling.home -
The context root is the war file name. For example,
aem-65-lts.
Configuration configuration
You can change the default behavior in the following way:
-
run mode : configure the
sling.run.modesparameter in theWEB-INF/web.xmlfile of the AEM war file before deployment -
sling.home: configure the
sling.homeparameter in theWEB-INF/web.xmlfile of the AEM war file before deployment -
context root: rename the AEM war file
Publish installation publish-installation
To get a publish instance deployed, you need to set the run mode to publish:
- Unpack the
WEB-INF/web.xmlfrom the AEM war file - Change
sling.run.modesparameter to publish - Repack
web.xmlfile into the AEM war file - Deploy AEM war file
Installation check installation-check
To check if everything is installed, you can:
- tail the
error.logfile to see that all content is installed - look in
/system/consolethat all bundles are installed
Two Instances on the same Application Server two-instances-on-the-same-application-server
For demonstration purposes, it can be appropriate to install both author and publish instance in one application server. In order achieve that, you need to:
- Change
sling.homevariable andsling.run.modesvariables of the publish instance - Unpack the
WEB-INF/web.xmlfile from the AEM war file - Change the
sling.homeparameter to a different path (absolute and relative paths are possible) - Change
sling.run.modestopublishfor the publish instance - Repack the
web.xmlfile - Rename the war files, so they have different names. For example, rename one to
aemauthor.warand the other toaempublish.war - Use higher memory settings. For example, default AEM instances use
-Xmx3072m - Deploy the two web applications
- After Deployment stop the two web applications
- In both author and publish instances make sure that in the
sling.propertiesfile the propertyfelix.service.urlhandlersis set tofalse. (The default is that it is set totrue). - Start the two web applications again.
Application Servers Installation Procedures application-servers-installation-procedures
WebSphere庐 24.0.0.7 websphere
Before the deployment, please read the General Description above.
Server Preparation
-
Let Basic Auth Headers pass through:
- One way to let AEM authenticate a user is to disable the global administrative security of the WebSphere庐 server. In order to do that, go to Security > Global Security and uncheck the Enable administrative security checkbox, save, and restart the server.
-
Set
"JAVA_OPTS= -Xmx2048m" -
If you want to install AEM using context root = /, change the context root of the existing Default web application.
Deploy the AEM Web Application
-
Download the AEM war file
-
Make your configurations in the
web.xmlfile if needed. For more info, see General Description above.- Unpack the
WEB-INF/web.xmlfile - Change the
sling.run.modesparameter topublish - Uncomment initial
sling.homeparameter and set this path as you need - Repack the
web.xmlfile.
- Unpack the
-
Deploy the AEM war file
- Choose a context root. If you want to set the sling run modes you need to select the detailed steps of the deploy wizard, then specify it in step 6 of the wizard.
-
Startthe AEM web application
Tomcat 10.0.x/10.1.x tomcat
Before a deployment read the General Description above.
-
Prepare Tomcat Server
-
Increase VM memory settings:
-
In
bin/catalina.bat(respcatalina.shon UNIX庐) add the following setting:code language-none set "JAVA_OPTS= -Xmx2048m`
-
-
Tomcat does not enable admin or manager access at installation. Therefore, you have to manually edit
tomcat-users.xmlto allow access for these accounts:-
Edit
tomcat-users.xmlto include access for admin and manager. The configuration should look similar to the following example:code language-xml <?xml version='1.0' encoding='utf-8'?> <tomcat-users> role rolename="manager"/> role rolename="tomcat"/> <role rolename="admin"/> <role rolename="role1"/> <role rolename="manager-gui"/> <user username="both" password="tomcat" roles="tomcat,role1"/> <user username="tomcat" password="tomcat" roles="tomcat"/> <user username="admin" password="admin" roles="admin,manager-gui"/> <user username="role1" password="tomcat" roles="role1"/> </tomcat-users>
-
-
If you like to deploy AEM with context root 鈥/鈥, then you have to change context root of the existing ROOT webapp:
- Stop and undeploy the ROOT webapp
- Rename the
ROOT.warfolder in Tomcat鈥檚 webapps folder - Start the webapp again
-
If you install the AEM web application using the manager-gui, then you need to increase the maximal size of an uploaded file, as the default only allows 50MB upload size. In order to achieven that open the
web.xmlof the manager web application:webapps/manager/WEB-INF/web.xmland increase the
max-file-sizeandmax-request-sizeto at least 500MB. See see the followingmultipart-configin an exampleweb.xmlfile below:code language-xml <multipart-config> <!-- 500MB max --> <max-file-size>524288000</max-file-size> <max-request-size>524288000</max-request-size> <file-size-threshold>0</file-size-threshold> </multipart-config>
-
-
Deploy the AEM web application
-
Download the AEM war file.
-
Make your configurations in the
web.xmlfile if needed.- Unpack the
WEB-INF/web.xmlfile - Change the
sling.run.modesparameter topublish - Uncomment the initial
sling.homeparameter and set this path as you need - Repack the
web.xmlfile.
- Unpack the
-
Rename the AEM war file to
ROOT.warif you want to deploy it as root webapp. Rename it toaemauthor.warif you want to haveaemauthoras context root. -
Copy it into Tomcat鈥檚 webapps folder
-
Wait until AEM is installed.
-