Troubleshooting an Application
Troubleshooting the Front-End of the App
-
Open the JavaScript console of the app in any browser, to troubleshoot the front-end of an app.
-
Monitor the API requests called when using the application.
Collecting Tech Support Logs for a Stateful App
-
Log in to the tech support UI.
-
Create an On Demand tech support policy.
-
For an On Demand tech support policy, select For Apps option.
-
Select the name of the app from the App drop-down list.
-
The logs will be located in the /data2/logs/app-name directory. The app data will be located in the /gluster/gv0/app-name directory.
Troubleshooting the Backend of a Stateful App
You can modify the source files running in the backend on the service directory on the APIC. You must then uninstall and reinstall the app on the APIC for the changes to take effect.
Troubleshooting an Installed Application
To report any issues, regarding an installed application you can send an email to the app developer. Select the app to view the details such as contact information.
Troubleshooting RBAC
After installing an app, ensure that the Managed Objects (MO) for the app user, user role, and security domain are created.
-
Log in to Visore to access the MIT for the app. See the Cisco APIC REST API Configuration Guide for information about using Visore.
-
Run a query to verify that the aaaRole, appAppUser MOs are created for the app.
-
Run a query to verify that the MO apPlugin is created. Verify that the fields configInfo is empty and configSt is populated as none.
Verifying Creation of Managed Objects for an Application
After you upload an app to APIC, ensure that the Managed Objects (MOs) firmwareFirmware and apPlugin are created.
-
Log into Visore. See the Cisco APIC REST API Configuration Guide for information about using Visore.
-
Run a query to verify that the MOs firmwareFirmware and apPlugin are created.
-
For the apPlugin MO, verify that the fields permissions, permissionsLevel, pluginState, pluginType, and securityDomain are defined.
-
For a stateful app, verify that the apPluginAppliance MO is created for all the APICs in a cluster. The leader APIC will have the fields cntrInstID, and cntrInstIP populated with the container ID and IP address.
Troubleshooting Scenarios
The following table summarizes common troubleshooting scenarios for developing an app for the Cisco ACI App Center.
Problem |
Solution |
---|---|
The status of the docker is displayed as Restarting and you are unable to ssh to the docker container. This issue is encountered if there is an issue with the starting script or start.sh. |
Access the app.log located at /data2/logs/<Vendor>_<AppID>/logs in the APIC to troubleshoot the issue. |