General Troubleshooting

For any issue when you see something unexpected

Steps

1. Apply the latest MM Cumulative Patch (and make sure Database Script has run long enough)
2. Go to MANAGE > System and select Enable in the Debug Logging pull-down and then reproduce the issue.
3. Open the process log and be sure to select Show: All. Then, make any changes specified in the log messages.
4. In addition, if you see an error reported like this:

“…please contact your system administrator”

The details may be in the System Log and are likely to be debug level messages.

Get the Debug level system log by going to

• Go to MANAGE > System and select Enable in the Debug Logging pull-down.
• Reproduce the issue.
• Go to MANAGE > System and select Disable in the Debug Logging pull-down.
• Analyze the debug level messages from the time the issue was reproduced.

Explorer Further

UI Troubleshooting

For any issue where you see something unexpected in the UI, please perform the following steps.

Steps

1. Stop Talend Data Catalog service on the server machine and run Talend Data Catalog as a desktop app by selecting Start -> All Programs -> Meta Integration -> Server Restart.
2. Close all instances of the web browser you are using.
3. Check that the browser and Adobe Flash are updated to the latest patches.
4. Open an instance of the browser.
5. Clear the cache and recent history on the web browser:
   • go to _MANAGE > Configuration > Update and Build > Clean Build_
   • Press F12 to use the developer tools
   • RIght click on the browser refresh button and select Empty cache and hard reload
6. Close all instances of the web browser.
7. Open the browser and reconnect to Talend Data Catalog .
8. Remove any zoom effects on the browser, generally by using Ctrl-0.

For any issue where you see something unexpected when importing a model, please perform the following steps.

Steps

1. Review the tool tips (help) for the bridge in general and each bridge parameter individually to ensure that the bridge is being used correctly.
2. Open the import (or export) log and be sure to select Show: All. Then, make any changes specified in the log messages.
3. Stop Talend Data Catalog service on the server machine and run Talend Data Catalog as a desktop app by selecting Start -> All Programs -> Meta Integration -> Server Restart. If this step resolved the problem, you will need to configure the service to have the proper credentials. More details may be found in the deployment guide:
4. Step (3.) in section (5.1) “Default install on Windows with bundled Tomcat”
5. All the steps in section (6.) “MIMB (Metadata Harvesting)”.
6. Clear the import cache directories on the application server machine at:

$MM_HOME/data/MIMB/cache

7. Go to MANAGE > System and select Enable in the Debug Logging pull-down.
8. For any import bridge issues, go to MANAGE > Configuration, select the model, click IMPORT

9. and specify:
   • FULL SOURCE IMPORT INSTEAD OF INCREMENTAL
   • SAVE IMPORT TROUBLESHOOTING DETAILS

10. Open the log when the import is completed and click Download troubleshooting details.

For any issue where you see something unexpected and neither of the above have resolved the issue.

Steps

1. Ask the system administration staff to review the installation and configuration steps deployment guide, especially the sections covering installation and testing of the Application Server and software.

When reporting an issue, there is some information you should collect beforehand.

Steps

2. Sign in as a user with at least the Application Administratorcapability global role assignment.
3. Get the Application Server and Database Server Details by going to either:
   • Go to MANAGE > System
   • Click Download (top right) to obtain a TXT file of the application and database server Information
   • Click Operations (top left) > Get repository content statistics (run script and save log)
   • Click Operations (top left) > Test performance (run script and save log)
4. Get the Database Maintenance Status by going to either:
   • Go to MANAGE > Schedules
   • Select the schedule (top panel) Run Database Maintenance
   • Select the latest execution in the History (bottom panel) and click View Log (on the right)
   • In the Log Messages dialog, click on Show All (bottom), and Save
5. Get the Repository Content Statistics for (each) Configuration by going to:
   • Go to Objects > Statistics In the banner, click on Download (top left) the CSV file of the configuration statistics.
6. Get the System Log by going to
   • Go to MANAGE > System and select Enable in the Debug Logging pull-down.
   • Reproduce the issue to report
   • Go to MANAGE > System and select Disable in the Debug Logging pull-down.
   • Zip up the debug logs and attach to the ticket.

7. For any import bridge issues, go to MANAGE > Configuration, select the model, click IMPORT

8. and specify:
   • FULL SOURCE IMPORT INSTEAD OF INCREMENTAL
   • SAVE IMPORT TROUBLESHOOTING DETAILS

9. Open the log when the import is completed and click Download troubleshooting details.
10. Attach the debug package (zip file downloaded) to the ticket.
11. Finally, if it a UI issue and you are requested to, please use the below steps to capture the .HAR file.

The are the instructions for Google Chrome. Other browsers have similar capabilities.

1. Open Chrome
2. Go to the Customize and Control Google Chrome options menu and select More tools… > Developer Tools or simply press F12
3. Go to the Network tab
4. Reproduce the issue
5. Click the on Export HAR (down pointing arrow)
6. Save the file
7. Attach to the ticket.