6.1 General tasks

6.1.1 Configure Allowed Referers

When you run Configuration Manager, the default host, IPv4 address, IPv6 address, loopback address, and localhost address are added to the Allowed Referer list. These addresses are added only for the machine where LCM is executed. For a AEM forms on JEE cluster, manually add all the other cluster nodes to the list:

  1. In administration console, click Settings > User Management > Configuration > Configure Allowed Referer URL’s . The Allowed Referer list appears at the bottom of the page. The default URL of administration console is http://[server]:[host]/adminui.

  2. To add an allowed referer:

    1. Type a host name or IP address in the Allowed Referers box. To add more than one allowed referer at a time, type each host name or IP address on a new line. Provide hostName and IP address of all the cluster nodes/load balancer.

    2. In the HTTP Port and HTTPS Ports boxes, specify which ports to allow for HTTP, HTTPS, or both. If you leave those boxes empty, the default ports (port 80 for HTTP and port 443 for HTTPS) are used. If you enter 0 (zero) in the boxes, all ports on that server are enabled. You can also enter a specific port number to enable only that port.

    3. Click Add.

  3. Click Save .

    If the Allowed Referer List is empty, the CSRF feature stops working and the system becomes insecure.

  4. After changing the Allowed Referer list, restart the AEM forms on JEE cluster.

6.1.2 Perform a system image backup

After AEM forms on JEE is installed and deployed into production areas and before the system is live, it is recommended that you perform a system image backup of the servers on which AEM forms on JEE is implemented. Also take backup of CRX repository.

The AEM forms on JEE database, GDS directory, and application servers must be part of this backup. This is a complete system backup that you can use to restore the contents of your computer if your hard drive or entire computer stops working. See the Backup and Recovery topic in administration help .

6.1.3 Restart the application server

When you first deploy AEM forms on JEE, the server is in a deployment mode in which most modules are in memory. As a result, the memory consumption is high and the server is not in a typical production state. You must restart the application server to get the server back into a clean state.

Note: You may skip to restart the AEM forms on JEE server, if you have restarted the server after configuring CRX clustering or after updating Allowed Referer list
Note: When you upgrade the AEM forms on JEE Server or deploy a Service pack, ensure that you delete the [Jboss_root]\standalone\tmp folders before restarting the application server.
Note: When you upgrade the AEM forms on JEE Server or deploy a Service pack, ensure that you delete the [Jboss_root]\domain\servers\<server name>\tmp folders folders before restarting the application server.

6.1.4 Verify the deployment

You can verify the deployment by logging in to Administration Console. If you log in successfully, then AEM forms on JEE is running on the application server and the default user is created in the database. To verify the CRX repository deployment, access the CRX welcome page.

You can review the application server log files to ensure that components were deployed correctly or to determine the cause of any deployment issues you may encounter.

6.1.4.1 Accessing administration console

AEM forms JEE administration console is the web-based portal for accessing configuration pages where you can set run-time properties that control the way how AEM forms JEE operates. When you log in to the administration console, you can access User Management, Watched Folder, Email client configuration, and administrative configuration options for other services. The administration console also provides access to Applications and Services, which administrators use for managing archives and deploying services to production environment.

The default user name and password for logging in is administrator and password . After you log in the first time, access User Management and change the password.

Before you access administration console, AEM forms JEE must be deployed and running on your application server. For information about using administration console, see administration help .

  1. Type the following URL in a web browser:

    http://[hostname]:[port]/adminui

    For example: http://localhost:8080/adminui

  2. If you have upgraded to AEM forms on JEE, enter the same administrator user name and password as that of your previous installation. In case of a fresh installation, enter the default user name and password.

  3. After you log in, click Services to access the service administration pages or click Settings to access the pages on which you can administer settings for different modules.

6.1.4.2 Change the default password of AEM forms on JEE Administrator

AEM forms on JEE creates one or more default users during the installation. The password for these users is in the product documentation and is publicly available. You must change this default password, depending on your security requirements.

