Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

...

  1. Click AWS Marketplace to open AWS in a web browser.
  2. Search for Black Duck.
  3. On the search results page, click Black Duck.
  4. Click Continue to Subscribe.

  5. Click Continue to Configuration.
  6. Verify that the appropriate Region is populated, and then click Continue to Launch.
    On the configuration page, the latest software version, and your last-used region are prepopulated.

    Info
    For best performance, deployBlack Duck in that same region that you run Development workloads (CI/CD) on AWS.




  7. On the Launch this software page, verify that Launch from Website is selected under the Choose Action drop-down list.
  8. Select the EC2 Instance Type.
    The default instance type is m3.2xlarge, which represents the minimum requirements for running Black Duck.
  9. Select the VPC and subnet that you use to deploy Black Duck. 
    You must configure internet access or add a route so that Black Duck can communicate with Synopsys Detect and the Black Duck KnowledgeBase.

    Info

    When you invoke Black Duck from a CI system such as Jenkins or CodePipeline in AWS,
    ensure that the VPC and subnet where Black Duck is deployed can communicate with the VPC and Subnet
    where the CI is running.
    If your CI is external to AWS, ensure that the VPC and Subnet are accessible from where the CI system is running.


  10. Select an existing Security Group or click Create New Based on Seller Settings to create a new security group.

    Info

    The following ports must be open when you create a new security group:

    • Port 443: talks to Synopsys Detect (for scanning) and the Black Duck KnowledgeBase
    • Port 55436: used for Black Duck Reporting DB
    • Port 22: used for SSH admin access to the Instance, which you can close after the setup is complete.


  11. Select the EC2 instance Key Pair that you want to associate with your instance, and then click Launch.

  12. Locate the Instance in your EC2 Console > Instances page. 
  13. Right-click on the instance, and click Connect

  14. Follow the instructions to connect to the instance, replacing the root user name for CentOS
    Info

    Black Duck is installed on this instance by using Docker Compose. Refer to the Docker Compose installation documentation on Github.
    It might take several minutes for the Docker containers to start.

Retrieving the Black Duck administrator password

  1. .

     

    The resulting SSH command displays:
    Code Block
    languagetext
    themeRDark
    ssh -i "chosen-keypair.pem" centos@ec2-100-24-45-65.compute-1.amazonaws.com
  2. The temporary sysadmin password is stored in /home/centos/hub.pwd

  3. Save the password because it is required for the next step.

    Warning

    Reset the temporary sysadmin password to increase security.


Logging in to Black Duck

  1. Locate the Instance in your EC2 Console > Instances page.
  2. To connect to Black Duck, copy the public DNS prefixed by https into your browser URL bar.
    The result is formatted like the following URL:

  3. A certificate trust warning might display when you load the site because the because the web server container has a self-signed certificate from Docker.
    For now, it's safe to ignore that warning and go to Black Duck; Synosys recommends Synopsys recommends that you replace this certificate with a custom certificate. 

    Image Modified

    Info

    Instructions to replace the certificate are in the Docker Compose Installation Document.


  4. In the main login page, log in to Black Duck.

    Info

    The default username is sysadmin.
    The default password was shown in the previous stepis blackduck.


    Warning

    Reset the temporary sysadmin password to increase security.


If Black Duck is inaccessible, contact support@blackducksoftware.com. 

...