2Troubleshooting Methodologies Hyland Troubleshooting Tools These methodologies are universally used, not just with our software but with any software or hardware you may use in your organization. We will then get into discussing some of the troubleshooting tools we use at Hyland to diagnose OnBase issues.
39 Indispensable Rules of troubleshooting From Debugging by David J. AgansISBN #9 basic principles of troubleshooting as outlined in David Agan's book called "Debugging." This is a great reference that provides many real world examples of how the principles outlined in the book can be instrumental in identifying the source of an issue. This is required reading for all of the members of Hyland's Tech Support Department and something that we recommend for your personal bookshelf. You'll find that following the principle that I will outline briefly here can save you tons of time troubleshooting support issues.
4Rule #1 Understand the System Read the manual Know how the system is supposed to workKnow your tools
51 Read the Manual Hyland Community Training.OnBase Module Reference GuidesForumTraining.OnBaseWeb Based TrainingsEducation Services Class SchedulesRead the manualread it beforehand instead of as an issue arises, knowing how it works supposed to work lets you know what it is and is not capable of.For OnBase software, we have the module MRGs on the community site for any particular version you may be running. Training.onbase.com is also another great resource with web-based training and for a deeper dive, we offer many classes, including a week long course on Troubleshooting called “Supporting OnBase” which gives you hand on experience with many of the tools we reference in this presentation and much more.
6Know How it’s Supposed to Work Look up ALL the details on the issueSystem informationIs it supposed to work?DO NOT ASSUME!Trust but verifyKnow How it’s Supposed to WorkAre you sure the combination of software, operating system and third party software supposed to work together?Look up ALL the details on the issueSystem informationThe MRG lists all the hardware and software requirements that work with that specific version of the software you are usingIs it supposed to work?DO NOT ASSUME!Make sure to check the reference guideTrust but verify
71 Know Your Tools Know what tools to use Know how to use them! Know the limitations tooShould you use more than one tool?Maybe…Know Your ToolsKnow what tools to use and how to use them to gather the specific information you are using.One of the primary tools we have at our disposal is a Verbose log, however, if you haven’t enabled the Time stamp capability, you will not capture useful information if you are troubleshooting a performance issues.Know the limitations and capabilities of that particular toolInstead of trying to figure out how to use it when the issue occurs which only prolongs getting to the resolutionShould you use more than one tool?We may combine Diagnostics console logs with Event view logs or Verbose logs with the RPT file to get a better view of what is happening with the system
92 Make It Fail Why reproduce The Issue? Observe the behavior Narrow down the causeConfirm the fixWhy reproduce The Issue?Observe the behavior so we know what the steps are that we need to take to get it to fail. This not only helps us understand the issue and gather the appropriate information to diagnose but also allows us to retest with the fix so we can verify that we have actually resolved the problem. Narrow down the cause and then confirm the fix.
102 Make It Fail What are good details of a problem? Detailed steps to reproduce the issueObtain all facts when troubleshootingDoes the problem happen after the same set of actions?What are good details of a problem?Detail everything until you have gathered enough information to narrow it down.Try reproducing it on the system it originally occurred on and possibly another system with different environment variables such as operating system, browser etc. if it still occurs or does not occur, this is good information to know.Does the App Fail on Multiple Machines?Did the application work until recently?If so, what was changed?What do we mean by failure?Hang, Error Message, Access ViolationWhat does slow mean?Detailed steps to reproduce the issueObtain all facts when troubleshootingDon’t rule anything out it may or may not be relevant, but until we know for sureDoes the problem happen after the same set of actions?Or does it occur after a different set of steps the next time, this will help narrow down where the problem lies and a developer can look at a specific piece of code based on that information.
112 Make It Fail Intermittent Issues Find the signature of intermittent bugsAmplify testingCapture info on every attemptNever throw away a debugging toolIntermittent IssuesFind the signature of intermittent bugsWhat is the common thread, because it is intermittent, you may have to go through the steps to recreate many times before it occurs again. But when it does make sure document everything at the time it occurs such as day it occurred, the time of day, how many users are in the system, what other process happen to be running at that time,Amplify testingIf it happened once it will happen again, just keep at itCapture info on every attemptYou’ll need to set up logging, if there is an error, a screenshot every time since error codes could change slightly – it may look like the same but it may not beNever throw away a debugging toolLater on down the road you may find that a particular tool is no longer useful for the issue you are working on but until then, don’t rule it outBe patient, often times the intermittent issues take a while to pop up, but when they did, its important to be prepared with as many tools to capture the pertinent information
12Rule #3 Quit Thinking & Look Read the complete error message Get a screenshotRule #3Quit Thinking & Look
133 Quit Thinking & Look See the actual failure Do not just assume and fix the wrong thingSee the details - get complete infoGuessing is okay, but only to focus your searchQuit Thinking & LookSee the actual failureDo not just assume and accidentally fix the wrong issueYou may think that a change you made seems to have fixed the issue, but unless you have tested multiple times, and sometimes on different systems or even different steps, it may not be completely fixed.See the details - get complete infoGet the complete error message and make sure that when you recreate it multiple times, the error is the exact same like I mentioned in the previous section. 1 digit may change and that could be a factor.Guessing is okay, but only to focus your searchYou can guess any number of possible causes. You can only actually see the true cause.Sometimes it’s worth a guess if it’s an easy fix for a likely issues.I can’t stress it enough, Just gather as much detail about the situation you can (many different types of logs, screenshots, steps to recreate, details about when it occurs and how often, etc…) More is better than not enough especially when it is intermittent, it could drag out the resolution if we don’t have enough info to troubleshoot, we will have to wait until the next time it happens which in some cases I have seen it only occur once a month.
14successive approximation Narrow the search withsuccessive approximationRule #4Divide & Conquer
154 Divide & Conquer Narrow the Search with Successive Approximation Use available info from:Step 1 – Understand the SystemStep 3 – Quit Thinking and LookBreak it into smaller bites!Divide & ConquerNarrow the Search with Successive ApproximationWhat do we mean by that? Pick a # between 1 and 20, divide that in half and then in half again and again. Ultimately you are going to end up with one number that is going to be somewhere in those to ranges and then one of those two sub-range’s and so forth until you get down to a single #Use available info from both Step 1 and 3:Step 1 – Understand the SystemStep 3 – Quit Thinking and LookKnowing the system and how its suppose to work and then read through the error messages, log files, and other info you gathered and try and put 2 and 2 together to see if that helps you divide and conquer, narrowing your search to a specific variableBy breaking it into smaller bites you may be able to tell if itsServer Side, Client Side, or Configuration IssueAre all users affected? Only certain ones? Are they in the same User Group(s)?
164 Divide & Conquer Test for an expected result Start at the problem and work backwardsIt could be more than one thing!Sometimes they are both the same issueSometimes one fix causes another problemIs it noise or is it real?Widen the range if necessaryTest for an expected resultIn the case of WF, where is the document supposed to go, is there scripting involvedStart at the problem and work backwardsWorkflow – Use a control to isolate and confirmStart at the document, not the Lifecycle, look at the document history, what were the steps in the workflow to see if you can figure out how it got thereIt could be more than one thing!Sometimes they are both the same issue, sometimes there are 2 different issues and if you fix one issueIs it noise or is it real?Are we chasing a Red Herring, what you may be experiencing may not be the whole problem but a system of the actual issue.if necessary, Widen the range
17Change One Thing At a Time Evaluate the results ofeach changeRule #5Change One Thing At a Time
18Change One Thing At a Time 5Isolate the Key FactorAvoid Quick FixesChange ONE piece at a timeTest before the next changeDetermine what you changed since the last time it workedChange One Thing At a TimeIsolate the on thing that is causing the issueAvoid Quick Fixes just to get things up and running quickly there is a possibility that this may cause issues down the road even though everything may seem fine now. Sometimes with a little more time and effort, you can get it fixed and done right the first time.Change ONE piece at a timeTest before the next change to make sure what you are changing actually fixed the issue. If the change didn’t fix it, change it back! If you make too many changes at once and it ends up fixing the issue, you have no idea what actually fixed it unless you back out the changes one at a time which can be more time consuming. And sometimes it can actually be a combination of changes that ultimately fixes the issue.Determine what you changed since the last time it workedIf one day it was working great and the next day it’s not but as far as you are aware “nothing changed,” I can tell you by experience, something changed. It could be a configuration change if not made by you, someone else, perhaps there was a group policy that your IS dept pushed down to everyone’s machine, or a software patch that was applied, etc. If you have verified with anyone who touches your OnBase system, whether its the group who handles the security, the files server, the network, the database, webserver, workstations, etc.. and no one changed a thing, its possible something else changed such as the volume may have grown over time, or the number of users using the system, files may have become larger or a new file type being processed. Narrowing this down may take time but necessary to resolve completely.
19Rule #6 Keep an Audit Trail Log what you did, in what order, and the outcome
206 Keep an Audit Trail Write down what you did (DETAILS) What order?What happened as a result?Understand that any details could be an important oneCorrelate EventsKeep an Audit TrailWrite down what you did (DETAILS)What order?What happened as a result? Don’t count on your memory, spreadsheets are great for documenting issues, especially if there happen to be multiple admins which is the case with larger implementationsUnderstand that any details could be an important one, you may not think so, but another person may need that information to narrow down the search.Correlate EventsCommon to write as if you were instructing someone else, this will assure pertinent details are included.Writing up the who, when, what, why, where if applicableThis not only helps with the issue at hand but may help you or others in the future if this issue were to happen again or something similar. You then can resolve that issue more efficiently since you already have all the details necessary to troubleshoot. You know what worked and what didn’t so you may be able to create your own knowledgebase
21Rule #7Check the Plug“Assumptions often lead to trouble.” – Doug Kupec
227 Check the Plug Do not ignore the obvious Question your assumptions Don’t start at square threeTest the toolCheck the PlugDo not ignore the obviousQuestion your assumptionsTake a step back and check your own workDon’t start at square threeAn example would be if you’re getting ‘ No signal’ on you TV, don’t just assume it’s a bad signal, the cable box may not be on, or the tv set to the right channel, or the cable box just needs to be reset, etc… start at the beginning and work your way backTest the toolMake sure you are getting the expected results when using that tool. Again, that is why it’s important to know how the tool should work and its capabilities. If you leave for work in the morning and you can’t start your car and your gas gauge says you still have a quarter of a tank, don’t rule that out because you gas gauge may not be working properly. If you are not getting the results you need, try another tool.
23Ask for helpTalk to the mannequinRule #8Get a Fresh View
248 Get a Fresh View Ask for fresh insights Others are there to helpExplaining the problem may help resolve it!Listen to the voice of experienceLook at past experiences to resolve your problemsGet a Fresh ViewAsk for fresh insightsOthers are there to help, explaining the problem may also help to resolve it! That’s what we mean by ‘talk to the mannequin’. Explain to someone the issue is and what you have looked at so far, helps you to organize your thoughts which them may result in that ‘ah ha’ moment. Two heads are better than one. Don’t reinvent the wheel, if someone else has already spent hours researching something, leverage their effortsListen to the voice of experienceLook at past experiences to resolve your problemsInsight, expertise, experience can come from various placesNot only do we have module experts, but there are veteran analysts, senior analysts, Team Leaders and managers who may have seen the issue way back whenDon’t be too proud to ask
258 Get a Fresh View Report Symptoms – Not Theories! Reason to ask for help is that your theories are not getting you anywherePresent ALL info even if it may not appear relevantWhen you explain to others the issue you are experience, report Symptoms – Not Theories!Don’t cloud their thoughts with your theories, let them come up with their own and if they happen to be leading down the same path, you are probably on the right trackPresent ALL info even if it may not appear relevant so they can organize and gather their thoughts to come up with their own conclusions
26If You Don’t Fix It, It Ain’t Fixed! Problems never go away by themselvesRule #9If You Don’t Fix It, It Ain’t Fixed!
27If you Don’t Fix It, It Ain’t Fixed! 9Problems don’t occur for no reason and don’t fix themselves!Check that it’s really fixedKnow the causeVerify that the fix is what fixed it!If you Don’t Fix It, It Ain’t Fixed!Problems just don’t go away on their own but they also don’t occur for no particular reason.Check that it’s really fixedAfter troubleshooting your issue verify that your fix is what resolved the issue, you can do this by taking out your fix and test again to see if the issue still occurs, then put it back and test again, does it now work as expected, if so, there is your proofYou want to know the cause of the issue so you can understand why your fix actual resolved the issueVerify that the fix is what fixed it!If you followed the Make it fail rule, you’ll know how to prove that it’s fixed, don’t assume, test it!Be aware of the whole process… If it was a fix to you pc, will it also be resolved on someone else’s pc or will they also need the fix. If the fix was on the server, verify with multiple users not just one.This book has some valuable information and is recommended reading for any Technical support role.
28OnBase ArchitectureUnderstanding the OnBase Architecture if very important as it will provide you and understanding of where you are going to want to troubleshooting along with what utilities to troubleshoot with.An OnBase environment has many different moving parts. From a high level if we look at all of the different components we can get lost in all of the different connections that OnBase uses with the different components.We’ll brake this into two main sections; the OnBase Thick Client and the Core Based modules.
29Database Workstation Disk Groups ODBC Network Security First, let’s talk about the OnBase Thick Client. What is the OnBase Thick Client? How is it used?• The OnBase Thick Client is our oldest and most feature rich client• Used primarily in a LAN environment• Very efficient for processing• Can perform Process Tuning in the Client under Processing > Process Tuning. Process Tuning is Workstation specfic.• Primary processing client (DIP, COLD, XML, etc.)• Own code baseIn order to understand these parameters, we must understand the infrastructure of the OnBase Thick Client. The OnBase Thick Client communicates with the Database in order to find all the meta-data about a document. This meta-data will contain information such as the Doc Type and Keywords assigned to a document as well as the path to the actual document file itself.Secondly, once a user attempts to view a document, the OnBase Thick Client uses the path found in the database to open the document file from the disk groups. This means that if the user has rights to the document, per OnBase’s permissions, that user will also need rights to the Disk Group location in order to view the document.
30Database Disk Group Gateway Caching Server ODBC Network Security OnBaseWeb ClientGatewayCachingServerDatabaseHTTPODBCHTTP(Remoting or SOAP)OnBaseWeb ClientOnBaseWeb ServerOnBaseApplicationServerHTTPNetworkSecurityDisk GroupOnBaseCore ApplicationHTTPNext is the OnBase Web Server/Client. The OnBase Web Client communicates directly with the OnBase Web Server. The Web Server is primarily used as the presentation layer. The OnBase Web Server communicates with the OnBase Application Server in order to make the necessary connections to the OnBase Database and OnBase Disk Groups.~ Web Server (hosted on a Windows Server OS)• External (public) component• Purely a presentation layer• Rendering of the user interface• Obtains data from the Application Server• Users refer to this as OnBase~ Application Server (hosted on a Windows Server OS)• Internal (private) component• Contains all business logic• Performs all OnBase processing• Most users will never know this existsOnBase Core Applications communicate directly with the App Server and bypass the Web Server completely.What is the Core? Basically, the core is part of any OnBase application that needs to talk to the Application Server in order to connect to the database and disk groups. The Core has it’s own code base as well. These are just a few examples of modules that rely or CAN rely on the Core.
31Core Based Applications EnablerWorkflowDocumentCompositionReportServicesDisconnectedScanningBar CodeGeneratorIntegrationsUnityClientCore Based ApplicationsWhat is the Core?Basically, the core is part of any OnBase application that needs to talk to the Application Server in order to connect to the database and disk groups. The Core has it’s own code base as well. These are just a few examples of modules that rely or CAN rely on the Core.
33The Troubleshooting the OnBase Web Server End to End Poster https://www.hyland.com/community/onbase_product_communities/content_management_modules/web_server_product_page/b/3/archive/2012/10/01/troubleshooting-the-onbase-web-server.aspx
34OnBase Web Server Troubleshooting Web DiagnosticsTest.gifaspnetcheck.aspxDiagnostics Web PageDiagnostics ConsoleThere are various utilities to troubleshoot the Web Server and Application server. Here is a list of those we use at Hyland, but we will not go into any detail of how they are used since that will take an hour itself. At the end of the presentation we will give you a link to the full 2 hour ‘Troubleshooting Techniques & Utilities’ presentation on training.onbase.com that was created by our Tech Support department.The following tools are OnBase Web Server / Application Server specific tools used for troubleshooting issue.Test.gif - What does this tell us?IIS is runningIt is hosting static contentThe user requesting the file has accessAspnetcheck.aspx - What does this tell us?That ASP.NET is installed on the Web ServerThe user requesting the file has the permissionsUsing Diagnostics Web pageAccessible from any workstationInformation gatheredDuplicate FilesMissing FilesFile VersionWeb.Config SettingsClient Settings
35Notes about the Core Apps If a problem occurs in the Web Client, check the Thick ClientIf yes, probably configuration
37What is the Diagnostics Console? A utility that gathers log information related to OnBase Core based modulesUser interface that allows easy readability of the logsThe Diagnostics Console is typically used to troubleshoot Core-based products. It’s important to know that there are two parts to this; the Diagnostics Console and the Diagnostics Service. The Diagnostics Console is a stand alone utility which can run on the workstation/server in order to gather messages reported to the listener. It does not need to be paired with the Diagnostics Service, but can listen to it when running in remote mode.The Diagnostic Console is simply a user interface that allows easy readability of the logs.The Diagnostic Service is a Windows service that can run in the background to allow remote monitoring of the diagnostic logs or it can also log continuously to a log filehttps://www.hyland.com/community/technical_communities/onbase_installation_expertise/hyland_diagnostics_technical_community/default.aspx
38Hyland Diagnostics Console A basic screenshot of the Diagnostics Console.
39What is the Diagnostics Service? A service running on the Application Server and/or Web ServerDisplay messages to the Diagnostics Console or log them to a fileAllows for remote monitoring of serversThe Diagnostic Service is a Windows service that runs in the background to allow remote monitoring of the diagnostic logs or it can also log continuously to a log file
41Local vs. Remote Mode Two ways to run the Diagnostics Console Local ModeLogs are gathered from the local workstationWill not work if Diagnostics Service is runningRemote ModeDiagnostics Console connects to the Diagnostics ServiceMessages are written to the Diagnostics ServiceMust have rights to start the serviceLocal mode is when the Diagnostics Console is listening to the events from the workstation when the app is running on. You can set local mode to capture events occurring on the Client side (ActiveX errors, etc.) or Server Side when running the Diagnostics Console on the Web or AppServers.Remote mode is set when connecting to the Diagnostics Service which is running on another workstation/server. For instance, running the Diagnostics Console on an admins. workstation in order to connect to the Diagnostics Service running on the Web Server.
42When to use it? Troubleshooting issues with Core based modules Web ServerApplication ServerAny module which connects to the Application ServerWhen running the OnBase Thick Client as a Windows Service
43Enabling diagnostics settings The Logging Profile page can be accessed from the Web Diagnostics page. If you modify the Web Server’s Web.config file or recycle its application pool, the Web Server’s logging profiles are reset to use the settings in the Web.config file. Similarly, the Application Server’s logging profiles are reset if you recycle its application pool or modify its Web.config file.
44Diagnostics Web Logging Profile Logging Profile option was added inLogging Profile does not require an App Pool restartReset back to the Web.Config settings (defaults) upon App Pool restart
45errors tabThis log captures errors generated by OnBase applications. To facilitate troubleshooting, error logging is always turned on and cannot be disabled.
46Database tabThis log captures database queries that are run through Hyland.Data. For .NET-based applications, database logging is enabled in the applications’ configuration files. OnBase applications that are compatible with this type of logging have a db-profile log defined in their configuration files.
47Ldap / NT Authentication tab This log captures all LDAP diagnostics information. For .NET-based applications, LDAP logging is enabled in the applications’ configuration files. Beginning with OnBase 8.0, applications that are compatible with this type of logging have an ldap-profile log defined in their configuration files.
48File tabThe File tab will display file access performed by the OnBase Application Server.
49Timer / distribution service Timer / distribution serviceThis log captures information from the Hyland Timer Service and the Hyland Distribution Service. Logging is enabled through the timer-profile log that is defined in the services’ configuration files (Hyland.Core.Timers.NTService.exe.config andHyland.Core.Distribution.NTService.exe.config).The Distribution Service’s configuration file also lets you set a verbose level to control the amount of information that is logged. Set the verboseLevel attribute within the Hyland.Core.Distribution.NTService.Exe.config file to the appropriate value, as describedbelow:• 0 - Logs service start, stop, and error messages to the Error Viewer log.• 1 - Logs notifications sent by the service to the Timer/Distribution Service log.• 2 - Logs all trace messages that are sent to the Error Viewer log.
50System information tab The System Information tab will capture some general information about the system.
51Enabling Thick Client Verbose Registry Settings32-bit WorkstationsHKLM| SOFTWARE | Hyland | Diagnostics64-bit WorkstationsHKLM| SOFTWARE | Wow6432Node | Hyland | DiagnosticsSet Log Profile to decimal value of 64 (not HEX)If you use the –V SQL,T switch or any derivation of this switch as an argument when configuring OnBase to run as a Windows Service, additionally queries will be logged. If you are simply wishing to monitor the service, the command line arguments are not needed.
52Best Practices Log to file when logging a lot of data Do not run the Diagnostics Console all the time
53Best Practices Only enable needed mailslots Utilize Web Diagnostics Logging ProfileSave all tabs when engaging supportUtilizing the Web Diagnostics Logging Profiles will allow you to enable specific logging profiles for the current session. This can be very helpful in order to limit the amount of time that a particular profile is enabled. If it is needs to log for a longer period of time, enable the mail slot in the respective web.config and configure the Diagnostics Console to log to file.
54Recommendations Enable filtering Enable the User Name column If you don’t see what you are looking broaden your filtersEnable the User Name column
55Windows Event ViewerStatistically, only about 7% of support issues received by Hyland Software Technical Support are associated to or turn into the need for a software change. What that means is that the majority of issues are either due to a configuration issues, a network/security issue. So what’s the best way to approach a situation that might be caused by something external?
56Windows Event ViewerThese are the “no brainers” to look at when you see unusual behavior, particularly in the Core and Unity based interfaces or if scripts are involved. Because we leverage underlying Microsoft functionality such as .NET for example, many issues that arise will report to event Viewer.Within the Windows Event Viewer there are a few Windows Logs which could contain messages related to the OnBase system. View messages in the Applications, System and OnBase Logs.
57What is logged here?Messages from the OnBase Client closing unexpectedlyIIS (OnBase Web or Application Server)Application Pools not startingPlatter Management ErrorsActive Directory AuthenticationOnBase Integration issues related to:Office Business ApplicationOutlook IntegrationNot every messages will be as obvious as the previous example, but often it is.
58Tips on Windows Event Viewer Errors typically correspond to messages in Diagnostics ConsoleTry to correlate the times stamp in the Diagnostics Console with what you are seeing in Event Viewer. Sometimes the messages will be similar but different information is logged by Microsoft vs. OnBaseEven when logged messages are not particularly obvious, there is a strong likelihood that if the issue needs to be escalated, these logs will be requested. These messages can be very user “unfriendly” at times.
59OnBase Thick Client Verbose The verbose log is a text file created by OnBase that can be viewed in Notepad or any text editor
60What is Verbose? Detailed log of OnBase activity Logs most SQL queries executedUsed to see what is happening right before an errorCan help pinpoint long running queriesWhat is Verbose?It’s a detailed log of OnBase activity that can be viewed in Notepad or any text editorLogs most SQL queries executedUsed to see what is happening right before an errorCan help pinpoint long running queriesLogs almost all queries executed against the database to a file. If errors or an unexpected termination occurring, a verbose allows you to see what OnBase is trying to do right before the error or unexpected termination? It is used to identify performance issues such as time gaps between queries, query that is taking a long time to execute, etc. This helps in the ability to execute that same query directly against the database and verify if the issues is database related or OnBase.
61Two ways to enable Verbose Command Line SwitchAvailable with OnBase Thick Client and ConfigApplication launch issuesTool Bar Option (OnBase Thick Client Only)Limits the amount of data capturedTwo ways to enable VerboseCommand Line SwitchAvailable with OnBase Thick Client and ConfigApplication launch issues (hangs when logging in or it closes unexpectedly when trying to launchTool Bar Option (OnBase Thick Client Only)Limits the amount of data capturedThis is great when performing tasks like retrieving documents through Document Retrieval is taking a long time (Searching and displaying)Or indexing takes a long time to perform
62Command Line Verbose Options -V SQL,TIncludes SQL with time stamps-V SQL,LIncludes table lock codes-V SQL “itemdata”Includes only log statements thatinclude the text of “itemdata”Command Line Verbose OptionsMake sure that the capitalization and spacing of the switch is correct.-V SQL,T (V enables verbose, the SQL adds the SQL statements and the , T adds the time stamps) so you can see what time a query begins and ends, this used most when troubleshooting performance issues.Includes SQL with time stamps-V SQL,LIncludes table lock codes-V SQL “itemdata”Includes only log statements thatinclude the text of “itemdata”It is possible to use multiple command line Verbose options togetherExample:V SQL “update” “itemdata”,T,LIt is possible to use multiple command line verbose options together.Make sure to put a single space between each item if it is not followed by a ,.In this case the verbose log will contain SQL statements with timestamps for any action performed along with instances of SQL queries containing the term “update” or “itemdata”.
63Command Line Verbose Options It is possible to use multiple command line Verbose options togetherExample:-V SQL “update” “itemdata”,T,LIn this case the verbose log will contain SQL statements with timestamps for any action performed along with instances of SQL queries containing the term “update” or “itemdata”.
64Enabling Verbose – Tool Bar option Help | About OnBase Client | Verbose | chatty
65What is the output? Verbose writes to the verbose.txt file Located in the TempParsePath (by default)
66Tips on running Verbose Capture the most relevant dataEnable verbose immediately before actionTruncate the logDisable afterwardVerbose files are always appendedMost recent data at the bottomTips on running VerboseCapture the most relevant dataEnable verbose immediately before actionTruncate the logEither locate the verbose.txt, open it and highlight everything and delete then save and closeOr go back to Help | About OnBase Client | Verbose | chattyTruncating the verbose log is not always necessary. Sometimes it is important to save the verbose log to another location prior to truncating it in order to gather information about a previous attempt at capturing data.If the file does not exist then it will be created.Disable afterwardVerbose files are always appendedMost recent data at the bottom
67Tips on running Verbose Verbose files can become very largeLimit the amount of data capturedDon’t leave verbose switch on processes
69What are RPT Files? Typically (but not always) generated when: OnBase unexpectedly terminatesA debug assert error occursLocated in the same folder as the OnBase executablesObclnt32.rpt - RPT file for the OnBase Thick ClientObcfg32.rpt - RPT file for the OnBase ConfigWhat are RPT Files?Typically (but not always) generated when:OnBase unexpectedly terminatesA debug assert error occursThis is a file that we would give to our Developers to debug an issue. Not something we would expect your or any of our support reps to understand.Located in the same folder as the OnBase executableObclnt32.rpt - RPT file for the OnBase Thick ClientObcfg32.rpt - RPT file for the OnBase Config
70X RPT Files Always click Retry Then click Abort Don’t click Ignore Do not click Ignore on an Debug Assertion screen. Select Retry to aid in generating a RPT which can be used to help troubleshoot the issue that is causing the error. After clicking then Abort.Check to see if the RPT file was created after an unexpected termination or errorReproduce the unexpected termination or error with the verbose enabled
71Tips on RPT FilesIf the exception is recreateable, generate a verbose along with the RPT fileCheck to see if the date/times in the verbose file match the RPT file
72Tips on RPT Files Open RPT files in an advanced text editor Notepad2, Notepad++, WordPad, etc.RPT files are always appended
73Tips on RPT Files Where was the OnBase Thick Client opened? From a Network ShareLocally on the workstation
7722.214.171.124 Understanding OnBase Versioning The first digit designates the version.It corresponds to the year of release.
78126.96.36.199 Understanding OnBase Versioning The second digit designates release or beta software. Even numbers (0,2,4, etc.) are release softwareOdd (1,3,5…) are beta software These will only change if there is more than one full release in a calendar year.There is always a beta code stream that exist at the same time a release version exists. Currently beta software 12.1 is being developed concurrently with the 12.0 release software. Eventually the current 12.1 beta software will be stamped as the 13.0 release. The same took place when 10.1 became 11, when 11.1 became 12, etc.
79188.8.131.52 Understanding OnBase Versioning The fourth digit designates individual builds within a version. All builds of the Core start with 1 (1 – 499)All builds of the Thick Client start with 500 ( )The build will increase successively regardless of change in the Service Pack (xx.x.#.xxx) value.
8012.0.1.89 Understanding OnBase Versioning The third digit is for Service Pack versioning.
81Check out the Hyland Community !!! Product InformationDocumentation (MRG’s)Presentations & FilmsBlogsForumsTechnical Knowledge BaseTroubleshooting Checklistand more…
82There are around a dozen downloadable files in the latest Release version
86What information should I have? Customer Name or HSI #Level of priority for this issueLow, Medium, High or CriticalOnBase Environment of issueProduction, Test or Disaster Recovery System
87What questions will I be asked? OnBase Environmental InformationOnBase Version and BuildProblematic OnBase ModulesDatabase Platform and Version
88What questions will I be asked? Issue Specific InformationCan this issue be reproduced?When did it start to occur?Is it specific to a single user or all users?Is this a new process or existing?Have there been any changes?Are there any error messages?Can this issue be reproduced?Have you been able to reproduce in production?Have you been able to reproduce in test?Is your test environment the same as production?If not, can you reproduce in a different version/build of OnBase?When did it start to occur?Is it specific to a single user or all users?Is this a new process or existing?Have there been any changes?Are there any error messages?
89Useful Data Screenshots Log Files Any errors or error messages Verbose Diagnostics Console (Save all tabs!!)Too much info is (usually) better than too little info. Also, text output of error messages is very helpful as well.
90Tips on gathering data Make sure the time stamps match Diagnostics ConsoleVerbose file vs. RPTThird Party toolsProcess Monitor, Wireshark, Fiddler, procmon, regmon, etc…