You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@archiva.apache.org by oc...@apache.org on 2009/07/27 12:53:56 UTC

svn commit: r798099 - in /archiva/trunk/archiva-docs/src/site: apt/adminguide/archiva-logs.apt apt/adminguide/audit-logs.apt apt/adminguide/logging.apt apt/adminguide/security-logs.apt site.xml

Author: oching
Date: Mon Jul 27 10:53:56 2009
New Revision: 798099

URL: http://svn.apache.org/viewvc?rev=798099&view=rev
Log:
[MRM-1191] Add Archiva log files in documentation
Submitted by: Jevica Arianne B. Zurbano
o identified and defined what each log file is for

additional modifications to the patch:
o reworded description of archiva-audit.log and archiva.log

Added:
    archiva/trunk/archiva-docs/src/site/apt/adminguide/archiva-logs.apt
    archiva/trunk/archiva-docs/src/site/apt/adminguide/logging.apt
    archiva/trunk/archiva-docs/src/site/apt/adminguide/security-logs.apt
Modified:
    archiva/trunk/archiva-docs/src/site/apt/adminguide/audit-logs.apt
    archiva/trunk/archiva-docs/src/site/site.xml

Added: archiva/trunk/archiva-docs/src/site/apt/adminguide/archiva-logs.apt
URL: http://svn.apache.org/viewvc/archiva/trunk/archiva-docs/src/site/apt/adminguide/archiva-logs.apt?rev=798099&view=auto
==============================================================================
--- archiva/trunk/archiva-docs/src/site/apt/adminguide/archiva-logs.apt (added)
+++ archiva/trunk/archiva-docs/src/site/apt/adminguide/archiva-logs.apt Mon Jul 27 10:53:56 2009
@@ -0,0 +1,37 @@
+ ------
+ Archiva Logs
+ ------
+ ------
+ 22 Jul 2009
+ ------
+ 
+Archiva Logs
+
+  Archiva's <<<logs>>> directory contains an archiva log file named <<<archiva.log>>>, which logs all the startup information and the output logs of Archiva.
+
+  A typical record looks like this:
+
+------
+2009-07-13 16:04:52,869 [WrapperSimpleAppMain] INFO  org.apache.maven.archiva.security.ArchivaStandardRolesCheck  -
+  Checking the existance of required roles.
+2009-07-13 16:04:52,869 [WrapperSimpleAppMain] INFO  org.apache.maven.archiva.security.ArchivaStandardRolesCheck  -
+  Checking the existance of required operations.
+2009-07-13 16:04:52,869 [WrapperSimpleAppMain] INFO  org.apache.maven.archiva.web.startup.SecuritySynchronization  -
+  Environment Check: required-roles -> 0 violation(s)
+2009-07-13 16:04:53,371 [WrapperSimpleAppMain] INFO  org.apache.maven.archiva.web.startup.Banner  - _________________________
+                          __________________________________
+               /\_       /                                  \
+              /`/@),    |  On behalf of all of the alpacas   |
+              |  (~'  __| toiling away on the Apache Archiva |
+      _,--.___/  |    \      project team, I would like to   |
+    ,' ,     (   |     \         welcome you to Archiva      |
+    |  (      \  /      |           1.2.1                    |
+     \  )\_/  ,_/       |                                    |
+     / /   ( |/         |     http://archiva.apache.org/     |
+    ( |    ( |          |     users@archiva.apache.org       |
+     \|     \|           \__________________________________/
+
+
+2009-07-13 16:04:55,129 [WrapperSimpleAppMain] INFO  org.codehaus.plexus.redback.struts2.interceptor.SecureActionInterceptor  -
+  org.codehaus.plexus.redback.struts2.interceptor.SecureActionInterceptor initialized!
+------

Modified: archiva/trunk/archiva-docs/src/site/apt/adminguide/audit-logs.apt
URL: http://svn.apache.org/viewvc/archiva/trunk/archiva-docs/src/site/apt/adminguide/audit-logs.apt?rev=798099&r1=798098&r2=798099&view=diff
==============================================================================
--- archiva/trunk/archiva-docs/src/site/apt/adminguide/audit-logs.apt (original)
+++ archiva/trunk/archiva-docs/src/site/apt/adminguide/audit-logs.apt Mon Jul 27 10:53:56 2009
@@ -4,7 +4,7 @@
 
 Audit Logs
 
-  Archiva's log directory contains an audit log file named <<<archiva-audit.log>>>, which tracks events that occur in the server.
+  Archiva's <<<logs>>> directory contains an audit log file named <<<archiva-audit.log>>>, which tracks events that occur in the server.
 
   A typical record looks like this:
 

Added: archiva/trunk/archiva-docs/src/site/apt/adminguide/logging.apt
URL: http://svn.apache.org/viewvc/archiva/trunk/archiva-docs/src/site/apt/adminguide/logging.apt?rev=798099&view=auto
==============================================================================
--- archiva/trunk/archiva-docs/src/site/apt/adminguide/logging.apt (added)
+++ archiva/trunk/archiva-docs/src/site/apt/adminguide/logging.apt Mon Jul 27 10:53:56 2009
@@ -0,0 +1,24 @@
+ ------
+ Log Files
+ ------
+ ------
+ 22 Jul 2009
+ ------
+ 
+Log Files
+
+  To keep track of the Archiva performance and problems, log files are created during runtime.
+  These files can be found in the <<<logs/>>> directory.
+  
+  * {{{archiva-logs.html} <<archiva.log>>}} - contains all the start-up information and output logs for Archiva
+  
+  * {{{audit-logs.html} <<archiva-audit.log>>}} - contains information regarding the operations performed against
+                           the repositories and configurations being modified. A good example is when an artifact
+                           is deployed to an Archiva repository. The operation will be logged in this file,
+                           with the date and timestamp of when the operation occurred, the userId of who performed
+                           the deployment, and the artifact that was deployed.
+  
+  * {{{security-logs.html} <<archiva-security-audit.log>>}} - contains information regarding Archiva's security.
+                            For example, a successful login of a user or a user account is created.
+  
+  []

Added: archiva/trunk/archiva-docs/src/site/apt/adminguide/security-logs.apt
URL: http://svn.apache.org/viewvc/archiva/trunk/archiva-docs/src/site/apt/adminguide/security-logs.apt?rev=798099&view=auto
==============================================================================
--- archiva/trunk/archiva-docs/src/site/apt/adminguide/security-logs.apt (added)
+++ archiva/trunk/archiva-docs/src/site/apt/adminguide/security-logs.apt Mon Jul 27 10:53:56 2009
@@ -0,0 +1,40 @@
+ ------
+ Security Logs
+ ------
+ ------
+ 22 Jul 2009
+ ------
+ 
+Security Logs
+
+  Archiva's <<<logs>>> directory contains a security log file named <<<archiva-security-audit.log>>>,
+  which keeps track of all the security operations such as user creation/deletion, user role assignments, and user log in/out.
+  
+  A typical record looks like this:
+
+------
+2009-07-22 12:03:11 -  - Successful Login for user admin
+2009-07-22 12:05:03 - admin - User Created: archiva
+2009-07-22 12:05:25 - admin - Role Assigned to user archiva: Global Repository Manager
+2009-07-22 12:05:33 - admin - User Modified: archiva
+------
+
+  The hyphen delimited records are:
+
+    * date and time (server local time)
+    
+    * current user performing the operation
+    
+    * the operation performed
+    
+    []
+    
+  Currently, the following events are logged:
+
+    * user creation/modification/deletion
+    
+    * user log in/out
+    
+    * assigning roles to a user
+    
+    []

Modified: archiva/trunk/archiva-docs/src/site/site.xml
URL: http://svn.apache.org/viewvc/archiva/trunk/archiva-docs/src/site/site.xml?rev=798099&r1=798098&r2=798099&view=diff
==============================================================================
--- archiva/trunk/archiva-docs/src/site/site.xml (original)
+++ archiva/trunk/archiva-docs/src/site/site.xml Mon Jul 27 10:53:56 2009
@@ -66,7 +66,11 @@
         <item name="Consumers"               href="/adminguide/consumers.html" />
       </item>
       <item name="Configuration Files"       href="/adminguide/configuration-files.html" />
-      <item name="Audit Logs"                href="/adminguide/audit-logs.html" />
+      <item name="Log Files"                 href="/adminguide/logging.html" >
+        <item name="Archiva Logs"            href="/adminguide/archiva-logs.html" />
+        <item name="Audit Logs"              href="/adminguide/audit-logs.html" />
+        <item name="Security Logs"           href="/adminguide/security-logs.html" />
+      </item>
       <item name="Reports"                   href="/adminguide/reports.html" />
       <item name="Web Services"              href="/adminguide/web-services.html" />
     </menu>