IBM Support

Configuring a Proxy Server for IBM Support Assistant Team Server

Product Documentation


Abstract

This document provides instructions for configuring a proxy server in IBM® Support Assistant Team Server.

Content

IBM Support Assistant Team Server communicates with remote servers for actions such as tool installs and updates. When necessary, you can configure IBM Support Assistant Team Server to communicate through a proxy server.

This document contains the directions for configuring IBM Support Assistant Team Server to work with a proxy server after installation. To configure a proxy server for installing IBM Support Assistant Team Server, see the blog titled How to Install & Configure a Proxy Server in IBM Support Assistant Team Server.

Proxy server properties:
A proxy server configuration is specified via standard Java system properties. Java system properties can be configured in the isa.properties file with the values shown in the table below.

To change the proxy configuration used by the IBM Support Assistant Team Server:

  1. Create a file named isa.properties in the home directory of the user account used to start IBM Support Assistant Team Server. You may copy the isa.properties file from the root of the IBM Support Assistant Team Server installation instead of creating a new file.
  2. Open this isa.properties file with a text editor and define the desired proxy server properties from the table below with the value to use for the property.
  3. Close and save the file.
  4. Restart IBM Support Assistant Team Server.

Property
Default Value
Description
opt.socksProxyHostno default valueThe hostname or IP address of the SOCKS proxy server
opt.socksProxyPort1080The port number of the SOCKS proxy server
opt.java.net.socks.usernameno default valueSOCKS username (See *Note.)
opt.java.net.socks.passwordno default valueSOCKS password (See *Note.)



opt.http.proxyHostno default valueThe hostname or IP address of the proxy server used for HTTP communication
opt.http.proxyPort80The port number of the proxy server used for HTTP communication
opt.http.proxyUserno default valueProxy UserID (See *Note.)
opt.http.proxyPasswordno default valueProxy password (See *Note.)



opt.https.proxyHostno default valueThe hostname or IP address of the proxy server used for secure HTTPS communication. If this property is not defined and access to an HTTPS resource is performed, then IBM Support Assistant Team Server will fall back to the HTTP proxy server defined by the opt.http.proxyHost property.
opt.https.proxyPort443The port number of the proxy server used for secure HTTPS communication

*Note that the isa.properties file is not encrypted, so property values are stored as plain text. Make sure that isa.properties is secured and not accessible by anyone other than you.

As an example, the isa.properties file might contain the following:
    # Customized isa.properties file to override default values
    # for the IBM Support Assistant Team Server application

    opt.http.proxyHost=myproxy.mycompany.com
    opt.http.proxyPort=1080
    opt.http.proxyUser=username
    opt.http.proxyPassword=password
    opt.https.proxyHost=mysecureproxy.mycompany.com
    opt.https.proxyPort=1443

Original Publication Date

02 October 2014

[{"Product":{"code":"SSLLVC","label":"IBM Support Assistant"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Security","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"5.0.1;5.0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
17 June 2018

UID

swg27040572

Page Feedback