This article provides instructions on the data that BP3 Labs support team may ask you to gather for the issues related to Brazos Portal. Examples of such issues would be:
- Users are not seeing tasks to refresh automatically in Brazos Portal
- Specific user(s) are not getting their tasks in Brazos Portal
- Brazos Portal first login gets stuck for some user(s)
Server-side Brazos Portal logs in DEBUG mode
- Goto Brazos Portal Admin page (/TaskPortal/admin.html or Admin link in Brazos Portal)
- Open Logging tab
- Change login level to DEBUG and Save -
- It's important to enable this during the reproduction of the problem. Changes are picked up on the fly/dynamically. So, once you reproduce the problem switch log level back to INFO.
- Download generated log files from the following directory:
- Zip up all the brazos_portal.log files and upload to corresponding BP3 Labs ticket.
- Open Chrome, FF or Internet Explorer
- Before navigating to Brazos Portal, open the Developer Tools panel (F12).
- IE: Under the 'Network' tab, make sure that 'Clear entries on navigate' and 'Always refresh from server' are unchecked.
Chrome: Under the 'Network' tab, make sure that 'Preserve log' checkbox is checked! Click on Clear button just before you begin recording / reproducing the problem.
Firefox: Once inside Developer tools click on Settings first in the right hand corner and make sure that 'Enable persistent logs' checkbox is checked
After that click on 'Network' tab and click on 'Clear' button (recycle bin icon) just before you begin recording/reproducing the problem.
- Press the green 'Play' button (IE) / 'Record network log' (Chrome) to begin recording network traffic.
- Proceed to the 'Console' tab inside the Developer Tools panel.
- IE: Under the 'Console' tab, make sure that 'Errors', 'Warnings' and 'Messages' are checked and 'Clear on Navigate' is unchecked.
Chrome: Under the 'Console' tab, click on 'Settings' in the right-hand corner and make sure that 'Preserve log', 'Show timestamps' and 'Autocomplete from history' checkboxes are checked.
Firefox: Under the 'Console' tab, make sure to click on 'Server' dropdown and select all the options in the list ('Errors', 'Warnings', 'Info', 'Log')
- At this point, keeping the Developer Tools panel open, the user should navigate to Brazos Portal and proceed with their work, exercising the system in an effort to reproduce the issue(s).
- Once the issues have be reproduced, or the desired timeframe has passed, the user should proceed back to the Developer Tools panel.
- IE: Under the 'Network' tab, export the network traffic to an XML file using the export (disk-icon) button.
Chrome: Under the 'Network' tab, right click anywhere inside the panel displaying http requests in the Developer Tools pane and select 'Save as HAR with Content'
Firefox: Under the 'Network' tab right click anywhere inside the panel displaying http requests in the Developer Tools pane and select 'Save all as HAR'
- Proceed back to the 'Console' tab inside the Developer Tools panel.
- IE: Right click inside the panel displaying all of the debug messages and select 'Copy All'. Paste the content into a paint-text file (e.g. Notepad), and save it in the same directory as the network data export from step #9.
Chrome: Right click inside the panel displaying all of the messages and select 'Save as'. Save it in the same directory as the network data export from step #9.
Firefox: Right click inside the panel displaying all of the messages and click 'Select All', then right-click again and click on 'Copy'. Once copied, open a notepad or any other text editor and paste all the data there and save as a text file.
- Attach the network traffic export and the text file containing the console messages to the BP3 Labs ticket for review.
Screenshot of Brazos Portal Admin page > Users tab > Show users
Goto Brazos Portal Admin page (/TaskPortal/admin.html or Admin link in Brazos Portal), open Users tab and check "Show users" checkbox -
Assuming there will be a lot of users, please make sure to capture user who reproduces the problem as well as any users with multiple connections if any.
Dump of <brazos_portal_schema>.CONFIG table
This table contains all the Brazos Portal configuration values and we need to see a full select from this table to check current settings.
You can just ask your dba or whoever has access to issue a query:
select * from brazos_portal_schema.config
And provide us with the output in a readable format (CSV is preferred).