What to share when reporting issues to Delft-FEWS supportShareables | When to share | Remarks |
---|
Delft-FEWS release version | Always | If you Just share the full log file | , double (see section below 'How to help us to support you'), and check the build number is included. Add this to the Affects Version/s and Backport Version/s fields in Jira (for backporting guidelines see Backporting - DELFT-FEWS Documentation - Deltares Public Wiki) | Name of customer (company) | Always | Add this to the customer name field in JIRA | Problem description | Always | Clear steps and enough information how to reproduce the issue (problem description information) | Additional context | Always | e.g. related FEWS Jira number if available (additional context) | Delft-FEWS configuration | Always | F12->export->default config as zip file For Deltares employees, put the system here: p:\delft-fews\Test FEWS Releases\FEWS-applications\ | Priority | Always | Blocker --> addressed immediately Critical --> addressed within a week Major --> addressed within three weeks Minor --> addressed in next sprint Trivial --> picked up when time | Component | Always | Pick a Delft-FEWS component from the list in JIRA | Logging | When there is a stacktrace or relevant logging in the log file. | See also Howto activate debug mode | Screenshots | When required or helpful for reproducing the issue | ALT-PrtScr | Delft-FEWS configuration | When a specific workflowId or gui component is causing the issue | F12->export->default config as zip file | Local DataStore | When data is required | or helpful for reproducing the issue | The stand alone application and the synchronizing LDS Operator Client has a local datastore in the Region Home folder. | Collected Log files | When Always when there is an issue in the live system that needs analysis | See also Collect System Log Files | Replica | When required or helpful for reproducing the issue | F12->database->replicate database | Thread dump | When there is a deadlock | How to create a Thread | dump under Windowsdump | Heap dump | When there is an OutOfMemoryError | How to automatically create a JVM heap dump when experiencing OutOfMemoryError | Movie | When required or helpful for reproducing the issue | F12->screen recording->start/resume recording | Screenshot of Admin Interface Database trends | When there are database performance issues | See Database trends |
You can reach Delft-FEWS Support via: fews.support@deltares.nl (only for clients with a Support & Maintenance contract in place). Provide clear problem descriptionsproblem descriptions Anchor |
---|
| problemDescription |
---|
| problemDescription |
---|
|
- A detailed description of what the problem is.
- What the expected behavior is.
- Describe in numbered steps how to reproduce the issue.
- If there are multiple problems, number them, e.g. Issue 1, Issue 2, etc. so that they be more easily registered under separate issues in the issue tracker.
- If there is a GUI component involved
- specify in ordered steps what component to activate, where to click
or use - .
- share a screenshot of the problem,
- or share a movie using the screen recording functionality.
Provide additional contextcontext Anchor |
---|
| additionalContext |
---|
| additionalContext |
---|
|
Is it a new problem? If there is a known JIRA issue number please include it in the communication. What has changed? Has there been a recent configuration change?
Problem description: - detailed, step by step description to reproduce the bug (Where exactly to click, which workflow to run, what settings/system time to use, from which menu the window can be opened (if it is a less commonly used tool), where in the display tree the given location/plot can be found, etc.) - a screenshot of reproducing the problem - a description what is the expected behavior and what happens instead - a screenshot of the bug happening - the Jira issue number of the feature / development that is linked to the bug (If known) Configuration: Depending on where the bug occurs the following might be entailed in configuration: - adapters - import/export folders - modules - models - client trust store - any other folder in the same directory as config, such as Archive, WarmStates, Cashes, etc. Local DataStore: -should contain data relevant to the issue Please note, that not all of these are necessary for all bugfixes, but most of these are needed for the majority of the issues. Including more than what is needed will not hinder bug fixing, adding too little will slow down support. - Which workflows are involved.
- If the workflow has other, irrelevant modules (like other imports) please indicate that, or even better, comment them out.
- What T0 (system time) is used for a failing forecast run.
- If an adapter is run with an older JRE version, this is useful to mention.
- What menu item will bring up the component of interest.
Share the config, local datastoreIt depends on the issue / bug whether the configuration or other things are needed. - If an import fails, share an example import file.
- Config and local datastore are not strictly necessary for all bugfixes, but including them will speed up support.
- Depending on the bug, sharing modules, models, import/export folders might also be needed.
How to help us to support you(Especially when you have no idea what is wrong and where to look) Info |
---|
Providing Delft-FEWS support with relevant log files, screenshots or even a copy of a config / local datastore may help us solving the issue more efficiently. Do not assume we know every detail of your system, so please give a detailed description where you encounter a problem. |
Below you will find some useful tips to analyse your system and provide useful information to the fews support helpdesk. In general: - Check the System Monitor Display in your Operator Client and Analyse the ERROR messages (what kind of errors do you see), export (copy) them and send them to fews supportPlease describe in as much detail as possible how to reproduce the issue
- Make screenshots of the problem that you encounter (graphs / spatial display / admin interface / etc)
- Check the Troubleshooting section or the section about Log files and the System Checks (depends on age of document) section in the System Administrations Guide provided for your FEWS system
If it is a connection problem (with the Master Controller): - Check the status of the system through Admin Interface system status page, is everything green?
- Check the View logs page in the Admin Interface for ERRORs
- Log files in the Master-controller / Forecasting Shells will by default only remain the last ten days / for a certain disk limit.
- Use Collect System log files from the Admin Interface to collect the log files from all FEWS backend components and send them to fews support
If it is a problem with (failing) workflows on the Forecasting Shells - Check the log.txt in the root of your Forecasting Shell or out.txt or out.txt.old in the MCProxy folder (check your system admin guide for the location)
- Check the View logs page in the Admin Interface for ERRORs
- Use Collect System log files from the Admin Interface to collect the log files from all FEWS backend components and send them to fews support
If it is a problem in your Operator Client: - Check the log.txt file from your Operator Client to find out whether it contains the Text ERROR. This file is located at the same level where the localDatastore folder is created. Please send this log.txt to fews support
- If you send us a snippet of the log.txt, please remember to include always the build number section.
- If it is an issue with your operator client please copy the localDatastore folder (and store it somewhere else) for hand over to fews support if needed
Note Delft-FEWS will run through a VPN or via Remote Desktop Protocol, so having those connections available to us will improve the efficiency of our support. The ability to diagnose issues will depend upon the bandwidth for the connection. |