- You must have at least 2 CPUs and 8GB of RAM allocated to the host machine that will be running the BlueCat Gateway instance.
- You must have an Address Manager server configured with the BlueCatGateway UDF and a BlueCat Gateway user. For more information, refer to the 'Configuring BlueCat Gateway' section of the BlueCat Gateway Installation Guide.
- You must have a BDDS v9.3.0 managed by Address Manager.
- You must have purchased the Discovery & Visibility GCP Adaptive Application from BlueCat.
- You must have a Quay account that has been granted read access to the Discovery
& Visibility GCP
For more information on setting up your Quay account, refer to the information that was provided when you purchased the Discovery & Visibility GCP Adaptive Application, or the Discovery & Visibility Package from BlueCat.
- You must have a Docker CLI password.
You can create one by clicking Generate Encrypted Password under Docker CLI Password on the Account Settings page in Quay.
Before you begin:
- Define a workspace:
- A workspace is the logical location for you to place your workflows and associated data, including configurations, libraries, requirements, permissions, and customizations; a workspace can be a Docker volume (recommended) or a volume on your local machine. For more information, refer to the Workspace section in the BlueCat Gateway Administration Guide.
- Define a logs directory:
- A logs directory can be a Docker volume (recommended) or a volume on your local machine
chmod -R o=rwx <mapped volume>
- You can name the workspace and logs directory to anything.
- The Discovery & Visibility GCP Adaptive Application saves configuration and workflow data to the workspace, and all execution and session logs to the mapped logs directory. If you do not map a workspace or a logs directory, all the configuration and logging data is written to the container by default.
- Log in to the Address Manager user interface.
- From the configuration drop-down menu, select a configuration.
- Select the Servers tab. Tabs remember the page you last worked on, so select the tab again to ensure you're on the Configuration information page.
- Under Servers, click the name of a BDDS. The Details tab for the server opens.
- Click the server name menu and select Service Configuration.
- From the Service Type drop-down menu, select BlueCat Gateway. Address Manager queries the server and returns the current values for the service settings.
- Under General Settings, set the following
- Enable Gateway Service—select this check box to enable BlueCat Gateway service.
- Ports—enter a list of ports to configure for Discovery & Visibility GCP.
- Environment Variables—enter a list of environment variables to pull to a container during startup.
- Under Repository Settings, set the following
- Repository—enter quay.io/bluecat/gcp_discovery_visibility
- Tag—enter 21.2
- Username—enter your docker username.
- Password—enter your docker encrypted password.
- Click Update.
After you click Update, Gateway Service initializes, pulls the images from the cloud or local repository, and initiates the container. Allow some time to register the configuration, after which Address Manager will redirect you to the Service Type dropdown menu page.
To confirm that the Gateway Service and container are running, select BlueCat Gateway from the Service Type dropdown menu. At the bottom of the page, you can find the Status and Description fields. If the Status displays RUNNING, the Gateway Service is enabled and the container is running.
Once you have installed the Discovery & Visibility GCP image on a BDDS, you must configure the Group Name/UDF permissions to all for the cloud_discovery and cloud_discovery_gui workflows to ensure that the CloudDiscovery tab appears in the Gateway UI. For more information on configuring workflow permissions, refer to Configuring the workflow permissions.