[gatein-commits] gatein SVN: r8561 - epp/docs/branches/5.2/Installation_Guide/en-US.

Author: jaredmorgs Date: 2012-03-12 00:19:37 -0400 (Mon, 12 Mar 2012) New Revision: 8561 Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Book_Info.xml epp/docs/branches/5.2/Installation_Guide/en-US/ClusteringConfiguration.xml epp/docs/branches/5.2/Installation_Guide/en-US/DatabaseConfiguration.xml epp/docs/branches/5.2/Installation_Guide/en-US/EMailServiceConfiguration.xml epp/docs/branches/5.2/Installation_Guide/en-US/GadgetProxyConfig.xml epp/docs/branches/5.2/Installation_Guide/en-US/HTTPSConfiguration.xml epp/docs/branches/5.2/Installation_Guide/en-US/Installation_With_ZIP_Download.xml epp/docs/branches/5.2/Installation_Guide/en-US/Native_Components.xml epp/docs/branches/5.2/Installation_Guide/en-US/Post_Installation.xml epp/docs/branches/5.2/Installation_Guide/en-US/Revision_History.xml epp/docs/branches/5.2/Installation_Guide/en-US/SP_Installation.xml epp/docs/branches/5.2/Installation_Guide/en-US/Test_Your_Installation.xml epp/docs/branches/5.2/Installation_Guide/en-US/Uninstall_JBoss.xml Log: https://bugzilla.redhat.com/show_bug.cgi?id=801245 - Converted Gadget Proxy info into task-based format. Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Book_Info.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Book_Info.xml 2012-03-10 10:25:18 UTC (rev 8560) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Book_Info.xml 2012-03-12 04:19:37 UTC (rev 8561) @@ -9,7 +9,7 @@ <productname>JBoss Enterprise Portal Platform</productname> <productnumber>5.2</productnumber> <edition>5.2.1</edition> - <pubsnumber>9</pubsnumber> + <pubsnumber>11</pubsnumber> <abstract> <para>This book provides information about obtaining, installing and running JBoss Enterprise Portal Platform and its add-ons. It forms part of the complete document suite along with the <citetitle>User Guide</citetitle> and <citetitle>Reference Guide</citetitle> available at <ulink url="http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platf... type="http"/>. </para> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/ClusteringConfiguration.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/ClusteringConfiguration.xml 2012-03-10 10:25:18 UTC (rev 8560) +++ epp/docs/branches/5.2/Installation_Guide/en-US/ClusteringConfiguration.xml 2012-03-12 04:19:37 UTC (rev 8561) @@ -3,7 +3,7 @@ <!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent"> %BOOK_ENTITIES; ]> -<section id="sect-Reference_Guide-Clustering_Configuration"> +<section id="Clustering_Configuration"> <title>Clustering Configuration</title> <para>JBoss Enterprise Portal Platform supports high availability and high horizontal and vertical scalability. The setup instructions have been kept to a minimum, however, a good understanding of clustering services in @@ -22,7 +22,7 @@ <para>All cluster nodes must be configured to point to the IDM and JCR shared databases. Refer to <xref linkend="sect-Reference_Guide-Database_Configuration"/> for detailed database set up procedures.</para> </listitem> </itemizedlist> - <section id="sect-Reference_Guide-Clustering_Properties"> + <section id="Clustering_Configure"> <title>Configure</title> <task> <title>Task: Configure Clustering Properties</title> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/DatabaseConfiguration.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/DatabaseConfiguration.xml 2012-03-10 10:25:18 UTC (rev 8560) +++ epp/docs/branches/5.2/Installation_Guide/en-US/DatabaseConfiguration.xml 2012-03-12 04:19:37 UTC (rev 8561) @@ -40,7 +40,6 @@ <title><remark>BZ#794386</remark>Task: Provision JCR and IDM Production Databases</title> <tasksummary> <para>Read and understand the guideline steps in this task to prepare production databases for JBoss Enterprise Portal Platform. </para> - <para/> </tasksummary> <taskprerequisites> <title>Prerequisites</title> @@ -365,7 +364,7 @@ </procedure> </task> </section> - <section> + <section id="First_Run_Database_Schema"> <title>First-run Database Schema Creation</title> <para>When you start JBoss Enterprise Portal Platform for the first time, it will create the proper database schema based on the database configuration you specified in <xref linkend="Single_Portal_JCR_IDM"/> or <xref linkend="Multiple_Portal_JRC_IDM"/>.</para> @@ -373,9 +372,9 @@ <para>JBoss Enterprise Portal Platform assumes the default encoding for your database is <literal>latin1</literal>.</para> </note> - <para>Before starting the server for the first time, continue to <xref linkend="sect-Reference_Guide-EMail_Service_Configuration"/> for the next mandatory configuration requirement.</para> + <para>Before starting the server for the first time, continue to <xref linkend="EMail_Service_Configuration"/> for the next mandatory configuration requirement.</para> </section> - <section> + <section id="MySQL_JCR_IDM_Example"> <title><remark>BZ#794386 and BZ#794687 </remark>MySQL Server 5.1 JCR and IDM Example</title> <para>This section describes an example how to configure MySQL to work with a single portal container. Refer to <xref linkend="Multiple_Portal_JRC_IDM"/> if you need to configure multiple portal containers in your installation, or intend to use Site Publisher. </para> <para>More information about setting up other datasources can be found in the JBoss Enterprise Application Platform <citetitle>Getting Started Guide</citetitle>, in the <citetitle>Using Other Databases</citetitle> chapter. </para> @@ -394,7 +393,7 @@ The <literal>mysql-java-connector</literal> package is available through <ulink url="https://www.redhat.com/wapps/sso/rhn/login.html?redirect=http%3... type="http">Red Hat Network</ulink>. </para> <note> <title>Note: Database Names</title> - <para>The configuration examples that follow assume the database names to be <replaceable>gateinjcr</replaceable> and <replaceable>gateinidm</replaceable>. If you change the database names, update the <filename>gatein-ds.xml</filename> datasource descriptor file accordingly (for each server configuration used). + <para>The configuration examples assume the database names are <replaceable>gateinjcr</replaceable> and <replaceable>gateinidm</replaceable>. If you change the database names, update the <filename>gatein-ds.xml</filename> datasource descriptor file accordingly (for each server configuration used). </para> </note> </tasksummary> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/EMailServiceConfiguration.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/EMailServiceConfiguration.xml 2012-03-10 10:25:18 UTC (rev 8560) +++ epp/docs/branches/5.2/Installation_Guide/en-US/EMailServiceConfiguration.xml 2012-03-12 04:19:37 UTC (rev 8561) @@ -3,7 +3,7 @@ <!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent"> %BOOK_ENTITIES; ]> -<section id="sect-Reference_Guide-EMail_Service_Configuration"> +<section id="EMail_Service_Configuration"> <title>E-Mail Service Configuration</title> <section id="sect-Reference_Guide-EMail_Service_Configuration-Overview"> <title>Overview</title> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/GadgetProxyConfig.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/GadgetProxyConfig.xml 2012-03-10 10:25:18 UTC (rev 8560) +++ epp/docs/branches/5.2/Installation_Guide/en-US/GadgetProxyConfig.xml 2012-03-12 04:19:37 UTC (rev 8561) @@ -3,31 +3,37 @@ <!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent"> %BOOK_ENTITIES; ]> -<section> - <title>Gadget Proxy Configuration</title> - <section> - <title>Overview</title> - <para> - Gadget consumption requires a local anonymous proxy to route access to elements used by the gadgets. +<section id="Gadget_Proxy_Configuration"> + <title><remark>BZ#801245 </remark>Gadget Proxy Configuration</title> + <para>To work around web browser security mechanisms, gadget consumption requires a local anonymous proxy to route access to elements used by the gadgets. </para> - <para> - This must be done to work around web-browser security mechanisms. - </para> - </section> - <section> - <title>Setup the Filter</title> - <para> - The anonymous proxy can be setup to accept or refuse certain hosts. - </para> - <para> + <para>The anonymous proxy is configured to accept or refuse certain hosts by specifying a white-list (of allowed hosts) and a black-list (of denied hosts). + By default, the proxy is closed to any host except the domain on which the gadget server is installed. </para> - <para> - To modify the filtering of domain names, modify: <filename><replaceable>JBOSS_HOME</replaceable>/server/<replaceable>PROFILE</replaceable>/deploy/gatein.ear/02portal.war/WEB-INF/conf/common/common-configuration.xml</filename> - </para> - <example> - <title>common-configuration.xml</title> - <programlisting language="XML" role="XML"><![CDATA[<component> + <task> + <title>Task: Specify White-list and Black-list Gadget Proxy Resources</title> + <tasksummary> + <para>Complete this task to configure the gadget proxy filter to allow a specific list of gadget resources.</para> + </tasksummary> + <taskprerequisites> + <title>Prerequisites</title> + <itemizedlist> + <listitem> + <para>You have installed the platform, and performed all configuration tasks up to this task.</para> + </listitem> + </itemizedlist> + </taskprerequisites> + <procedure> + <step> + <para>Navigate to <filename><replaceable>JBOSS_HOME</replaceable>/server/<replaceable>PROFILE</replaceable>/deploy/gatein.ear/02portal.war/WEB-INF/conf/common/</filename></para> + </step> + <step> + <para>Open <filename>common-configuration.xml</filename> in a text editor.</para> + </step> + <step> + <para>Append the ProxyFilterService &lt;component&gt; block to the file.</para> + <programlisting language="XML"><![CDATA[<component> <key>org.exoplatform.web.security.proxy.ProxyFilterService</key> <type>org.exoplatform.web.security.proxy.ProxyFilterService</type> <init-params> @@ -41,24 +47,34 @@ <value></value> </values-param> </init-params> - </component> ]]> -</programlisting> - </example> - <para> - The proxy will deny access to a resource that is on the blacklist. If the domain name does not match any of the blacklist, the proxy filter will verify if the domain name is on the white list. - </para> - <para> - If the domain name is not defined in either the white list or black list, access will be denied. - </para> - <para> - Multiple values can be added for each list and wildcards can also be used. - </para> - <para> - Below is an example of a valid configuration: - </para> - <example> - <title>Valid Proxy Configuration</title> - <programlisting language="XML" role="XML"><![CDATA[<component> + </component> ]]></programlisting> + </step> + <step> + <para>In the <markup>&lt;name&gt;</markup>white-list<markup>&lt;/name&gt;</markup> block, specify the name of the domains you want to grant access to by adding <markup>&lt;value&gt;</markup> directives for each domain name. </para> + <important> + <para>A required resource must be explicitly defined in the white-list. Failure to do so will result in the resource being treated as black-listed.</para> + </important> + <para>Wildcard characters can be used to simplify configuration. For example, <literal>*.example.com</literal> would allow all domains with <literal>example.com</literal> as the suffix.</para> + </step> + <step> + <para>In the <markup>&lt;name&gt;</markup>black-list<markup>&lt;/name&gt;</markup> block, specify the name of the domains you want to deny access to by adding <markup>&lt;value&gt;</markup> directives for each domain name. </para> + <para>Wildcard characters can be used to simplify configuration. For example, <literal>*.example.com</literal> would deny all domains with <literal>example.com</literal> as the suffix.</para> + </step> + <step> + <para>Save and close <filename>common-configuration.xml</filename>.</para> + </step> + <step> + <formalpara> + <title>Result</title> + <para>You have specified the gadget domains required in your installation.</para> + </formalpara> + </step> + </procedure> + <taskrelated> + <title>Related Information</title> + <example> + <title>Valid Proxy Configuration</title> + <programlisting language="XML" role="XML"><![CDATA[<component> <key>org.exoplatform.web.security.proxy.ProxyFilterService</key> <type>org.exoplatform.web.security.proxy.ProxyFilterService</type> <init-params> @@ -66,15 +82,15 @@ <!-- The white list --> <name>white-list</name> <value>*.example.com</value> - <value>www.example.net&lt;/value> + <value>www.example.net</value> </values-param> <values-param> <name>black-list</name> - <value>evil.example.com</value> + <value>forbidden.example.com</value> </values-param> </init-params> - </component> ]]> -</programlisting> - </example> - </section> +</component>]]></programlisting> + </example> + </taskrelated> + </task> </section> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/HTTPSConfiguration.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/HTTPSConfiguration.xml 2012-03-10 10:25:18 UTC (rev 8560) +++ epp/docs/branches/5.2/Installation_Guide/en-US/HTTPSConfiguration.xml 2012-03-12 04:19:37 UTC (rev 8561) @@ -3,7 +3,7 @@ <!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent"> %BOOK_ENTITIES; ]> -<section id="sect-Installation_Guide-HTTPS_Configuration"> +<section id="HTTPS_Configuration"> <title><remark>BZ#794440 </remark>HTTPS Configuration</title> <remark>https://bugzilla.redhat.com/show_bug.cgi?id=794440 - 20120221 - Reworked the entire section to cover keystore and truststore configuration specific to EPP. </remark> <para>JBoss Enterprise Portal Platform runs by default in HTTP mode. For security purposes, configure your production platform to run in HTTPS mode. </para> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Installation_With_ZIP_Download.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Installation_With_ZIP_Download.xml 2012-03-10 10:25:18 UTC (rev 8560) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Installation_With_ZIP_Download.xml 2012-03-12 04:19:37 UTC (rev 8561) @@ -4,7 +4,7 @@ JBPAPP-4551 - WS CXF Installation --> -<chapter id="Installation_With_ZIP_Download"> +<chapter id="Platform_Installation_ZIP"> <title>ZIP Installation from the Red Hat Customer Portal</title> <para>The Red Hat Customer Portal at <ulink url="http://access.redhat.com">http://access.redhat.com</ulink> provides access to the value of the Red Hat Subscription, including knowledge base articles, support case management, Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Native_Components.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Native_Components.xml 2012-03-10 10:25:18 UTC (rev 8560) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Native_Components.xml 2012-03-12 04:19:37 UTC (rev 8561) @@ -95,7 +95,7 @@ </para> </listitem> </itemizedlist> - <section> + <section id="Native_Components_RHEL"> <title>Red Hat Enterprise Linux-specific notes</title> <para> Red Hat Enterprise Linux includes some of the Native Components in the base operating system. @@ -111,7 +111,7 @@ /opt/user/jboss-epp-<replaceable>VERSION</replaceable>/native/lib. </programlisting> </section> - <section> + <section id="Native_Components_Solaris"> <title>Solaris-specific notes</title> <para> Both the 32-bit and 64-bit versions of <filename>jboss-ep-native</filename> can be installed on the same @@ -195,7 +195,7 @@ </step> <step> <para>Click the - <filename>JBoss EAP <replaceable>VERSION</replaceable> Native Components for <replaceable>OPERATING_SYSTEM</replaceable><replaceable> OS_ARCHITECTURE</replaceable> </filename> + <filename>JBoss EAP <replaceable>VERSION</replaceable> Native Components for <replaceable>OPERATING_SYSTEM</replaceable><replaceable> OS_ARCHITECTURE</replaceable></filename> download link that corresponds with your native operating system.</para> </step> <step> @@ -238,7 +238,7 @@ <formalpara> <title>Result</title> <para>You have installed the native components into the correct directory. </para> - </formalpara> + </formalpara> </step> </procedure> <taskrelated> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Post_Installation.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Post_Installation.xml 2012-03-10 10:25:18 UTC (rev 8560) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Post_Installation.xml 2012-03-12 04:19:37 UTC (rev 8561) @@ -5,7 +5,7 @@ ]> <chapter id="Post_Installation_Configuration"> <title>Post Installation Configuration</title> - <section id="server-config-differences"> + <section id="Choose_a_Server_Profile"> <title>Choose a Server Profile</title> <para>The server profiles shipped with the platform include: <literal>minimal</literal>, <literal>default</literal>, <literal>production</literal>, <literal>all</literal>, <literal>standard</literal> and <literal>web</literal>. </para> @@ -80,7 +80,7 @@ <programlisting>-Xms1303m -Xmx1303m -XX:MaxPermSize=256m ....</programlisting> </para> </section> - <section id="Post-Installation"> + <section id="Configure_Security"> <title>Configure Security </title> <para> When installed from the zip archive, authentication is required to access the majority of JBoss services, including administrative services. User accounts have not been set up to eliminate the possibility of default username/password based attacks. @@ -101,7 +101,7 @@ </listitem> </itemizedlist> </section> - <section id="Disabling_Authentication"> + <section id="Disable_Authentication"> <title>Disable Authentication</title> <para>The JBoss Enterprise Application Platform <citetitle>Installation Guide</citetitle> features a comprehensive chapter about <citetitle>Disabling Authentication</citetitle>. Refer to this chapter for the guidance on the following configuration tasks:</para> <itemizedlist> @@ -119,7 +119,7 @@ </listitem> </itemizedlist> </section> - <section> + <section id="Disable_Pre-Configured_Accounts"> <title>Disable Pre-configured Accounts</title> <para> JBoss Enterprise Portal Platform includes four pre-configured user accounts for testing and evaluation purposes. These accounts can be used for direct access to the portal. @@ -164,7 +164,7 @@ <step> <formalpara> <title>Result</title> - <para>The login links on the front page of the portal main screen are not displayed, and the accounts are not available for use. + <para>The login links on the front page of the portal main screen will not display, and the accounts are not available for use. </para> </formalpara> </step> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Revision_History.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Revision_History.xml 2012-03-10 10:25:18 UTC (rev 8560) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Revision_History.xml 2012-03-12 04:19:37 UTC (rev 8561) @@ -9,6 +9,20 @@ <simpara> <revhistory> <revision> + <revnumber>5.2.1-11</revnumber> + <date>Mon Mar 12 2012</date> + <author> + <firstname>Jared</firstname> + <surname>Morgan</surname> + <email/> + </author> + <revdescription> + <simplelist> + <member>Reworked Gadget Proxy Configuration section as part of https://bugzilla.redhat.com/show_bug.cgi?id=801245. Added id attributes to all sections so it looks better when displayed online.</member> + </simplelist> + </revdescription> + </revision> + <revision> <revnumber>5.2.1-9</revnumber> <date>Wed Mar 7 2012</date> <author> @@ -18,8 +32,8 @@ </author> <revdescription> <simplelist> + <member>Updated Clustering section to be task based as part of https://bugzilla.redhat.com/show_bug.cgi?id=801244. Also added cluster start-up instructions to the Test Your Installation section, and further improved the related task in this section.</member> <member>Removed $JBOSS_HOME section as part of https://bugzilla.redhat.com/show_bug.cgi?id=801248. </member> - <member>Updated Clustering section to be task based as part of https://bugzilla.redhat.com/show_bug.cgi?id=801244. Also added cluster start-up instructions to the Test Your Installation section, and further improved the related task in this section.</member> </simplelist> </revdescription> </revision> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/SP_Installation.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/SP_Installation.xml 2012-03-10 10:25:18 UTC (rev 8560) +++ epp/docs/branches/5.2/Installation_Guide/en-US/SP_Installation.xml 2012-03-12 04:19:37 UTC (rev 8561) @@ -22,7 +22,7 @@ If you do not already have a subscription to JBoss Enterprise Portal Platform, you will need to obtain one in addition to your Site Publisher subscription in order to install and run Site Publisher. </para> </note> - <section id="sect-Site_Publisher_Installation_Guide-Installing_Site_Publisher-Configuration_Locations"> + <section id="Site_Publisher_Configuration_Locations"> <title>Configuration Locations</title> <para>Site Publisher requires configuration files to be copied to the configuration location of the clean JBoss Enterprise Portal Platform instance. </para> @@ -61,7 +61,7 @@ <para>If you intend using a custom configuration profile, copy the files into the corresponding location of your profile. </para> </section> - <section> + <section id="Site_Publisher_Install"> <title>Install</title> <para>Read this section to learn the steps required to install Site Publisher.</para> <task> @@ -76,7 +76,7 @@ <para>Complete <xref linkend="task-Install_The_Platform"/> </para> </listitem> <listitem> - <para>You understand the available Site Publisher configuration locations as described in <xref linkend="sect-Site_Publisher_Installation_Guide-Installing_Site_Publisher-Configuration_Locations"/>.</para> + <para>You understand the available Site Publisher configuration locations as described in <xref linkend="Site_Publisher_Configuration_Locations"/>.</para> </listitem> </itemizedlist> </taskprerequisites> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Test_Your_Installation.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Test_Your_Installation.xml 2012-03-10 10:25:18 UTC (rev 8560) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Test_Your_Installation.xml 2012-03-12 04:19:37 UTC (rev 8561) @@ -4,7 +4,7 @@ %BOOK_ENTITIES; ]> <chapter id="Test_your_Installation"> - <title><remark>BZ#794687 and BZ#801244</remark>Test your Installation</title> + <title><remark>BZ#794687 and BZ#801244 </remark>Test your Installation</title> <para>After you have installed JBoss Enterprise Portal Platform and completed the relevant post installation configuration steps, verify your configuration is correct by starting the platform. </para> <remark>BZ#801244 - 20120309 - Refined task information to include note about sybase startup commands, cluster URL, portal screens dependent on add-ons. One task to cover all start up scenarios.</remark> @@ -17,7 +17,7 @@ <title>Prerequisites</title> <itemizedlist> <listitem> - <para>Complete all tasks in <xref linkend="Installation_With_ZIP_Download"/>.</para> + <para>Complete all tasks in <xref linkend="Platform_Installation_ZIP"/>.</para> </listitem> <listitem> <para>Complete all tasks in <xref linkend="Site_Publisher_Installation"/>, if you intend running Site Publisher.</para> Modified: epp/docs/branches/5.2/Installation_Guide/en-US/Uninstall_JBoss.xml =================================================================== --- epp/docs/branches/5.2/Installation_Guide/en-US/Uninstall_JBoss.xml 2012-03-10 10:25:18 UTC (rev 8560) +++ epp/docs/branches/5.2/Installation_Guide/en-US/Uninstall_JBoss.xml 2012-03-12 04:19:37 UTC (rev 8561) @@ -13,7 +13,7 @@ <title>Prerequisites</title> <itemizedlist> <listitem> - <para>A JBoss Enterprise Portal Platform instance, originally installed using the <xref linkend="Installation_With_ZIP_Download"/> method.</para> + <para>A JBoss Enterprise Portal Platform instance, originally installed using the <xref linkend="Platform_Installation_ZIP"/> method.</para> </listitem> </itemizedlist> </taskprerequisites>