Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Download and Install Updates in JATP Private Mode

 

Use the following information to download and apply software updates when using JATP in Private Mode.

JATP Private Mode Software Package Bundle

All of the software listed below is bundled together into a single package file to upload to the JATP Core.

  • JATP OS software—Includes the JATP software packages.

  • Security patches—Includes the security patches of the base open source software provided by Ubuntu community.

  • Third-party software—Includes the third-party open source software packages.

  • SSH Honeypot image

  • Sky ATP API engine image

Manually Upload Software Updates Using the UI

The manual installation of software updates is only available in Private Mode. When not in Private Mode, JATP updates occur automatically.

In Private Mode, you can use the JATP UI or the CLI to install an update.

Update using the JATP UI:

  1. Download the update files from the Juniper download portal, https://support.juniper.net/support/downloads/.
  2. In the UI, navigate to Config > System Profiles >ATP Private Mode Update and select Upload File to upload a file bundle or image file. A progress bar is shown when the upload begins. Note that if you close the file upload dialog box or close the browser tab, the file upload activity will be aborted.

    When the file upload is complete, the uploaded file is listed in the UI with information such as type, version and date of the upload (That is, if the version of the uploaded file is newer than the currently installed version).

    Figure 1: JATP Private Mode Navigate to Software Update
    JATP Private Mode Navigate to Software Update
    Figure 2: JATP Private Mode Upload Software Update
    JATP Private Mode Upload Software Update
  3. Once the upload is complete, you can manually begin the update by clicking the Upgrade link next to the uploaded file in the Config > System Profiles >ATP Private Mode Update window.

    You can also delete the uploaded file from the same window.

    Note

    It is recommended that you always create a fresh configuration backup after updating to a new software release.

Manually Upload Software Updates Using the CLI

Another method for updating JATP in Private Mode is to copy the update file to the JATP device from a staging server using the JATP CLI.

  1. Run the following command to allow the JATP device access to the staging server:

    # set firewall whitelist add IP_ADDRESS_OF_STAGING_SERVER

  2. Download the update files from Juniper download portal to a staging server, https://support.juniper.net/support/downloads/.
  3. Run the following command to copy the update files to the JATP device:

    set private-mode update copy FILE-URL

    For example, set private-mode update copy userabc@STAGING-SERVER-IP:FILE_PATH/jatp-update-5.2.tgz

    Note

    Note that only one update file can be uploaded at a time. The secure copy protocol (SCP) is used.

    File uploads are processed in the background. Using the show private-mode update copy command, you can view the completion percentage of the upload.

  4. Once the file upload completes, the update file preparation process starts and performs the following tasks:
    • Check and verify the completeness and the integrity of the file.

    • Check if the same update file already exists in the system. If so, remove the file.

    • Check if the uploaded file is an older version of the existing installed software or content. If so, remove the uploaded file.

    • Decompress the file and move it to the correct location.

    • Verify the version information for the software or content file.

    • Save the state related information in the database.

  5. Once the upload is complete (check status with the show private-mode update copy command), you can manually begin the update with the following example command:

    set private-mode update start software/content/win10/win7/osx VERSION

    Note

    The repository is not available for connected secondary devices (such as Web Collectors and Secondary Cores) to download until the JATP Core has finished the software upgrade process.

    Note

    It is recommended that you always create a fresh configuration backup after updating to a new software release.