Onboarding BMC BladeLogic Server Automation

This topic describes a process for onboarding a connector for BMC BladeLogic Server Automation (BSA). The process requires you to download and run a small program on your premises. Running as a service, the on-premise program is the connector that enables communication between SecOps Response and a BSA Application Server. 

The following sections in this topic describe how to onboard the BSA connector. 

The following video demonstrates how to use SecOps Response to onboard a connector for BSA.

https://youtu.be/EPBfzuEZAwA

 


Before you begin

To set up a connector:

  • Confirm that the server running the connector meets minimum requirements:
      Page not found for multiexcerpt macro.
    The page: Minimum hardware and software requirements was not found. Please check/update the page name used in the 'multiexcerpt-include macro.
  • Web services must be enabled on the BSA Application Server.

     Click here to see instructions for enabling web services.
    1. Log on to the BSA Application Server.
    2. Start the blasadmin utility (also called the Application Server Administration console).
    3. Run the following command to enable web services: 
      set AppServer enablewebservices true
    4. To confirm that web services are enabled (that is, set to True), run the following command:
      show AppServer enablewebservices
    5. Restart the BSA Application Server.


Note

When onboarding connectors, a single machine cannot host more than one connector of the same type. For example, if you have onboarded a connector for BSA on a host, you cannot successfully onboard another BSA connector on the same machine.

To onboard a BSA connector

  1. Log on to SecOps Response as a SecOps Response administrator with your registered credentials.

  2. Take one of the following actions:
    • If you have already onboarded a connector, click Add Connector. The Choose Connectors page opens. Skip to step 4
    • If you have not previously downloaded any connectors, review the introductory page.
  3. Click Get Started.
    The Choose Connectors page appears. It lets you choose the system connectors that will interact with SecOps Response.  
     
  4. On the Choose Connectors page, select BMC BladeLogic Server Automation connector.
  5. Click Download.
    The Download page opens. It provides downloading instructions for the selected connector.


  6. Download the connector for BMC BladeLogic Server Automation by clicking on next to BMC BladeLogic Server Automation connector.zip.
    The connector is downloaded locally.
  7. Before installing the connector, ensure that Java 1.8 or later is running on the local environment.

    Tip

    To check which version of Java is installed, use a command line and enter the following command: java -version

  8. Using any standard compression tool, extract the BMC BladeLogic Server Automation.zip file to the location where you want to install the connector.
  9. Depending on the operating system, take one of the following actions:
    • (Windows) Perform the following steps:
      1. Using a command line, cd to the location of the extracted ZIP file contents.
      2. Install the connector by entering the command: bsa-connector.exe install
      3. Start the connector by entering the command: bsa-connector.exe start
        To stop the connector, enter the command: bsa-connector.exe stop
    • (Linux) Perform the following steps as the root user or using sudo:
      1. Cd to the location of the extracted ZIP file contents.
      2. Grant execute permissions to the install.sh file by entering the command: chmod +x install.sh
      3. Install the connector by running the command: ./install.sh file. 
      4. Grant execute permissions to the connector.sh file by entering the command: chmod +x connector.sh
      5. Start the connector by entering the command: systemctl start bsa-connector
        To stop the connector, enter the command: systemctl stop bsa-connector
        You may also want to run the command systemctl enable bsa-connector, which instructs the connector to start on reboot.
  10. Using the onboarding application, click Configure.
  11. The Configure page asks for information needed to set up a connection to a connector. The information requested depends on which connector you are configuring.
     
  12. Provide the following information for the BSA system connector.

    OptionDescription
    BSA Application Server NameFully qualified name or IP address of the BSA Application Server.
    BSA Application Server Port

    Port used to communicate via web services with the BSA Application Server. By default, BSA uses 9843.

    Tip

    If you have access to the BSA Application Server, run the following blasadmin command to show its web service communication port:

    show AppServer HttpsPortNumber

    BSA Administrator Role NameThe role in BSA that will be granted administrative permissions. Users belonging to this role are called endpoint administrators, and they are able to perform administrative actions in SecOps Response.
  13. Click Finish

Where to go from here 

To onboard optional connectors, see Onboarding BMC Atrium Orchestrator and Onboarding BMC Discovery.

To learn more about the SecOps Response process, see Demonstrating the SecOps Response process.

Was this page helpful? Yes No Submitting... Thank you

Comments