sdnr/wireless-transport/code-Carbon-SR1/docs/READMEOperateAndDebugODL.md

   1 ## Operate and debug ODL for testing
   2
   3 ### Debug ODL
   4
   5 #### Activate or deactivate log point
   6
   7 Getting Log info about a specific service:
   8
   9     log:set DEBUG com.highstreet.technologies
  10
  11 Getting all NETCONF/YANG traffic (Hint: huge amount of data, only for test purpose):
  12
  13     log:set TRACE org.opendaylight.netconf
  14
  15 For switching off logging set level to INFO to see the log point
  16
  17     log:set INFO org.opendaylight.netconf
  18
  19 For deleting the log point for a package
  20
  21     log:set DEFAULT org.opendaylight.netconf
  22
  23 Configuration of logging is done here:
  24
  25     vi $ODL_KARAF_HOME/etc/org.ops4j.pax.logging.cfg
  26
  27 #### View the log
  28
  29 A good option is to cd into the log directory and use grep and vi to view into the logs.
  30
  31     cd $ODL_KARAF_HOME/bin/data/log
  32
  33 A second option is within the karaf command line to use the command *log:display* in combination with grep.
  34
  35     log:display | grep
  36
  37
  38 ### Operate ODL
  39
  40 #### In shell or background
  41
  42 There are two way to start and run ODL. The command are available in the $ODL_KARAF_HOME/bin directory.
  43
  44   1. In the karaf shell
  45    - Using *./bin/karaf* command to run ODL in a shell.
  46    - In this way of operation ODL is running if the shell is running.
  47    - If you leave the shell by shutdown or logout command ODL is stopped.
  48
  49   2. In the background
  50    - Use command *./bin/start*, *./bin/stop* to run and stop ODL.
  51    - Attaching to the command line with *client*
  52    - In this way of operation ODL is running in the background.
  53
  54 #### Check if ODL is running
  55
  56 A good way to check if ODL is running is to use the command
  57
  58     ps -ef | grep karaf
  59
  60 The feedback of *status* is not always true during startup or shutdown.
  61 In some cases ODL run two times in a JVM what needs to be avoided.
  62
  63