Discovery Cloud connector

1. Create a user in the BMC Helix Discovery and assign the API access rights. The connector uses the credentials of this user to connect to BMC Helix Discovery for data collection.
   1. Log in to the BMC Helix Discovery as an administrator.
   2. Click settings .
   3. Under Security, click Users > Add.
      

   4. On the Add User page, do the following:

      1. From the Template list, select User.
      2. Specify the user name and password details.
      3. Under Groups, select these check boxes to assign rights and add the user to these Public groups: api-access and never-deactivate
      4. Click Apply.

      The settings are saved, and a confirmation message is displayed.

2. Add manual groups for creating business services.
   1. Log in to BMC Helix Discovery as an administrator.

   2. Under Quick View, click any of the following options:

      • Application Instances - To add groups to application instances
      • Hosts - To add groups to systems under hosts
      • Virtual Machines - To add groups to virtual machines

      

   3. Select the check boxes corresponding to the application instances, systems, or virtual machines for which you want to add manual groups.
      

1. 
   
   1. Click Actions > Manual Groups, create the required manual groups and subgroups, and select them. The selected groups and subgroups are displayed under Manual Groups.
      • To create a business service hierarchy for the virtual machines below the application instance (BAI), the manual group name (default name: Service) must be associated with the parent application instance. If the manual group name is associated with the child application instance, the manual group is not created.
      • To create business services for virtual machines of unassociated hosts, you must add the manual group called Service on the virtual machine itself, with its value as subgroup.
      • By default, manual group AppTier is used for creating service pools below the business services. 

2. Create an API token for the user account. For information about how to generate a token, see the Managing system users in the BMC Helix Discovery documentation.

3. Ensure that integration with Remedy Single Sign-On in enabled in BMC Helix Cloud Cost and BMC Helix Discovery. Both these products use Remedy SSO for authentication of users. This step is required so that you can cross-launch to BMC Helix Discovery from BMC Helix Cloud Cost to view the Application Model details in BMC Helix Discovery.
4. Ensure that the manual groups, business services, and application instances are created in BMC Helix Discovery.

5. Ensure that BMC Helix Cloud Cost has scanned the resource utilization data from the same cloud environment as that of BMC Helix Discovery. For information about which cloud providers are supported by BMC Helix Discovery, see Supported Cloud Providers.

You must configure the connector to connect to BMC Discovery for data collection.

To configure the connector:

1. In the BMC Helix Cloud Cost dashboard, navigate to Connectors > Add a Connector > and select Discovery Cloud Connector.

2. On the Configure Connector page, configure the following properties:

   Property	Description
   Connector name	A unique name for the connector.
   Select Resource Types	Specify the type of resources for which you want to discover data center inventory, configuration, and relationship data. Cloud resources - Discover the resources from your multi-cloud environments On-premise asset - Discover the resources from your hybrid application environments
   Discovery configuration	Specify the endpoint URL to connect to your Discovery environment Select the authentication type: Token Based: The token of the user that you have created during the preconfiguration steps. User Credential Based: The name and the password of the user that you created during the preconfiguration steps.
   Business Service Configuration	Business Service Creation Criteria: Create Business Services for all Business Application Instances containing cloud resources: Scans data for all the manual groups Create Business Service based on Subgroup name where manual Group name is: Scans data for a specific manual group. Specify the manual group name for which you want to scan the data.

3. Collection mode: By default, the data collection cycle is set to On Demand collection. You can select an appropriate unit of time (days, minutes, hours) to schedule the data collection frequency.
4. Click Continue. 
   • A confirmation message about the request for data collection processing is displayed.
     The Manage Connectors page shows the details of the newly configured Discovery Cloud Connector.
   • (For on-premises Discovery connector only) BMC Helix Cloud Cost starts downloading the connector setup zip file automatically to your local disk. The downloaded zip file name is same as the connector name that you have specified in the connector configuration. After the download is complete, the state of the connector is displayed as Downloaded on the Manage Connectors page.
     1. Copy the downloaded zip file to a folder of your choice on the target computer. Extract the package.
     2. Run the connector package.
        • (Windows) Double-click run.bat

1. • 1. • (UNIX) At the shell prompt, type chmod +x run.sh to grant execute permissions to the run.sh file. Type run.sh and press Enter.

1. • 1. While the package execution is in progress, switch to the BMC Helix Cloud Cost UI, and from the Download page, click Continue.
     2. After the execution is complete, the Manage Connectors page shows the details of the newly configured Discovery connector and the state of the connector is updated to Running.

Verify that the connector executed successfully and check whether business services from BMC Discovery are imported into BMC Helix Cloud Cost as Resource Pools.

1. Business services imported as resource pools are marked with Business Service and Imported labels in the resource pools list. You cannot edit the details of these imported resource pools.
2. Cross-launch links are available from the Resource Pool details page that can be used to launch BMC Helix Discovery to see the Application model details.
   
   Application model details for WordPress_App displayed in BMC Helix Discovery when you cross-launch from BMC Helix Cloud Cost.