Logging Foundation

Purpose: This document is to explain,

Table of Contents


*** this document requires further update ***

Logging Matrix

Goal: This bulletin document is a central repository of all possible logging in EnterpriseOne

  • Reference:
  • JD Edwards EnterpriseOne Logging Matrix: Activating, Creating and Retrieving the Correct Logs (Doc ID 1332681.1)


    How to turn on logging in WebDev client

    Goal

  • Through this demonstration, you are familiar with components of single objects
  • Understand the parameters in JDE.INI and JAS.INI
  • Understand Environment which is made up of Path code and OCM mapping
  • Parameters which is related to logging
  • JDE.ini

    [DEBUG]

    Output=FILE

    LEVEL=BSFN,EVENTS

    DebugFile=c:\logs\jdedebug.log

    JobFile=c:\logs\jde.log

    OWDEVELOPER=TRUE

    [UBE]

    UBEDebugLevel=6

    UBESaveLogFile=1

  • Output: (default) NONE
  • LEVEL: this determines the level of detail. This definition is important to understand how an object is made up of or we define it in EnterpriseOne
  • In the IT industry, an object is made up of C functions and specification. So BSFN represents all C Components in E1 and EVENTS represents specification (which can be called in many different names depending on its location and usage). Refer to E1: ENV: Overview of Specifications (SPEC) in EnterpriseOne (Doc ID 1)
  • DebugFile and JobFile determines where to store the output
  • UBEDebugLevel is determined the level of detail of the batch job. Set this value 6 unless different settings are a requirement by development
  • UBESaveLogFile 1 for TRUE
  •  

    JAS.INI

    a.    Jdedebug.properies (at C:\E910\system\OC4J\j2ee\home\applications\webclient.ear\webclient\WEB-INF)

    #          In H4Apps environment we should have atleast one log turned on

    #          to make sure all logs above warn should get into the

    #                                                                                                         

    #          FILE  = <Set the location of the logfile to output the logs>

    #          LEVEL = <Should be either SEVERE or WARN or APP or DEBUG>

    #                          <Log levels priority is SEVERE > WARN > APP > DEBUG >

    #                          <Default setting in H4Apps is APP>                            

    #          FORMAT= <In Production format should be APPS>         

    #                      <Formats> APPS, TOOLS, TOOLS_THREAD

    #          MAXFILESIZE = <The maximum file size of the log file>

    #          MAXBACKUPINDEX = <Maximum number of backups that need to be maintained>

    #          COMPONENTS= <The components that needs to be logged in the file>

    #                                  <H4A setting should be RUNTIME|JAS|JDBJ>

    #                                                                                 

    #          COMPONENTS:                                                            

    #                                                                                                         

    #          ALL|LIB|NET|KERNEL|JDBC|RUNTIME|SAW|JAS|JASBASE|XML|OWHTML|OWPORTAL|REDIRECTOR|     

    #          INTEROP|SERVICES|THREADPOOL|TE|BPM|AUTOPILOT|SUPPORTASSISTANT|MAF|PERFMON|JDBJ|

    #       METADATA|PSFT|BASE|APPLOGIC|BIZLOGIC|CODEGEN|E1MENU|EVENTPROCESSOR|JAVATOKEN|

    #       OET|PIMSYNC|PPM|TEXTSEARCH|WEBGUI

     

    #The section name should be E1LOG. This logs all the log messages above WARN

    [E1LOG]

    FILE=\\jderoot.log

    LEVEL=WARN

    FORMAT=APPS

    MAXFILESIZE=10MB

    MAXBACKUPINDEX=20

    COMPONENT=ALL

    APPEND=TRUE

     

    #Logging runtime and JAS above APP level will be helpful for application developers.

    #Application developers should use this log as a substitute to analyze the flow of events

    #in the webclient.

    [LOG1]

    FILE=\\jas.log

    LEVEL=APP

    FORMAT=APPS

    MAXFILESIZE=10MB

    MAXBACKUPINDEX=20

    COMPONENT=RUNTIME|JAS|JDBJ

    APPEND=TRUE

     

     

  • INI (located at C:\E910\system\OC4J\j2ee\home\applications\webclient.ear\webclient\WEB-INF\classes)
  • Output: C:\E910\system\OC4J\j2ee\home\log
  •  

  • Environment = Path Code + OCM mapping
  • Environment

    : Above OCM defined where to save the output file

     


    How to find user resource?

     

    - E1 Release: 8.12, 9.0, 9.1 and 9.2
    - Tools Release: 8.97.1.0 and above

                - Note that below is a link to run JDE

     

    Environment

    Instances

    Find the JAS instance, the instance name is OAS8129710 for this demo.

    Naming convention is like (OAS + E1 Release + E1 Tools Release) for OAS, such as:

        OAS8129710 = OAS+8.12+8.97.1.0

     


    9.1.4.0 and above

  • Log on to Server Manager using apptech/8pptech
  • Click User Activity
  • User Activity

  • Enter JDE Logging USER ID and press Search
  • Instance Detail

    Instance Detail

    à Which shows both JAS resource and logic server (Enterprise Server) resources

    à HTML instance name to activate logging for JASDebug

    à Click Pricess ID hyperlink to turn on jdedebug.log for specific process/Kernel ID

     


    How to turn on jasdebug.log

    Click “jdelog.properties Logging” from Configuration tab after entering the selected instance.

    JASDEBUG

     The screenshot for server manager 9.1.4.0 and above,

    Log File Configuration

    It shows “Log File Configuration”.

    e1root

    Note that there is e1root.log (formerly jderoot.log), such as

    - Z:\JDE_HOME812\targets\OAS81289710\logs\e1root.log

    e1root

    To configure and enable user-specific jasdebug.log:

    Modify properties

    à Click on “Create New User Specific Log Configuration” (Push button).

     

       Log Level = “Application Level Activity”

    Log Level

    E1 User Name

    Append -False

     

    How to view the captured user-specific jasdebug log

     

    - Go to Instance you are working on (for example, OAS8129710)

    Example of dumped log

    - Find that user-specific jasdebug.log is being captured with user configured log file.

    - Click on the log file to view.

    Download

    - Clieck “Download Entire Log File” to retrieve and save the full log file.

     

     

     

    To turn off user-specific jas logging.

    Turn it off

     


    Capturing user related CallObjectKernel on Enterprise Server

    Signed on E1 using your E1 User ID

    Call Object Kernel Log

    Within Server Manager, click “Management Dashboard”

     

    - From pull-down menu from below screen, choose “Search for User Resources”

    User Resources

     

    - Enter your E1 User ID and click Search

    Search User Resources

    (continue..)

     

    Find there are two different logs under your loggin ID:

    Log Files

     

    To view JAS log, click Logs Files under HTML Server Session.

    HTML Server Session

    There is another session for “Enterprise Server Resources”

    Enterprise Server Resources

     

    Process ID: 11940 properties are set as below

    COK Process ID

    (continue..)

    COK Process ID

    COK Process ID

     

    To turn on logging tick (check box) Enable JDEDEBUG.LOG, and click Save.

    Turn On JDEDEBUG

     

    Run E1 application through web client…

     

     

    As it was defined from the specific Process ID (process ID = 11940 for this demo) jdedebug.log will be found as below from the same place as highlighted before.

    Dumped Log

    Click “view” to check/capture jdedebug.log

    View

     

    To save jdedebug.log click “Download Entire Log File”.

    Save

     

    Important!!! At the end of logging, please remember to turn it off.

    Turn it Off

     


    How to turn on logging for UBE/Batch Job

  • Goal
  • Log on to any environment (we are going to submit a job to the server so either J* or non-J* environment the outcome will be the same)
  • UBE log

  • Enter batch application ID and press find button
  • Highlight version you want to submit and click Select
  • Version Selection

  • (Form Exit) Advanced
  • Advanced Option

  • Set UBE Logging Level = 6
  • UBE logging Level

  • Tick Data Selection to set proper data selection
  • Data Selection

  • Set Data Selection
  • Set Data Selection

  • Click OK on the Printer Selection screen
  • Submit

    (to retrieve log captured)

  • On Work with Batch Versions screen, (form exit) Submitted Jobs
  • Retrieve Log

  • Look for the job you have submitted then  (Row Exit) View logs
  • View Log

  •  Tick both Logging and Tracing then click OK to save
  • Save Log

  • Save it
  • Save Log


    How to turn on logging for the batch job which is called by an interactive application

  • Assumption: the issue is happening in Live environment so it is not applicable to modify JDE.INI in server
  • Business scenario: The Print Check did not update status correctly
  • Exercise
  • Modify jde.ini and jas.ini as guided at “C. How to turn on logging in WebDev client”
  • Log on to WebDev client with user ID/Password LOCAL/LOCAL
  • WebDevClient Log

    OCM Mapping

  • Start Local web
  • Start Local HTML Web Server

     

  • Go to the interactive application which calls UBE(s)
  • Run App

    WebDevClient Log

     

  • Verify logs traces by this action (5 different logs are to be generated)
  • Log in Local repository

    UBE log in Local machine

    JASDEBUG log in Local machine

     


    Turn on logging through serveradministrationworkbench.exe

    Goal

  • You are able to configure server activities
  • You are able to capture different types of kernels through conventional SAW
  • Launch serveradministrationworkbench (SAW)
  • SAW

    SAW Alternative

  • Log on using your user ID or JDE/JDE
  • Start SAW

  • Select tab “Query”
  • Click Add
  • SAW Instance

  • Enter machine name of the logic server with port number
  • Server and Port

    Server Name and Port Configuration

    Query Servers

  • Click View users to find user specific Call Object kernel Process ID
  • View Users

  • Click Processes
  • Get Process ID

  • Right mouse button click then click Turn on Server Logging
  • Turn on Server Logging

  • To view logs click View Debug Log and View JDE.log
  •  


    What information is written at logs

    To be added ...

    log:

    this log contains system level error (which are related with tools release. In other words, any component which belongs to the system)

    E1 Structure

    This include ODBC, connection, kernel level error

     

     

  • log: since business functions in E1 must be called through API CallObject () so we call it as Call Object Kernel log. So this file traces all business functions flow. Exception: E1: BSFN: Frequently Asked Questions on Business Functions / Methods Running on JAS (Doc ID 1090584.1)
  • E1root_*.log: this file contains system level error in JAS (java application server) depending on the level you have set from jdedebug.properties file or server manager
  • log: this file traces all specification as we defined in jdedebug.properties file.
  •