Tanzu Application Platform GUI and Catalog FAQ
search cancel

Tanzu Application Platform GUI and Catalog FAQ

book

Article ID: 297876

calendar_today

Updated On:

Products

VMware Tanzu Application Service for VMs

Issue/Introduction

This article refers to the Tanzu Application Platform GUI and Catalog FAQ

Environment

Product Version: 1.0

Resolution

Checklist:

Tanzu Application Platform (TAP) - TAP-GUI and Catalog FAQ

To help make TAP installation and configuration experience as simple as possible, R&D team compiled a list of most frequently asked questions.

1. I cannot access TAP GUI

Follow the instructions outlined in accessing TAP GUI

 

2. How do I set a domain name for tap-gui and other packages served up through tap-gui (e.g. learning center, api-center, api-portal)?

  • The domain name for tap-gui is specified under "tap_gui.ingressEnabled" and "tap_gui.ingressDomain" of tap-values.yml
# tap-values.yml (snippet)

tap_gui:
  service_type: ClusterIP
  ingressEnabled: 'true'
  ingressDomain: 'tap.org'

contour:
  envoy:
    service:
      type: LoadBalancer

 

  • A corresponding entry should be added in your DNS. This could either be an A-record, if it's pointing to an IP (e.g. external IP of the tanzu-system-ingress envoy service) or a CNAME if pointing to another domain of a cloud provider load balancer
  • In order to serve up the other packages under tap-gui's domain, a wildcard DNS entry would need to be provided e.g. *.tap.org. With this setup, api-portal can be accessed at http://api-portal.tap.org.   While the learning center is at http://learning-center-guided.tap.org.

 

 

3. How do I populate the TAP GUI Catalog?

You can initially load a catalog to pre-populate TAP GUI by providing a link in the tap-values.yaml during initial setup of TAP . There is a blank catalog and pre-populated sample/demo catalog provided on Tanzu Network or you can provide your own populated catalog for initial installation.
# tap-values.yml

tap_gui:
  app_config:
    catalog:
      locations:
        - type: url
          target: https://github.com/x95castle1/tapsme-catalog/blob/main/catalog-info.yaml

 

 

4. How do I get my component to show up in TAP GUI?

New components need to be manually registered through the Registry Entity button on the TAP GUI home page. You need to build a catalog with your source code and use the URL to the catalog-info.yaml file.
Here’s an example: https://github.com/x95castle1/jeremy-java-web-app/blob/main/catalog-info.yaml

 

5. How long does it take for TAP GUI to sync changes from a Catalog?

Changes made to the catalog definitions on your Git infrastructure are automatically reflected every 200 seconds or when manually registered.

 

6. How can I force a TAP GUI refresh?

Execute 

kubectl rollout restart deployment/server -n tap-gui

 

 

7. How do I unregister my app/component?

Components need to be unregistered individually by going into each component and selecting the three vertical buttons on the upper right hand corner of the page and selecting “Unregister component”.

 

8. Why did my data disappear in TAP GUI?

TAP GUI uses an in-memory database by default. If you want to persist the catalog information then TAP GUI should be configured with a backing Postgres Database.

References:
Configuring the Tanza Application Platform GUI database
Creating the PostgreSQL database


Additional Information

Powered by Wolken Software