Importing Third-Party Software

Importing software adds it to your third-party software library, making if available to packages as you choose. Imported software is added to your delivery hub so you can make it available to your users from behind your firewall.

In this tutorial, you will learn how to:

  • Import from an Eclipse update site
  • Add non-Eclipse/binary files to your software library

Duration Time: 20 Minutes

Start Tutorial Now

Don't have SDC? Download Now

1. Import Third-Party Software from an Eclipse Update Site

  1. Click import_update_site_icon in the Available Extra Software section to open the Third Party Library page. Alternatively, click Third-Party Libraries under Software Collections in the Admin Console navigation.
  2. Click addIcon in the Libraries section, which lists all third-party libraries you have added as potential extra software for a package. To remove a library, select it, and click remove_icon.
  3. Select the Import Existing Eclipse Update Site library import mode, and click Next. If you have not set up your organization's signing certificate, you will see the following warning message. See Configuring Signing Certificates for more information. Click Next to continue.
    signing_certificate_warning
    Signing certificate warning
  4. Click addIcon, type the URL where the software libraries are located, and click OK. You can add multiple update sites to a library.
    add_software_site
    Adding the software URL and dependencies
    Note: Beginning in SDC 2017, if the selected update site has an expired SSL Certificate, a notification displays. Click OK to continue with the download or Cancel to abort.
    sslwarning3Expired SSL Certificate warning
  5. Select any dependencies required for the add-on. If you know you must access external sites through a proxy server, select the Use Proxy... checkbox. Click Next.

    Note: If you cannot access external sites except through a proxy server and you do not select the Use Proxy... checkbox, you receive the following page. Although the administrator is required to enter proxy server information when acquiring the software for a library, end users are not required to enter this information because software is exposed to them from the delivery hub inside your firewall.
    setup_network_for_proxy
    Network issue accessing external site
    You must provide your proxy server settings by clicking the Setup Network button so SDC can access the external third-party site. These settings are not saved and must be entered each time you attempt to access a third-party site.
    proxy_server_settings
    Entering proxy server settings
  6. Select one or more software tools and version to expose. By choosing the exact versions of software to import, you can have multiple versions, including older versions of software imported onto the hub machine. Select the Include All Other Software checkbox to import the full site(s) rather than just the dependencies of the software you selected to expose. Click Next.
    expose_software
    Selecting software to expose
  7. If other update sites are referenced by the site you entered, select these update sites, as well. Click Next.
    referenced_sites
    Referenced update sites
  8. Review the software license, select the checkbox if you accept the terms, and click Next.
  9. Enter a title for the add-on software and a version number. This can be your own versioning system, or it can match the software version number, which is filled in by default. Click Next.
    naming_software_addon
    Naming the software add-on
  10. Enter a library title and description on the Exposed Software Details tab.
  11. If you want the library to be available to be added to Secure Marketplace catalogs, select the Visible in Catalog checkbox. The actual visibility of a catalog is controlled by a package's security policy.
  12. To help identify the add-on software in the catalog, you can provide a 100x80 pixel image. Drag an image from your file explorer, or click searchIcon to locate the file. To remove the image file, click remove_icon.
    third_party_exposed_software_details
    Exposed software details

1.1 Including Multiple Libraries as a Single Catalog Entry

When you expose a third-party library that requires additional software to be installed, such as with Subversive, you can include the additional software as part of a single catalog entry so end users are not required to know to install the additional software separately. Additional software to be installed in conjunction with selected third-party software is added via the Also Include box of the software details.

In the example below, the Subversive library includes software from two update sites. You can select one to expose in the catalog, and then include additional software to be installed along with the one appearing in the catalog. In this way, you can have a single Subversive entry in the end-user catalog, and it will install all required software with a single installation.

third_party_also_include
Including additional software from the Subversive library to be installed along with SVN Team Provider

2. Import Non-Eclipse/Binary Files as Third-Party Software

Software that does not come from an update site can be added in your library for inclusion in packages. For example, you might have an archive file of application server software that you would like to include in packages. Use the binary contents import mode to add non-Eclipse-based software to your third-party library.

  1. Click import_update_site_icon in the Available Extra Software section to open the Third Party Library page. Alternatively, click Third-Party Libraries under Software Collections in the Admin Console navigation.
  2. Click addIcon in the Libraries section.
  3. Select the Package Binary Contents for Delivery library import mode, and click Next. If you have not set up your organization's signing certificate, you will see the following warning message. See Configuring Signing Certificates for more information. Click Next to continue.
    signing_certificate_warning
    Signing certificate warning
  4. Click addIcon, navigate to the file you want to include, specify the operating systems that apply to the file, and click Next. You can continue adding more files, if necessary.
    binary_library_import
    Importing binary file into the third-party library
  5. Enter a title and version, and click Next to import the file(s) into the library.