AEM forms on JEE includes IPv6 support. The default configurations
defined in the installation documentation for AEM forms on JEE set
IPv4 as the default IP protocol because this protocol has the most
compatibility with third-party infrastructure.
Do not enable IPv6 unless your deployment must use it. The number
of supported platform configurations is reduced when enabling IPv6
support with AEM forms on JEE. You should verify that all third-party
software, hardware, and networks that you plan to use have IPv6
support before you attempt to enable IPv6.
Note:
If you are enabling CIFS in an IPv6 environment,
you must explicitly enable IPv6 configuration after you configure
your AEM forms on JEE installation using Configuration Manager.
See “Enabling CIFS in IPv6 mode” in the guide for your application server.
3.7.1 Supported IPv6 configurations
Not all infrastructure components support IPv6. For example,
Oracle database does not support IPv6. You can use these databases
by configuring the connection between the application server and
the databases with IPv4, and the remaining communications over IPv6.
Check with your component vendor if IPv6 is supported.
3.7.2 IPv6 implementation guidelines
When you use IPv6 implementation either partially or fully,
keep the following points in mind:
-
After installing AEM forms on JEE, do not use the option
to start the Configuration Manager directly from the AEM forms on
JEE installer. Instead, navigate to the
[aem-forms root]
\configurationManager\bin\IPv6
directory, and run the IPv6-specific script (
ConfigurationManager_IPv6.bat
or
ConfigurationManager_IPv6.sh
)
to launch the Configuration Manager.
-
If you have chosen to validate the application server configuration
using the Configuration Manager, the validation will fail after
you enable IPv6 for the application server. You can ignore this
error message during the process. After you restart the application
server in the IPv6 mode, the application server can connect to the
database.
-
(WebLogic only)
You need to enable IPv6 for the managed
servers only. The Admin Server can continue to run on IPv4, and
can be accessed with its IPv4 address. However, the managed server
that you have started in IPv6 environment can only be accessed through
its IPv6 address or a hostname resolved through DNS.
-
(WebLogic only)
Even if you are running Configuration
Manager on the same computer that hosts the application server,
you must provide the listen address of the managed server for bootstrapping
and deploying AEM forms on JEE modules. This listen address must
be the DNS name that resolves to IPv6 address of the computer.
-
To have a pure IPv6 communication with the database server,
modify both EDC_DS and IDP_DS connection settings to use the hostname
of the database which resolves to a numeric IPv6 address.
-
If
you are installing AEM forms on JEE on to a server cluster, you
must map the numeric IPv6 addresses of each cluster node to the
computer's host name in DNS or in the
hosts
file
on each cluster node.The
hosts
file is located
at:
-
Many software components such as database drivers do not
completely support numeric IPv6 addresses. So, it is recommended
that you use a DNS-resolved hostname instead of numeric IPv6 addresses.
-
Ensure that name used for mapping IPv6 is added to the CSRF
filter section. If the name is not added, see
Preventing
CSRF attacks
in
Administration Help
.
Note:
Name used
for mapping IPv6 must not contain square brackets ([]).
-
In an IPv6 environment, if you are using Microsoft SQL Server,
you should specify the database server IP address in the following
format. Note that in this string,
;serverName
is a keyword,
and so must not be replaced with the actual server name.
jdbc:sqlserver://;serverName=<IPv6 address>; portNumber=<port>;databaseName=<db_name>
Here,
instead of the numeric IPv6 address, you can specify the hostname
of the SQL Server database.
3.7.3 Configuring IPv6 for JBoss
-
You can download and install JBoss from
http://www.jboss.org/jbossas/downloads/
or
obtain the jboss.zip file from the third-party directory on the
installation media and extract the bundled JBoss.
-
Modify adobe-ds.xml and the database-specific data source
configuration file to connect to the AEM forms on JEE database.
-
Modify the login-config.xml file to connect to the AEM forms
on JEE database.
-
For
clusters, modify the
jgroups-channelfactory-stacks.xml
files to
enable IPv6. Refer to
Configuring AEM forms on JEE Application Server Clusters Using JBoss
.
-
Modify the following files to enable IPv6:
-
Launch Configuration Manager by invoking the
[aem-forms root]
\configurationManager\bin\IPv6\
ConfigurationManager_IPv6.bat or ConfigurationManager_IPv6.sh script.
-
In the Configuration Manager, select the steps to configure
EAR files, bootstrap and deploy AEM forms on JEE modules.
-
After the Configuration Manager process is completed, copy
these EAR files to the
[appserver root]
\\standalone\deployments
directory.
-
Start JBoss from a command line.
-
Provide Configuration Manager hostname of the computer that
is mapped to its IPv6 address and then bootstrap the application
server to deploy the AEM forms on JEE modules.
3.7.4 Configuring IPv6 for WebLogic
-
Install AEM forms on JEE using the installer.
-
Do not launch the Configuration Manager when the installer
finishes. Launch Configuration Manager by invoking the
[aem-forms root]
\configurationManager\bin\IPv6\ConfigurationManager_IPv6.bat
or ConfigurationManager_IPv6.sh script.
-
Select the options to configure AEM forms on JEE EARs, WebLogic
application server, and verify the application server settings using
Configuration Manager.
Note:
You will get an error message that the Configuration
Manager validation of data source has failed. This is because the
application server is not yet started in the IPv6 mode, and the
data source is now configured in the IPv6 mode. You can ignore this
warning at this stage.
-
From the WebLogic Server Administration Console, change
the application
Server Start
arguments of the managed server
to enable IPv6.
-
Change the listen address of the managed server to enable
it using IPv6 address.
-
In the WebLogic Server Administration
Console, select
Environment
>
Servers
>
[managed server name]
Configuration
tab.
-
In the Listen Address field, enter the hostname of the computer.
Ensure that this hostname resolves to the IPv6 address of this computer.
-
Save the changes, and then restart the managed server.
-
Launch Configuration Manager by invoking the
[aem-forms root]
\configurationManager\bin\IPv6\ConfigurationManager_IPv6.bat
or ConfigurationManager_IPv6.sh script.
-
In the Configuration Manager, select the steps to deploy
EAR files, bootstrap, deploy AEM forms on JEE modules.
-
Enter the same hostname as provided in the listen address
field of the managed server.
Note:
Even if you are running Configuration Manager
on the same computer, you must provide the listen address of the
managed server for bootstrapping and deploying AEM forms on JEE
modules.
3.7.5 Configuring IPv6 for WebSphere
-
Install AEM forms on JEE using the installer script.
After the installation is complete, do not start the Configuration
Manager when the installer prompts.
-
Navigate to the
[aem-forms root]
\configurationManager\bin\IPv6
directory, and run the IPv6-specific script (
ConfigurationManager_IPv6.bat
or
ConfigurationManager_IPv6.sh
)
to launch LCM.
-
Use the Configuration Manager options to configure EAR and
the application server.
-
Follow the steps in the Configuration Manager to configure
the application server. While configuring database, provide hostname
of database that is mapped to IPv6 address.
-
Validate the application server configuration by Configuration
Manager. Ignore the warning if data source validation fails. You
can validate data sources from WebSphere Administrative Console.
-
On the WebSphere Administrative Console, select
Servers > Server Types > WebSphere application servers >
[server name]
> Java and Process Management > Process definition > Java Virtual Machine
.
In
Generic JVM arguments
, add the
-Djava.net.preferIPv6Addresses=true
argument.
-
Select
Servers > Server Types > WebSphere application servers >
[server name]
> Java and Process Management > Process definition > Java Virtual Machine
,
and click
Custom Properties
. Change
java.net.preferIPv4Stack=true
to
java.net.preferIPv6Stack=true
.
-
Manually deploy the EAR files to WebSphere Application Server
by using WebSphere Administrative Console. Configured EAR files
are available at
[aem-forms root]
/configurationManager/export
folder.
-
Restart WebSphere Application Server.
-
Navigate to the
[aem-forms root]
\configurationManager\bin\IPv6
directory, and run ConfigurationManager_IPv6.bat or ConfigurationManager_IPv6.sh
to launch Configuration Manager.
-
In the Configuration Manager, select the options to bootstrap
and deploy AEM forms on JEE modules. Provide the application server
hostname that is mapped to IPv6 address.
Note:
After you start the application server in an
IPv6 environment, (with the flag
-Djava.net.preferIPv6Stack=true
),
you can access it only through its IPv6 address or hostname mapped
to IPv6 address.
|
|
|