MarkView for SAP Gateway - What diagnostic steps should I follow and what information should I gather when there is an issue with MarkView Gateway?
Summary
5116
Applies To
- ERP System: SAP
- MarkView Versions: All MarkView for SAP versions
Overview
MarkView does not have direct access to SAP backend tables. As such, MarkView uses BAPIs (Business APIs) to expose the ERP data it needs to retrieve from SAP. All communication from MarkView to SAP is handled through our BAPIs which get created in the SAP environment during installation of MarkView. A Java middle tier component, the MarkView Gateway for SAP, facilitates all of the communication between MarkView and SAP.
Troubleshooting Steps
If you encounter an issue with the MarkView Gateway Component, please perform the following steps:
Verify the mvsap-gw is up
- For OAS
Log into Oracle Enterprise Manager and ensure that the "mvsap-gw" component is started in the OC4J Instance. This is designated by the green arrow pointing up in the Status column. - For WebLogic
Log into WebLogic Administration console and ensure that the "mvsap-gw" component is started in the markview deployments. This is designated by the "Active" status in the Status column.
Review log files for errors
- If Markview Gateway is not functioning correctly then you will want to review the log files for any error messages. See the "Logging" section below for logging information.
Logging
Enable Debug Logging
- Set the MVERP_GATEWAY_LOGGING_LEVEL preference to DEBUG at the System level
- For MarkView versions up to and including 8.0, restart the MarkView Gateway component mvsap-gw on the Application Server
- For Markview versions 8.1 and higher, no restart is required although it may take a few minutes before the new logging level is established
Disable Debug Logging
- Delete the preference row set at System level for the preference MVERP_GATEWAY_LOGGING_LEVEL
- For MarkView versions up to and including 8.0, restart the MarkView Gateway component mvsap-gw on the Application Server
- For Markview versions 8.1 and higher, no restart is required although it may take a few minutes before the new logging level is established
Log File Location
- File location: All MarkView Components - Log File Locations
- File name: mvsap-gw.log
Impact of Debug Logging
- The Gateway log file will grow to 5000KB and will keep 3 backup copies of the log file before automatically overwriting them. In this case the maximum hard drive space taken up by the Gateway is 15000KB. If the log file exceeds the maximum size it will automatically overwrite the oldest information
- The Gateway log file does log a significant amount of data with debug logging enabled. Because of this the log files often rollover quickly in a Production environment. As such it is often best to reproduce issues in a non-production environment when Debug logging is needed on the MarkView Gateway.
Keywords: diag, info