Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Overview

...

  • An authorized account to Google Cloud

  • Cloud SDK installed with the authorized account to Google Cloud

  • Docker installed

  • The relevant package manager must be installed. For details, see https://whitesource.atlassian.net/wiki/spaces/WD/pages/1140852201/Getting+Started+with+the+Unified+Agent#Prerequisites .

  • Make sure Google Cloud SDK is your docker helper. If you didn't run it before, you can do that with the command
    gcloud auth configure-docker 

  • Google Container Registry API in Cloud Console is enabled, and you can pull images from Google Container Registry

  • User is already logged in the account in order to have access to cloud repositories:
    gcloud auth login

...

Use the following options to download the latest version of the WhiteSource Unified Mend Unified Agent JAR file and configuration file to your local host.

...

  1. Download CURL, and add it to your PATH environment variable.

  2. Open a new command prompt.

  3. Run the following commands:

    Windows Using CURL

    Code Block
    languagejava
    curl -LJO "https://github.com/whitesourceMend/unified-agent-distribution/releases/latest/download/wss-unified-agent.jar"
    curl -LJO "https://github.com/whitesourceMend/unified-agent-distribution/raw/master/standAlone/wss-unified-agent.config"

...

  1. Open a new command prompt.

  2. Run the following commands:

    Windows Using PowerShell

    Code Block
    languagejava
    powershell bitsadmin /transfer mydownload /dynamic /download /priority FOREGROUND https://github.com/whitesourceMend/unified-agent-distribution/releases/latest/download/wss-unified-agent.jar $pwd\wss-unified-agent.jar 
    powershell bitsadmin /transfer mydownload /dynamic /download /priority FOREGROUND https://github.com/whitesourceMend/unified-agent-distribution/raw/master/standAlone/wss-unified-agent.config $pwd\wss-unified-agent.config 

    NOTE: If you want to use PowerShell on Windows, ensure that Background Intelligent Transfer Service (BITS) is enabled.

...

Download the following files manually using your web browser or any other download manager:

...

Code Block
curl -LJO "https://github.com/whitesourceMend/unified-agent-distribution/releases/latest/download/wss-unified-agent.jar"
curl -LJO "https://github.com/whitesourceMend/unified-agent-distribution/raw/master/standAlone/wss-unified-agent.config"

...

Parameter

Input 

Default Value

Description

docker.gcr.enable 

true or false

false

Enable/Disable google container registry resolving.

docker.gcr.account

account mail

Empty String

Not mandatory. Specifies which account to set active and work on, cloud SDK can have multiple logged in accounts but may have only one active.
One account is always active by default. Otherwise, commands will not work.

docker.gcr.repositories

Host-Name/Project-Id

Empty List

A list of repositories separated by comma. If empty, it will use the default repository.

Example value:
gcr.io/whitesourceMend-main,gcr.io/whitesourceMend-johnsmith

Run the Unified Agent

Run the Unified Agent with the modified configuration file via this command:

Run FSA
Code Block
languagebash
java -jar wss-unified-agent.jar -apiKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx -c wss-unified-agent.config

...

The scanning results are presented in a new WhiteSource Mend project identified by the name of the image in the following format:  <image id> <repository> <tag>. The project is created in the WhiteSource Mend product specified in the configuration file or command line.

...