summaryrefslogtreecommitdiffstats
path: root/onap/portal/README.md
blob: 7d473d292694b484397841c8178b3811b4214de9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
##############################################################################################################################################
## Portal Logging Configuration
=================================================================================================
Portal has two docker containers- portal and mariadb.
The canonical logging implementation is only done for the container, portal.
Portal has two sub-modules portal-be and portal-db each one has its own separate logback.xml file.
Canonical logs will be generated at /var/log/onap/portal/
=================================================================================================
## Instructions for deployment
=================================================================================================
### Portal logging deployment for sub-module portal-be
-------------------------------------------------------------------------------------------------
  1. Log provider file is available at the path, /opt/apache-tomcat-8.0.37/webapps/ECOMPPORTAL/WEB-INF/classes, in the container.
  2. Copy the canonical logback.xml from 'portal-be' directory (of gerrit) into the path mentioned in step 1.
  3. Create the canonical path for logs, /var/log/onap/portal/portal-be on the host VM.
  4. Provide write permissions for "others" users for directory created in step 3.
  5. Volume-Mount: The portal container requires one host path mapped as volume in the container
        
      5.1. Log file path:
        Host path -      /var/log/onap/portal/portal-be/ mapped to 
        Container path - /var/log/onap/portal/portal-be/      
      5.2. Log provider file path:              
        Note: Log provider path cannot be configured externally as it is bundled inside a WAR.  
---------------------------------------------------------------------------------------------------------------------------------------------
### Portal logging deployment for sub-module portal-db
-------------------------------------------------------------------------------------------------
  1. Log provider file is available at the path, /opt/apache-tomcat-8.0.37/webapps/ECOMPDBCAPP/WEB-INF/classes, in the container.
  2. Copy the canonical logback.xml from 'portal-db' directory (of gerrit) into the path mentioned in step 1.
  3. Create the canonical path for logs, /var/log/onap/portal/portal-db on the host VM.
  4. Provide write permissions for "others" users for directory created in step 3.
  5. Volume-Mount: The portal container requires one host path mapped as volume in the container
        
      5.1. Log file path:
        Host path -      /var/log/onap/portal/portal-db/ mapped to 
        Container path - /var/log/onap/portal/portal-db/
        This is done so that the log files are also visible in the VM and then to the filebeat.
      5.2. Log provider file path:              
        Note: Log provider path cannot be configured externally as it is bundled inside a WAR.
##############################################################################################################################################