The AEM forms on JEE administrator user password is set to “password” by default. You must change it in Administration console > Settings > User Management > Users and Groups and at the AEM Configuration Management web console.

Change the password in Administration console

  1. Log into the Administration console using administrator/password credentials.

  2. Go to Settings > User Management > Users and Groups .

  3. Search for user Administrator .

  4. Click the Administrator user.

  5. In the Login Settings section, Click Change Password .

  6. Specify a new password and click Save .

  7. Re-login using the changed password to verify.

Change the password inAEM Configuration Management Web console

  1. Log into the Configration Management console using admin/admin credentials. The default URL of console is http://[server]:[port]/lc/system/console/configMgr.

  2. Search and open Adobe Livecycle Client SDK Configuration for editing.

  3. Specify a new password and click Save .

6.1.4.3 Change the default password of AEM Administrators

AEM embedded within AEM forms on JEE creates two administrator users as mentioned below.

  • Super Administrator (administrator) : The Super Administrator user can access various CRX UIs, except OSGi Management Console, and perform admin operations. The default username and password are same as AEM forms on JEE Administrator, administrator/password . The default password of this user can be changed using Administrator console only as mentioned in section Change default password of AEM forms on JEE Administrator . The changed password will be applicable for both AEM forms on JEE and Super Administrators.

  • CRX Administrator (admin) : This user can access to OSGi console in addition to CRX UIs and has administrator privileges. The default username and password for the user are admin/admin . To change the default password, do the following:

    1. Type the following URL in a web browser.

      http://[hostname]:[port]/lc/libs/granite/security/content/useradmin.html

    2. Login using following credential:

      Username : admin

      Password : admin

    3. Search for user Administrator .

    4. Click on the user in left pane, the user details is displayed in the right pane.

    5. Click on Edit icon in the right pane.

    6. On the edit page in the right pane, provide new password in the New Password field and current password in Your Password field.

    7. Click Save icon in the right pane.

    8. Re-login using the changed password to verify.

6.1.4.4 Accessing AEM Welcome Page

AEM welcome page is the web-based portal for accessing various AEM components, administration, deployment and development tools.

Access the welcome page using the following steps:

  1. Type the following URL in a web browser:

    http://[hostname]:[port]/lc/welcome

  2. Enter the AEM forms administrators user name and password. The default user name and password for logging in is administrator and password (same as AEM forms on JEE Administrator).

  3. After you log in, you can access various components, administration, deployment and development UIs.

6.1.4.5 Accessing OSGi Management Console

AEM components are in form of OSGi bundles, which are deployed to Apache Felix OSGi container. OSGi console provides a way to manage OSGi bundles and services configurations.

Access the OSGi Management console using the following steps:

  1. Type the following URL in a web browser:

    http://[hostname]:[port]/lc/system/console

  2. Enter the CRX Administrator username and password as mentioned above. The default user name and password for logging in is admin and admin (same as CRX Administrator).

    Note: You cannot log into OSGi Management Console using the credentials of AEM forms on JEE Administrator or AEM Super Administrator.
  3. After you log in, you can access various components, services, bundles and other configurations.

6.1.4.6 View the log files

Events, such as run-time or startup errors, are recorded to the application server log files. If you have problems deploying to the application server, you can use the log files to help you find the problem. You can open the log files by using any text editor.

Log files, in case of manually-configured JBoss, are located at:

  • (Standalone JBoss) [appserver root] /standalone/log directory

  • (Cluster) [ appserver root] \domain\servers\server-one\log directory

Log files, in case of Adobe-preconfigured JBoss, are located at:

  • (Standalone) [appserver root] /standalone/log directory

  • (Cluster) [ appserver root ]\domain\servers\server-one\log directory

The log files are:

  • server .log

  • boot .log

Following CRX log files are located at [ CRX_home ]/
  • error.log

  • audit.log

  • access.log

  • request.log

  • update.log

// Ethnio survey code removed