Modified: portals/site-live/applications/issue-tracking.html URL: http://svn.apache.org/viewvc/portals/site-live/applications/issue-tracking.html?rev=1901430&r1=1901429&r2=1901430&view=diff ============================================================================== --- portals/site-live/applications/issue-tracking.html (original) +++ portals/site-live/applications/issue-tracking.html Tue May 31 02:23:06 2022 @@ -1,196 +1,169 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> - - - - - - - - - - - -<html xmlns="http://www.w3.org/1999/xhtml";> - <head> - <title>Apache Portals Applications - Issue Tracking</title> - <style type="text/css" media="all"> - @import url("./css/maven-base.css"); - @import url("./css/maven-theme.css"); - @import url("./css/site.css"); - </style> - <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" /> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> - </head> - <body class="composite"> - <div id="banner"> - <a href="http://portals.apache.org/"; id="bannerLeft"> - - <img src="images/apache-portals.gif" alt="" /> - - </a> - <a href="http://portals.apache.org/applications/"; id="bannerRight"> - - Apache Portals Applications - - </a> - <div class="clear"> - <hr/> - </div> - </div> - <div id="breadcrumbs"> - - - - - - - - - <div class="xleft"> - Last Published: 29 September 2011 - </div> - <div class="xright"> <a href="http://portals.apache.org/"; class="externalLink">Portals</a> - | - <a href="http://portals.apache.org/jetspeed-2"; class="externalLink">Jetspeed-2</a> - | - <a href="http://portals.apache.org/bridges"; class="externalLink">Bridges</a> - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - <div id="leftColumn"> - <div id="navcolumn"> - - - - - - - - - <h5>Essentials</h5> - <ul> - - <li class="none"> - <a href="index.html">Welcome</a> - </li> - - <li class="none"> - <a href="news.html">News and Status</a> - </li> - - <li class="none"> - <a href="download.html">Download</a> - </li> - - <li class="none"> - <a href="getting-started.html">Getting Started</a> - </li> - </ul> - <h5>Subprojects</h5> - <ul> - - <li class="none"> - <a href="./portals-gems/index.html">Gems</a> - </li> - - <li class="none"> - <a href="./demo/index.html">Demo</a> - </li> - - <li class="none"> - <a href="./rss-main/index.html">RSS</a> - </li> - - <li class="none"> - <a href="./webcontent/index.html">WebContent</a> - </li> - - <li class="none"> - <a href="./dbbrowser/index.html">DB Browser</a> - </li> - - <li class="none"> - <a href="./logging/index.html">Logging</a> - </li> - </ul> - <h5>Support</h5> - <ul> - - <li class="none"> - <a href="team-list.html">Project Team</a> - </li> - - <li class="none"> - <a href="license.html">Project License</a> - </li> - - <li class="none"> - <a href="http://wiki.apache.org/portals/applications"; class="externalLink">Project Wiki</a> - </li> - - <li class="none"> - <a href="mail-lists.html">Mailing List</a> - </li> - - <li class="none"> - <strong>Issue Tracking</strong> - </li> - </ul> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img alt="Built by Maven" src="./images/logos/maven-feather.png"></img> - </a> - - - - - - - - - </div> - </div> - <div id="bodyColumn"> - <div id="contentBox"> - <div class="section"><h2>Overview</h2> -This project uses <a class="externalLink" href="http://www.atlassian.com/software/jira";>JIRA</a> a J2EE-based, issue tracking and project management application.</div> -<div class="section"><h2>Issue Tracking</h2> -<p>Issues, bugs, and feature requests should be submitted to the following issue tracking system for this project.</p> -<div class="source"><pre><a class="externalLink" href="http://issues.apache.org/jira/browse/APA";>http://issues.apache.org/jira/browse/APA</a></pre> -</div> -</div> - - </div> - </div> - <div class="clear"> - <hr/> - </div> - <div id="footer"> - <div class="xright">© - 2004-2011 - - Apache Software Foundation - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - </body> -</html> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> +<!-- Generated by Apache Maven Doxia Site Renderer 1.4 at 31 May 2022 --> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <title>Apache Portals Applications - Issue Management</title> + <style type="text/css" media="all"> + @import url("./css/maven-base.css"); + @import url("./css/maven-theme.css"); + @import url("./css/site.css"); + </style> + <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" /> + <meta name="Date-Revision-yyyymmdd" content="20220531" /> + <meta http-equiv="Content-Language" content="en" /> + + </head> + <body class="composite"> + <div id="banner"> + <a href="http://portals.apache.org/"; id="bannerLeft"> + <img src="images/apache-portals.gif" alt="Apache Software Foundation" /> + </a> + <a href="http://portals.apache.org/applications/"; id="bannerRight"> + Apache Portals Applications + </a> + <div class="clear"> + <hr/> + </div> + </div> + <div id="breadcrumbs"> + + + <div class="xleft"> + <span id="publishDate">Last Published: 31 May 2022</span> + | <span id="projectVersion">Version: 1.0</span> + </div> + <div class="xright"> <a href="http://portals.apache.org/"; class="externalLink" target="_nw" title="Portals">Portals</a> + | + <a href="http://portals.apache.org/jetspeed-2"; class="externalLink" target="_nw" title="Jetspeed-2">Jetspeed-2</a> + | + <a href="http://portals.apache.org/bridges"; class="externalLink" target="_nw" title="Bridges">Bridges</a> + + + </div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="leftColumn"> + <div id="navcolumn"> + + + <h5>Essentials</h5> + <ul> + <li class="none"> + <a href="index.html" title="Welcome">Welcome</a> + </li> + <li class="none"> + <a href="news.html" title="News and Status">News and Status</a> + </li> + <li class="none"> + <a href="download.html" title="Download">Download</a> + </li> + <li class="none"> + <a href="getting-started.html" title="Getting Started">Getting Started</a> + </li> + </ul> + <h5>Subprojects</h5> + <ul> + <li class="none"> + <a href="./portals-gems/index.html" title="Gems">Gems</a> + </li> + <li class="none"> + <a href="./demo/index.html" title="Demo">Demo</a> + </li> + <li class="none"> + <a href="./rss-main/index.html" title="RSS">RSS</a> + </li> + <li class="expanded"> + <a href="./webcontent2/index.html" title="WebContent-2">WebContent-2</a> + <ul> + <li class="none"> + <a href="./webcontent2/modules-overview.html" title="Modules Overview">Modules Overview</a> + </li> + <li class="none"> + <a href="./webcontent2/content-rewriter-module.html" title="Content Rewriter Module">Content Rewriter Module</a> + </li> + <li class="none"> + <a href="./webcontent2/reverse-proxy-module.html" title="Reverse Proxy Module">Reverse Proxy Module</a> + </li> + <li class="none"> + <a href="./webcontent2/portlets-module.html" title="Portlets Module">Portlets Module</a> + </li> + <li class="none"> + <a href="./webcontent2/war-module.html" title="WAR Module">WAR Module</a> + </li> + <li class="none"> + <a href="./webcontent2/build-from-source.html" title="Build from source">Build from source</a> + </li> + <li class="none"> + <a href="./webcontent2/apidocs/index.html" title="JavaDocs">JavaDocs</a> + </li> + <li class="none"> + <a href="./webcontent2/faq.html" title="FAQ">FAQ</a> + </li> + </ul> + </li> + <li class="none"> + <a href="./webcontent/index.html" title="WebContent-1">WebContent-1</a> + </li> + <li class="none"> + <a href="./dbbrowser/index.html" title="DB Browser">DB Browser</a> + </li> + <li class="none"> + <a href="./logging/index.html" title="Logging">Logging</a> + </li> + </ul> + <h5>Support</h5> + <ul> + <li class="none"> + <a href="team-list.html" title="Project Team">Project Team</a> + </li> + <li class="none"> + <a href="license.html" title="Project License">Project License</a> + </li> + <li class="none"> + <a href="http://wiki.apache.org/portals/applications"; class="externalLink" title="Project Wiki">Project Wiki</a> + </li> + <li class="none"> + <a href="mail-lists.html" title="Mailing List">Mailing List</a> + </li> + <li class="none"> + <strong>Issue Tracking</strong> + </li> + </ul> + <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> + <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /> + </a> + + + </div> + </div> + <div id="bodyColumn"> + <div id="contentBox"> + <div class="section"> +<h2>Overview<a name="Overview"></a></h2><a name="Overview"></a> +<p>This project uses <a class="externalLink" href="http://www.atlassian.com/software/jira";>JIRA</a>.</p></div> +<div class="section"> +<h2>Issue Management<a name="Issue_Management"></a></h2><a name="Issue_Management"></a> +<p>Issues, bugs, and feature requests should be submitted to the following issue management system for this project.</p> +<div class="source"> +<pre><a class="externalLink" href="http://issues.apache.org/jira/browse/APA";>http://issues.apache.org/jira/browse/APA</a></pre></div></div> + </div> + </div> + <div class="clear"> + <hr/> + </div> + <div id="footer"> + <div class="xright"> + Copyright © 2004-2022 + <a href="http://www.apache.org/";>Apache Software Foundation</a>. + All Rights Reserved. + + </div> + <div class="clear"> + <hr/> + </div> + </div> + </body> +</html>
Modified: portals/site-live/applications/license.html URL: http://svn.apache.org/viewvc/portals/site-live/applications/license.html?rev=1901430&r1=1901429&r2=1901430&view=diff ============================================================================== --- portals/site-live/applications/license.html (original) +++ portals/site-live/applications/license.html Tue May 31 02:23:06 2022 @@ -1,437 +1,375 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> - - - - - - - - - - - -<html xmlns="http://www.w3.org/1999/xhtml";> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache Portals Applications - Apache License, version 2.0</title> - <style type="text/css" media="all"> - @import url("./css/maven-base.css"); - @import url("./css/maven-theme.css"); - @import url("./css/site.css"); - </style> - <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" /> - </head> - <body class="composite"> - <div id="banner"> - <a href="http://portals.apache.org/"; id="bannerLeft"> - - <img src="images/apache-portals.gif" alt="" /> - - </a> - <a href="http://portals.apache.org/applications/"; id="bannerRight"> - - Apache Portals Applications - - </a> - <div class="clear"> - <hr/> - </div> - </div> - <div id="breadcrumbs"> - - - - - - - - - <div class="xleft"> - Last Published: 4 March 2015 - </div> - <div class="xright"> <a href="http://portals.apache.org/"; class="externalLink">Portals</a> - | - <a href="http://portals.apache.org/jetspeed-2"; class="externalLink">Jetspeed-2</a> - | - <a href="http://portals.apache.org/bridges"; class="externalLink">Bridges</a> - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - <div id="leftColumn"> - <div id="navcolumn"> - - - - - - - - - <h5>Essentials</h5> - <ul> - - <li class="none"> - <a href="index.html">Welcome</a> - </li> - - <li class="none"> - <a href="news.html">News and Status</a> - </li> - - <li class="none"> - <a href="download.html">Download</a> - </li> - - <li class="none"> - <a href="getting-started.html">Getting Started</a> - </li> - </ul> - <h5>Subprojects</h5> - <ul> - - <li class="none"> - <a href="./portals-gems/index.html">Gems</a> - </li> - - <li class="none"> - <a href="./demo/index.html">Demo</a> - </li> - - <li class="none"> - <a href="./rss-main/index.html">RSS</a> - </li> - - - - - - - - - - - - - - - - - - - - <li class="expanded"> - <a href="./webcontent2/index.html">WebContent-2</a> - <ul> - - <li class="none"> - <a href="./webcontent2/modules-overview.html">Modules Overview</a> - </li> - - <li class="none"> - <a href="./webcontent2/content-rewriter-module.html">Content Rewriter Module</a> - </li> - - <li class="none"> - <a href="./webcontent2/reverse-proxy-module.html">Reverse Proxy Module</a> - </li> - - <li class="none"> - <a href="./webcontent2/portlets-module.html">Portlets Module</a> - </li> - - <li class="none"> - <a href="./webcontent2/war-module.html">WAR Module</a> - </li> - - <li class="none"> - <a href="./webcontent2/build-from-source.html">Build from source</a> - </li> - - <li class="none"> - <a href="./webcontent2/apidocs/index.html">JavaDocs</a> - </li> - - <li class="none"> - <a href="./webcontent2/faq.html">FAQ</a> - </li> - </ul> - </li> - - <li class="none"> - <a href="./webcontent/index.html">WebContent-1</a> - </li> - - <li class="none"> - <a href="./dbbrowser/index.html">DB Browser</a> - </li> - - <li class="none"> - <a href="./logging/index.html">Logging</a> - </li> - </ul> - <h5>Support</h5> - <ul> - - <li class="none"> - <a href="team-list.html">Project Team</a> - </li> - - <li class="none"> - <strong>Project License</strong> - </li> - - <li class="none"> - <a href="http://wiki.apache.org/portals/applications"; class="externalLink">Project Wiki</a> - </li> - - <li class="none"> - <a href="mail-lists.html">Mailing List</a> - </li> - - <li class="none"> - <a href="issue-tracking.html">Issue Tracking</a> - </li> - </ul> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img alt="Built by Maven" src="./images/logos/maven-feather.png"></img> - </a> - - - - - - - - - </div> - </div> - <div id="bodyColumn"> - <div id="contentBox"> - <div class="section"><h2><a name="Apache_License_version_2.0"></a>Apache License, version 2.0</h2> -<pre> -Apache License -Version 2.0, January 2004 -http://www.apache.org/licenses/ - -TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - -1. Definitions. - -"License" shall mean the terms and conditions for use, reproduction, -and distribution as defined by Sections 1 through 9 of this document. - -"Licensor" shall mean the copyright owner or entity authorized by -the copyright owner that is granting the License. - -"Legal Entity" shall mean the union of the acting entity and all -other entities that control, are controlled by, or are under common -control with that entity. For the purposes of this definition, -"control" means (i) the power, direct or indirect, to cause the -direction or management of such entity, whether by contract or -otherwise, or (ii) ownership of fifty percent (50%) or more of the -outstanding shares, or (iii) beneficial ownership of such entity. - -"You" (or "Your") shall mean an individual or Legal Entity -exercising permissions granted by this License. - -"Source" form shall mean the preferred form for making modifications, -including but not limited to software source code, documentation -source, and configuration files. - -"Object" form shall mean any form resulting from mechanical -transformation or translation of a Source form, including but -not limited to compiled object code, generated documentation, -and conversions to other media types. - -"Work" shall mean the work of authorship, whether in Source or -Object form, made available under the License, as indicated by a -copyright notice that is included in or attached to the work -(an example is provided in the Appendix below). - -"Derivative Works" shall mean any work, whether in Source or Object -form, that is based on (or derived from) the Work and for which the -editorial revisions, annotations, elaborations, or other modifications -represent, as a whole, an original work of authorship. For the purposes -of this License, Derivative Works shall not include works that remain -separable from, or merely link (or bind by name) to the interfaces of, -the Work and Derivative Works thereof. - -"Contribution" shall mean any work of authorship, including -the original version of the Work and any modifications or additions -to that Work or Derivative Works thereof, that is intentionally -submitted to Licensor for inclusion in the Work by the copyright owner -or by an individual or Legal Entity authorized to submit on behalf of -the copyright owner. For the purposes of this definition, "submitted" -means any form of electronic, verbal, or written communication sent -to the Licensor or its representatives, including but not limited to -communication on electronic mailing lists, source code control systems, -and issue tracking systems that are managed by, or on behalf of, the -Licensor for the purpose of discussing and improving the Work, but -excluding communication that is conspicuously marked or otherwise -designated in writing by the copyright owner as "Not a Contribution." - -"Contributor" shall mean Licensor and any individual or Legal Entity -on behalf of whom a Contribution has been received by Licensor and -subsequently incorporated within the Work. - -2. Grant of Copyright License. Subject to the terms and conditions of -this License, each Contributor hereby grants to You a perpetual, -worldwide, non-exclusive, no-charge, royalty-free, irrevocable -copyright license to reproduce, prepare Derivative Works of, -publicly display, publicly perform, sublicense, and distribute the -Work and such Derivative Works in Source or Object form. - -3. Grant of Patent License. Subject to the terms and conditions of -this License, each Contributor hereby grants to You a perpetual, -worldwide, non-exclusive, no-charge, royalty-free, irrevocable -(except as stated in this section) patent license to make, have made, -use, offer to sell, sell, import, and otherwise transfer the Work, -where such license applies only to those patent claims licensable -by such Contributor that are necessarily infringed by their -Contribution(s) alone or by combination of their Contribution(s) -with the Work to which such Contribution(s) was submitted. If You -institute patent litigation against any entity (including a -cross-claim or counterclaim in a lawsuit) alleging that the Work -or a Contribution incorporated within the Work constitutes direct -or contributory patent infringement, then any patent licenses -granted to You under this License for that Work shall terminate -as of the date such litigation is filed. - -4. Redistribution. You may reproduce and distribute copies of the -Work or Derivative Works thereof in any medium, with or without -modifications, and in Source or Object form, provided that You -meet the following conditions: - -(a) You must give any other recipients of the Work or -Derivative Works a copy of this License; and - -(b) You must cause any modified files to carry prominent notices -stating that You changed the files; and - -(c) You must retain, in the Source form of any Derivative Works -that You distribute, all copyright, patent, trademark, and -attribution notices from the Source form of the Work, -excluding those notices that do not pertain to any part of -the Derivative Works; and - -(d) If the Work includes a "NOTICE" text file as part of its -distribution, then any Derivative Works that You distribute must -include a readable copy of the attribution notices contained -within such NOTICE file, excluding those notices that do not -pertain to any part of the Derivative Works, in at least one -of the following places: within a NOTICE text file distributed -as part of the Derivative Works; within the Source form or -documentation, if provided along with the Derivative Works; or, -within a display generated by the Derivative Works, if and -wherever such third-party notices normally appear. The contents -of the NOTICE file are for informational purposes only and -do not modify the License. You may add Your own attribution -notices within Derivative Works that You distribute, alongside -or as an addendum to the NOTICE text from the Work, provided -that such additional attribution notices cannot be construed -as modifying the License. - -You may add Your own copyright statement to Your modifications and -may provide additional or different license terms and conditions -for use, reproduction, or distribution of Your modifications, or -for any such Derivative Works as a whole, provided Your use, -reproduction, and distribution of the Work otherwise complies with -the conditions stated in this License. - -5. Submission of Contributions. Unless You explicitly state otherwise, -any Contribution intentionally submitted for inclusion in the Work -by You to the Licensor shall be under the terms and conditions of -this License, without any additional terms or conditions. -Notwithstanding the above, nothing herein shall supersede or modify -the terms of any separate license agreement you may have executed -with Licensor regarding such Contributions. - -6. Trademarks. This License does not grant permission to use the trade -names, trademarks, service marks, or product names of the Licensor, -except as required for reasonable and customary use in describing the -origin of the Work and reproducing the content of the NOTICE file. - -7. Disclaimer of Warranty. Unless required by applicable law or -agreed to in writing, Licensor provides the Work (and each -Contributor provides its Contributions) on an "AS IS" BASIS, -WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or -implied, including, without limitation, any warranties or conditions -of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A -PARTICULAR PURPOSE. You are solely responsible for determining the -appropriateness of using or redistributing the Work and assume any -risks associated with Your exercise of permissions under this License. - -8. Limitation of Liability. In no event and under no legal theory, -whether in tort (including negligence), contract, or otherwise, -unless required by applicable law (such as deliberate and grossly -negligent acts) or agreed to in writing, shall any Contributor be -liable to You for damages, including any direct, indirect, special, -incidental, or consequential damages of any character arising as a -result of this License or out of the use or inability to use the -Work (including but not limited to damages for loss of goodwill, -work stoppage, computer failure or malfunction, or any and all -other commercial damages or losses), even if such Contributor -has been advised of the possibility of such damages. - -9. Accepting Warranty or Additional Liability. While redistributing -the Work or Derivative Works thereof, You may choose to offer, -and charge a fee for, acceptance of support, warranty, indemnity, -or other liability obligations and/or rights consistent with this -License. However, in accepting such obligations, You may act only -on Your own behalf and on Your sole responsibility, not on behalf -of any other Contributor, and only if You agree to indemnify, -defend, and hold each Contributor harmless for any liability -incurred by, or claims asserted against, such Contributor by reason -of your accepting any such warranty or additional liability. - -END OF TERMS AND CONDITIONS - -APPENDIX: How to apply the Apache License to your work. - -To apply the Apache License to your work, attach the following -boilerplate notice, with the fields enclosed by brackets "[]" -replaced with your own identifying information. (Don't include -the brackets!) The text should be enclosed in the appropriate -comment syntax for the file format. We also recommend that a -file or class name and description of purpose be included on the -same "printed page" as the copyright notice for easier -identification within third-party archives. - -Copyright 2004 The Apache Software Foundation - </pre></div> - - </div> - </div> - <div class="clear"> - <hr/> - </div> - <div id="footer"> - <div class="xright">© - 2004-2015 - - Apache Software Foundation - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - </body> -</html> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> +<!-- Generated by Apache Maven Doxia Site Renderer 1.4 at 26 May 2022 --> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <title>Apache Portals Applications - + Apache License, version 2.0</title> + <style type="text/css" media="all"> + @import url("./css/maven-base.css"); + @import url("./css/maven-theme.css"); + @import url("./css/site.css"); + </style> + <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" /> + <meta name="Date-Revision-yyyymmdd" content="20220526" /> + <meta http-equiv="Content-Language" content="en" /> + + </head> + <body class="composite"> + <div id="banner"> + <a href="http://portals.apache.org/"; id="bannerLeft"> + <img src="images/apache-portals.gif" alt="Apache Software Foundation" /> + </a> + <a href="http://portals.apache.org/applications/"; id="bannerRight"> + Apache Portals Applications + </a> + <div class="clear"> + <hr/> + </div> + </div> + <div id="breadcrumbs"> + + + <div class="xleft"> + <span id="publishDate">Last Published: 26 May 2022</span> + | <span id="projectVersion">Version: 1.0</span> + </div> + <div class="xright"> <a href="http://portals.apache.org/"; class="externalLink" target="_nw" title="Portals">Portals</a> + | + <a href="http://portals.apache.org/jetspeed-2"; class="externalLink" target="_nw" title="Jetspeed-2">Jetspeed-2</a> + | + <a href="http://portals.apache.org/bridges"; class="externalLink" target="_nw" title="Bridges">Bridges</a> + + + </div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="leftColumn"> + <div id="navcolumn"> + + + <h5>Essentials</h5> + <ul> + <li class="none"> + <a href="index.html" title="Welcome">Welcome</a> + </li> + <li class="none"> + <a href="news.html" title="News and Status">News and Status</a> + </li> + <li class="none"> + <a href="download.html" title="Download">Download</a> + </li> + <li class="none"> + <a href="getting-started.html" title="Getting Started">Getting Started</a> + </li> + </ul> + <h5>Subprojects</h5> + <ul> + <li class="none"> + <a href="./portals-gems/index.html" title="Gems">Gems</a> + </li> + <li class="none"> + <a href="./demo/index.html" title="Demo">Demo</a> + </li> + <li class="none"> + <a href="./rss-main/index.html" title="RSS">RSS</a> + </li> + <li class="expanded"> + <a href="./webcontent2/index.html" title="WebContent-2">WebContent-2</a> + <ul> + <li class="none"> + <a href="./webcontent2/modules-overview.html" title="Modules Overview">Modules Overview</a> + </li> + <li class="none"> + <a href="./webcontent2/content-rewriter-module.html" title="Content Rewriter Module">Content Rewriter Module</a> + </li> + <li class="none"> + <a href="./webcontent2/reverse-proxy-module.html" title="Reverse Proxy Module">Reverse Proxy Module</a> + </li> + <li class="none"> + <a href="./webcontent2/portlets-module.html" title="Portlets Module">Portlets Module</a> + </li> + <li class="none"> + <a href="./webcontent2/war-module.html" title="WAR Module">WAR Module</a> + </li> + <li class="none"> + <a href="./webcontent2/build-from-source.html" title="Build from source">Build from source</a> + </li> + <li class="none"> + <a href="./webcontent2/apidocs/index.html" title="JavaDocs">JavaDocs</a> + </li> + <li class="none"> + <a href="./webcontent2/faq.html" title="FAQ">FAQ</a> + </li> + </ul> + </li> + <li class="none"> + <a href="./webcontent/index.html" title="WebContent-1">WebContent-1</a> + </li> + <li class="none"> + <a href="./dbbrowser/index.html" title="DB Browser">DB Browser</a> + </li> + <li class="none"> + <a href="./logging/index.html" title="Logging">Logging</a> + </li> + </ul> + <h5>Support</h5> + <ul> + <li class="none"> + <a href="team-list.html" title="Project Team">Project Team</a> + </li> + <li class="none"> + <strong>Project License</strong> + </li> + <li class="none"> + <a href="http://wiki.apache.org/portals/applications"; class="externalLink" title="Project Wiki">Project Wiki</a> + </li> + <li class="none"> + <a href="mail-lists.html" title="Mailing List">Mailing List</a> + </li> + <li class="none"> + <a href="issue-tracking.html" title="Issue Tracking">Issue Tracking</a> + </li> + </ul> + <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> + <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /> + </a> + + + </div> + </div> + <div id="bodyColumn"> + <div id="contentBox"> + <!-- Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. --> + + <div class="section"> +<h2>Apache License, version 2.0<a name="Apache_License_version_2.0"></a></h2> + +<div> +<pre> +Apache License +Version 2.0, January 2004 +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + +"License" shall mean the terms and conditions for use, reproduction, +and distribution as defined by Sections 1 through 9 of this document. + +"Licensor" shall mean the copyright owner or entity authorized by +the copyright owner that is granting the License. + +"Legal Entity" shall mean the union of the acting entity and all +other entities that control, are controlled by, or are under common +control with that entity. For the purposes of this definition, +"control" means (i) the power, direct or indirect, to cause the +direction or management of such entity, whether by contract or +otherwise, or (ii) ownership of fifty percent (50%) or more of the +outstanding shares, or (iii) beneficial ownership of such entity. + +"You" (or "Your") shall mean an individual or Legal Entity +exercising permissions granted by this License. + +"Source" form shall mean the preferred form for making modifications, +including but not limited to software source code, documentation +source, and configuration files. + +"Object" form shall mean any form resulting from mechanical +transformation or translation of a Source form, including but +not limited to compiled object code, generated documentation, +and conversions to other media types. + +"Work" shall mean the work of authorship, whether in Source or +Object form, made available under the License, as indicated by a +copyright notice that is included in or attached to the work +(an example is provided in the Appendix below). + +"Derivative Works" shall mean any work, whether in Source or Object +form, that is based on (or derived from) the Work and for which the +editorial revisions, annotations, elaborations, or other modifications +represent, as a whole, an original work of authorship. For the purposes +of this License, Derivative Works shall not include works that remain +separable from, or merely link (or bind by name) to the interfaces of, +the Work and Derivative Works thereof. + +"Contribution" shall mean any work of authorship, including +the original version of the Work and any modifications or additions +to that Work or Derivative Works thereof, that is intentionally +submitted to Licensor for inclusion in the Work by the copyright owner +or by an individual or Legal Entity authorized to submit on behalf of +the copyright owner. For the purposes of this definition, "submitted" +means any form of electronic, verbal, or written communication sent +to the Licensor or its representatives, including but not limited to +communication on electronic mailing lists, source code control systems, +and issue tracking systems that are managed by, or on behalf of, the +Licensor for the purpose of discussing and improving the Work, but +excluding communication that is conspicuously marked or otherwise +designated in writing by the copyright owner as "Not a Contribution." + +"Contributor" shall mean Licensor and any individual or Legal Entity +on behalf of whom a Contribution has been received by Licensor and +subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of +this License, each Contributor hereby grants to You a perpetual, +worldwide, non-exclusive, no-charge, royalty-free, irrevocable +copyright license to reproduce, prepare Derivative Works of, +publicly display, publicly perform, sublicense, and distribute the +Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of +this License, each Contributor hereby grants to You a perpetual, +worldwide, non-exclusive, no-charge, royalty-free, irrevocable +(except as stated in this section) patent license to make, have made, +use, offer to sell, sell, import, and otherwise transfer the Work, +where such license applies only to those patent claims licensable +by such Contributor that are necessarily infringed by their +Contribution(s) alone or by combination of their Contribution(s) +with the Work to which such Contribution(s) was submitted. If You +institute patent litigation against any entity (including a +cross-claim or counterclaim in a lawsuit) alleging that the Work +or a Contribution incorporated within the Work constitutes direct +or contributory patent infringement, then any patent licenses +granted to You under this License for that Work shall terminate +as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the +Work or Derivative Works thereof in any medium, with or without +modifications, and in Source or Object form, provided that You +meet the following conditions: + +(a) You must give any other recipients of the Work or +Derivative Works a copy of this License; and + +(b) You must cause any modified files to carry prominent notices +stating that You changed the files; and + +(c) You must retain, in the Source form of any Derivative Works +that You distribute, all copyright, patent, trademark, and +attribution notices from the Source form of the Work, +excluding those notices that do not pertain to any part of +the Derivative Works; and + +(d) If the Work includes a "NOTICE" text file as part of its +distribution, then any Derivative Works that You distribute must +include a readable copy of the attribution notices contained +within such NOTICE file, excluding those notices that do not +pertain to any part of the Derivative Works, in at least one +of the following places: within a NOTICE text file distributed +as part of the Derivative Works; within the Source form or +documentation, if provided along with the Derivative Works; or, +within a display generated by the Derivative Works, if and +wherever such third-party notices normally appear. The contents +of the NOTICE file are for informational purposes only and +do not modify the License. You may add Your own attribution +notices within Derivative Works that You distribute, alongside +or as an addendum to the NOTICE text from the Work, provided +that such additional attribution notices cannot be construed +as modifying the License. + +You may add Your own copyright statement to Your modifications and +may provide additional or different license terms and conditions +for use, reproduction, or distribution of Your modifications, or +for any such Derivative Works as a whole, provided Your use, +reproduction, and distribution of the Work otherwise complies with +the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, +any Contribution intentionally submitted for inclusion in the Work +by You to the Licensor shall be under the terms and conditions of +this License, without any additional terms or conditions. +Notwithstanding the above, nothing herein shall supersede or modify +the terms of any separate license agreement you may have executed +with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade +names, trademarks, service marks, or product names of the Licensor, +except as required for reasonable and customary use in describing the +origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or +agreed to in writing, Licensor provides the Work (and each +Contributor provides its Contributions) on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or +implied, including, without limitation, any warranties or conditions +of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A +PARTICULAR PURPOSE. You are solely responsible for determining the +appropriateness of using or redistributing the Work and assume any +risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, +whether in tort (including negligence), contract, or otherwise, +unless required by applicable law (such as deliberate and grossly +negligent acts) or agreed to in writing, shall any Contributor be +liable to You for damages, including any direct, indirect, special, +incidental, or consequential damages of any character arising as a +result of this License or out of the use or inability to use the +Work (including but not limited to damages for loss of goodwill, +work stoppage, computer failure or malfunction, or any and all +other commercial damages or losses), even if such Contributor +has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing +the Work or Derivative Works thereof, You may choose to offer, +and charge a fee for, acceptance of support, warranty, indemnity, +or other liability obligations and/or rights consistent with this +License. However, in accepting such obligations, You may act only +on Your own behalf and on Your sole responsibility, not on behalf +of any other Contributor, and only if You agree to indemnify, +defend, and hold each Contributor harmless for any liability +incurred by, or claims asserted against, such Contributor by reason +of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work. + +To apply the Apache License to your work, attach the following +boilerplate notice, with the fields enclosed by brackets "[]" +replaced with your own identifying information. (Don't include +the brackets!) The text should be enclosed in the appropriate +comment syntax for the file format. We also recommend that a +file or class name and description of purpose be included on the +same "printed page" as the copyright notice for easier +identification within third-party archives. + +Copyright 2004 The Apache Software Foundation + </pre></div> + </div> + + + </div> + </div> + <div class="clear"> + <hr/> + </div> + <div id="footer"> + <div class="xright"> + Copyright © 2004-2022 + <a href="http://www.apache.org/";>Apache Software Foundation</a>. + All Rights Reserved. + + </div> + <div class="clear"> + <hr/> + </div> + </div> + </body> +</html> Modified: portals/site-live/applications/logging/index.html URL: http://svn.apache.org/viewvc/portals/site-live/applications/logging/index.html?rev=1901430&r1=1901429&r2=1901430&view=diff ============================================================================== --- portals/site-live/applications/logging/index.html (original) +++ portals/site-live/applications/logging/index.html Tue May 31 02:23:06 2022 @@ -1,357 +1,327 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> - - - - - - - - - - - -<html xmlns="http://www.w3.org/1999/xhtml";> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Apache Portals Applications - Apache Portals Applications Logging</title> - <style type="text/css" media="all"> - @import url("../css/maven-base.css"); - @import url("../css/maven-theme.css"); - @import url("../css/site.css"); - </style> - <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - </head> - <body class="composite"> - <div id="banner"> - <a href="http://portals.apache.org/"; id="bannerLeft"> - - <img src="../images/apache-portals.gif" alt="" /> - - </a> - <a href="http://portals.apache.org/applications/"; id="bannerRight"> - - Apache Portals Applications - - </a> - <div class="clear"> - <hr/> - </div> - </div> - <div id="breadcrumbs"> - - - - - - - - - <div class="xleft"> - Last Published: 4 March 2015 - </div> - <div class="xright"> <a href="http://portals.apache.org/"; class="externalLink">Portals</a> - | - <a href="http://portals.apache.org/jetspeed-2"; class="externalLink">Jetspeed-2</a> - | - <a href="http://portals.apache.org/bridges"; class="externalLink">Bridges</a> - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - <div id="leftColumn"> - <div id="navcolumn"> - - - - - - +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> +<!-- Generated by Apache Maven Doxia Site Renderer 1.4 at 26 May 2022 --> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <title>Apache Portals Applications - + Apache Portals Applications Logging</title> + <style type="text/css" media="all"> + @import url("../css/maven-base.css"); + @import url("../css/maven-theme.css"); + @import url("../css/site.css"); + </style> + <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> + <meta name="Date-Revision-yyyymmdd" content="20220526" /> + <meta http-equiv="Content-Language" content="en" /> + + </head> + <body class="composite"> + <div id="banner"> + <a href="http://portals.apache.org/"; id="bannerLeft"> + <img src="../images/apache-portals.gif" alt="Apache Software Foundation" /> + </a> + <a href="http://portals.apache.org/applications/"; id="bannerRight"> + Apache Portals Applications + </a> + <div class="clear"> + <hr/> + </div> + </div> + <div id="breadcrumbs"> + + + <div class="xleft"> + <span id="publishDate">Last Published: 26 May 2022</span> + | <span id="projectVersion">Version: 1.0</span> + </div> + <div class="xright"> <a href="http://portals.apache.org/"; class="externalLink" target="_nw" title="Portals">Portals</a> + | + <a href="http://portals.apache.org/jetspeed-2"; class="externalLink" target="_nw" title="Jetspeed-2">Jetspeed-2</a> + | + <a href="http://portals.apache.org/bridges"; class="externalLink" target="_nw" title="Bridges">Bridges</a> + + + </div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="leftColumn"> + <div id="navcolumn"> + + + <h5>Essentials</h5> + <ul> + <li class="none"> + <a href="../index.html" title="Welcome">Welcome</a> + </li> + <li class="none"> + <a href="../news.html" title="News and Status">News and Status</a> + </li> + <li class="none"> + <a href="../download.html" title="Download">Download</a> + </li> + <li class="none"> + <a href="../getting-started.html" title="Getting Started">Getting Started</a> + </li> + </ul> + <h5>Subprojects</h5> + <ul> + <li class="none"> + <a href=".././portals-gems/index.html" title="Gems">Gems</a> + </li> + <li class="none"> + <a href=".././demo/index.html" title="Demo">Demo</a> + </li> + <li class="none"> + <a href=".././rss-main/index.html" title="RSS">RSS</a> + </li> + <li class="expanded"> + <a href=".././webcontent2/index.html" title="WebContent-2">WebContent-2</a> + <ul> + <li class="none"> + <a href=".././webcontent2/modules-overview.html" title="Modules Overview">Modules Overview</a> + </li> + <li class="none"> + <a href=".././webcontent2/content-rewriter-module.html" title="Content Rewriter Module">Content Rewriter Module</a> + </li> + <li class="none"> + <a href=".././webcontent2/reverse-proxy-module.html" title="Reverse Proxy Module">Reverse Proxy Module</a> + </li> + <li class="none"> + <a href=".././webcontent2/portlets-module.html" title="Portlets Module">Portlets Module</a> + </li> + <li class="none"> + <a href=".././webcontent2/war-module.html" title="WAR Module">WAR Module</a> + </li> + <li class="none"> + <a href=".././webcontent2/build-from-source.html" title="Build from source">Build from source</a> + </li> + <li class="none"> + <a href=".././webcontent2/apidocs/index.html" title="JavaDocs">JavaDocs</a> + </li> + <li class="none"> + <a href=".././webcontent2/faq.html" title="FAQ">FAQ</a> + </li> + </ul> + </li> + <li class="none"> + <a href=".././webcontent/index.html" title="WebContent-1">WebContent-1</a> + </li> + <li class="none"> + <a href=".././dbbrowser/index.html" title="DB Browser">DB Browser</a> + </li> + <li class="none"> + <a href=".././logging/index.html" title="Logging">Logging</a> + </li> + </ul> + <h5>Support</h5> + <ul> + <li class="none"> + <a href="../team-list.html" title="Project Team">Project Team</a> + </li> + <li class="none"> + <a href="../license.html" title="Project License">Project License</a> + </li> + <li class="none"> + <a href="http://wiki.apache.org/portals/applications"; class="externalLink" title="Project Wiki">Project Wiki</a> + </li> + <li class="none"> + <a href="../mail-lists.html" title="Mailing List">Mailing List</a> + </li> + <li class="none"> + <a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a> + </li> + </ul> + <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> + <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /> + </a> + + + </div> + </div> + <div id="bodyColumn"> + <div id="contentBox"> + <!-- Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. --> - - <h5>Essentials</h5> - <ul> - - <li class="none"> - <a href="../index.html">Welcome</a> - </li> - - <li class="none"> - <a href="../news.html">News and Status</a> - </li> - - <li class="none"> - <a href="../download.html">Download</a> - </li> - - <li class="none"> - <a href="../getting-started.html">Getting Started</a> - </li> - </ul> - <h5>Subprojects</h5> - <ul> - - <li class="none"> - <a href=".././portals-gems/index.html">Gems</a> - </li> - - <li class="none"> - <a href=".././demo/index.html">Demo</a> - </li> - - <li class="none"> - <a href=".././rss-main/index.html">RSS</a> - </li> - - - + <div class="section"> +<h2>Welcome to Apache Portals Applications Logging<a name="Welcome_to_Apache_Portals_Applications_Logging"></a></h2> - +<div id="downloadbox"> + +<div class="section"> +<div class="section"> +<div class="section"> +<h5>Get Portals Applications<a name="Get_Portals_Applications"></a></h5> + +<p> + <a href="../download.html"><img src="images/folder-open.gif" border="0" alt="" title="download" />Download</a> + Portals Applications Logging 1.0 + </p> + +<ul> + +<li> + <a href="../getting-started.html">System Requirements</a> + </li> + </ul> + </div> - +<p> + Apache Portals Applications Logging, (APA Logging), is a utility library used to setup and deploy logging + configuration properties for portlet and portal web applications. APA Logging is currently used by all APA + web applications and the Jetspeed 2 portal to initialize the internal Log4j logging implementations. This + approach is independent of APA and Jetspeed 2 and can be used stand alone in any application container. The + following containers are supported: + </p> +<ul> + +<li>Tomcat 5.5</li> + +<li>Tomcat 6</li> + </ul> + The community is encouraged to contribute utilities to support other platforms. - + </div></div></div> +<div class="section"> +<h3>Overview<a name="Overview"></a></h3> + +<p> + APA Logging utilities manage and provide a system property, <tt>org.apache.portals.logdir</tt>, that + can be used by deployed web applications to collocate logs in a centralized location external to the + web application itself. The utilities include an application web container listener to set the property + globally before web applications are started and tools to automate the configuration of this listener. + </p> + </div> +<div class="section"> +<h3>Log4j Web Application Configuration<a name="Log4j_Web_Application_Configuration"></a></h3> + +<p> + Any logging solution can be used with APA Logging that can be configured using the + <tt>org.apache.portals.logdir</tt> system property. Log4j is used internally by most of the APA portlet + applications and Jetspeed 2. Here is and example Log4j configuration, (<tt>log4j.properties</tt>), + that leverages these utilities: + </p> +<div class="source"> +<pre> +# root logger +log4j.rootLogger = ERROR, pa + +# portlet application category +log4j.category.org.apache.portals = INFO, pa +log4j.additivity.org.apache.portals = false + +# portlet application APA Logging log file +log4j.appender.pa = org.apache.log4j.FileAppender +log4j.appender.pa.file = ${org.apache.portals.logdir}/my-pa.log +log4j.appender.pa.layout = org.apache.log4j.PatternLayout +log4j.appender.pa.layout.conversionPattern = %d [%t] %-5p %c - %m%n +log4j.appender.pa.append = false + </pre></div> + To prevent potential log file overwriting and/or truncation, only one portlet web application should + write to an individual file. By convention, web applications should prefix log file names with their + deployed context name. + + </div> +<div class="section"> +<h3>Manual Configuration<a name="Manual_Configuration"></a></h3> + +<p> + Since the APA Logging approach depends only on a global system property, manual configuration that does + not utilize these utilities is possible in most web application container environments. For Tomcat, one + can specify system properties on the command line or in the <tt>CATALINA_OPTS</tt> environment + variable using the standard JVM syntax: + </p> +<div class="source"> +<pre> +-Dorg.apache.portals.logdir=/var/log/portal + </pre></div> + + </div> +<div class="section"> +<h3>Tomcat Listener<a name="Tomcat_Listener"></a></h3> + +<p> + The Tomcat listener implementation, <tt>LoggingPropertiesServerListener</tt>, uses the + <tt>catalina.base</tt> or <tt>catalina.home</tt> system properties to locate the Tomcat logs + directory by default. The listener can also be instantiated with the <tt>logdir</tt> attribute to + specify the APA Logging property value. To use the default Tomcat logs directory, the following tag + must be inserted in the <tt>Server</tt>, <tt>Service</tt>, or <tt>Engine</tt> + configurations in the Tomcat <tt>server.xml</tt> file: + </p> +<div class="source"> +<pre> - +<Listener className="org.apache.portals.applications.logging.tomcat.LoggingPropertiesServerListener"/> + </pre></div> + To specify an APA Logging directory, the following can also be used: + +<div class="source"> +<pre> +<Listener className="org.apache.portals.applications.logging.tomcat.LoggingPropertiesServerListener" logdir="/var/log/portal"/> + </pre></div> + The listener only configures the property if not already set, so manual configuration of the logging + system property will override computed or specified by the listener. The APA Logging jar artifact must + be installed in the Tomcat system library classpath, (i.e. in <tt>server/lib</tt> for Tomcat 5.5 and + <tt>lib</tt> for Tomcat 6), since the listener is invoked by Tomcat itself. + + </div> - - <li class="expanded"> - <a href=".././webcontent2/index.html">WebContent-2</a> - <ul> - - <li class="none"> - <a href=".././webcontent2/modules-overview.html">Modules Overview</a> - </li> - - <li class="none"> - <a href=".././webcontent2/content-rewriter-module.html">Content Rewriter Module</a> - </li> - - <li class="none"> - <a href=".././webcontent2/reverse-proxy-module.html">Reverse Proxy Module</a> - </li> - - <li class="none"> - <a href=".././webcontent2/portlets-module.html">Portlets Module</a> - </li> - - <li class="none"> - <a href=".././webcontent2/war-module.html">WAR Module</a> - </li> - - <li class="none"> - <a href=".././webcontent2/build-from-source.html">Build from source</a> - </li> - - <li class="none"> - <a href=".././webcontent2/apidocs/index.html">JavaDocs</a> - </li> - - <li class="none"> - <a href=".././webcontent2/faq.html">FAQ</a> - </li> - </ul> - </li> - - <li class="none"> - <a href=".././webcontent/index.html">WebContent-1</a> - </li> - - <li class="none"> - <a href=".././dbbrowser/index.html">DB Browser</a> - </li> - - <li class="none"> - <a href=".././logging/index.html">Logging</a> - </li> - </ul> - <h5>Support</h5> - <ul> - - <li class="none"> - <a href="../team-list.html">Project Team</a> - </li> - - <li class="none"> - <a href="../license.html">Project License</a> - </li> - - <li class="none"> - <a href="http://wiki.apache.org/portals/applications"; class="externalLink">Project Wiki</a> - </li> - - <li class="none"> - <a href="../mail-lists.html">Mailing List</a> - </li> - - <li class="none"> - <a href="../issue-tracking.html">Issue Tracking</a> - </li> - </ul> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img> - </a> - - - - - - - - - </div> - </div> - <div id="bodyColumn"> - <div id="contentBox"> - <subtitle></subtitle><authors><person name="Randy Watler" email="rwat...@apache.org"></authors><div class="section"><h2><a name="Welcome_to_Apache_Portals_Applications_Logging"></a>Welcome to Apache Portals Applications Logging</h2> -<div id="downloadbox"><h5>Get Portals Applications</h5> -<p><a href="../download.html"><img src="images/folder-open.gif" alt="" />Download</a> - Portals Applications Logging 1.0 - </p> -<ul><li><a href="../getting-started.html">System Requirements</a></li> -</ul> -</div><p> - Apache Portals Applications Logging, (APA Logging), is a utility library used to setup and deploy logging - configuration properties for portlet and portal web applications. APA Logging is currently used by all APA - web applications and the Jetspeed 2 portal to initialize the internal Log4j logging implementations. This - approach is independent of APA and Jetspeed 2 and can be used stand alone in any application container. The - following containers are supported: - <ul><li>Tomcat 5.5</li> -<li>Tomcat 6</li> -</ul> - - The community is encouraged to contribute utilities to support other platforms. - </p> -<div class="section"><h3><a name="Overview"></a>Overview</h3> -<p> - APA Logging utilities manage and provide a system property, <code>org.apache.portals.logdir</code>, that - can be used by deployed web applications to collocate logs in a centralized location external to the - web application itself. The utilities include an application web container listener to set the property - globally before web applications are started and tools to automate the configuration of this listener. - </p> -</div> -<div class="section"><h3><a name="Log4j_Web_Application_Configuration"></a>Log4j Web Application Configuration</h3> -<p> - Any logging solution can be used with APA Logging that can be configured using the - <code>org.apache.portals.logdir</code> system property. Log4j is used internally by most of the APA portlet - applications and Jetspeed 2. Here is and example Log4j configuration, (<code>log4j.properties</code>), - that leverages these utilities: - <div class="source"><pre> - -# root logger -log4j.rootLogger = ERROR, pa - -# portlet application category -log4j.category.org.apache.portals = INFO, pa -log4j.additivity.org.apache.portals = false - -# portlet application APA Logging log file -log4j.appender.pa = org.apache.log4j.FileAppender -log4j.appender.pa.file = ${org.apache.portals.logdir}/my-pa.log -log4j.appender.pa.layout = org.apache.log4j.PatternLayout -log4j.appender.pa.layout.conversionPattern = %d [%t] %-5p %c - %m%n -log4j.appender.pa.append = false - </pre> -</div> - - To prevent potential log file overwriting and/or truncation, only one portlet web application should - write to an individual file. By convention, web applications should prefix log file names with their - deployed context name. - </p> -</div> -<div class="section"><h3><a name="Manual_Configuration"></a>Manual Configuration</h3> -<p> - Since the APA Logging approach depends only on a global system property, manual configuration that does - not utilize these utilities is possible in most web application container environments. For Tomcat, one - can specify system properties on the command line or in the <code>CATALINA_OPTS</code> environment - variable using the standard JVM syntax: - <div class="source"><pre> - --Dorg.apache.portals.logdir=/var/log/portal - </pre> -</div> -</p> -</div> -<div class="section"><h3><a name="Tomcat_Listener"></a>Tomcat Listener</h3> -<p> - The Tomcat listener implementation, <code>LoggingPropertiesServerListener</code>, uses the - <code>catalina.base</code> or <code>catalina.home</code> system properties to locate the Tomcat logs - directory by default. The listener can also be instantiated with the <code>logdir</code> attribute to - specify the APA Logging property value. To use the default Tomcat logs directory, the following tag - must be inserted in the <code>Server</code>, <code>Service</code>, or <code>Engine</code> - configurations in the Tomcat <code>server.xml</code> file: - <div class="source"><pre> - -<Listener className="org.apache.portals.applications.logging.tomcat.LoggingPropertiesServerListener"/> - </pre> -</div> - - To specify an APA Logging directory, the following can also be used: - <div class="source"><pre> - -<Listener className="org.apache.portals.applications.logging.tomcat.LoggingPropertiesServerListener" logdir="/var/log/portal"/> - </pre> -</div> - - The listener only configures the property if not already set, so manual configuration of the logging - system property will override computed or specified by the listener. The APA Logging jar artifact must - be installed in the Tomcat system library classpath, (i.e. in <code>server/lib</code> for Tomcat 5.5 and - <code>lib</code> for Tomcat 6), since the listener is invoked by Tomcat itself. - </p> -</div> -<div class="section"><h3><a name="Tomcat_Deployment"></a>Tomcat Deployment</h3> -<p> - The Tomcat deployment tool, <code>ServerXMLConfigurer</code>, deploys the default APA Logging - <code>Listener</code> tag into the <code>server.xml</code> file. The tool is used as part of the - Jetspeed 2 deployment Maven2 plugin, (<code>jetspeed-deploy-maven-plugin</code>), to provide a self - configuring development and demo environment. As noted above, this results in all APA Logging compatible - log files being located in the standard Tomcat installation logs directory. - </p> -<p> - The deployment tool checks to ensure the listener has not already been installed and/or configured - before running. The <code>Listener</code> tag is inserted within the <code>Engine</code> tag. - Tomcat installation configurations with multiple <code>Engine</code> tags should be configured - manually to ensure proper operation. - </p> -</div> -</div> - +<div class="section"> +<h3>Tomcat Deployment<a name="Tomcat_Deployment"></a></h3> + +<p> + The Tomcat deployment tool, <tt>ServerXMLConfigurer</tt>, deploys the default APA Logging + <tt>Listener</tt> tag into the <tt>server.xml</tt> file. The tool is used as part of the + Jetspeed 2 deployment Maven2 plugin, (<tt>jetspeed-deploy-maven-plugin</tt>), to provide a self + configuring development and demo environment. As noted above, this results in all APA Logging compatible + log files being located in the standard Tomcat installation logs directory. + </p> + +<p> + The deployment tool checks to ensure the listener has not already been installed and/or configured + before running. The <tt>Listener</tt> tag is inserted within the <tt>Engine</tt> tag. + Tomcat installation configurations with multiple <tt>Engine</tt> tags should be configured + manually to ensure proper operation. + </p> </div> </div> - <div class="clear"> - <hr/> - </div> - <div id="footer"> - <div class="xright">© - 2004-2015 - - Apache Software Foundation - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - </body> -</html> + + </div> + </div> + <div class="clear"> + <hr/> + </div> + <div id="footer"> + <div class="xright"> + Copyright © 2004-2022 + <a href="http://www.apache.org/";>Apache Software Foundation</a>. + All Rights Reserved. + + </div> + <div class="clear"> + <hr/> + </div> + </div> + </body> +</html>
