5.1 Configure Proxy Client Settings

If you have a proxy server in your network, you can optionally configure the PlateSpin Transformation Manager Appliance VM as a proxy client. You should also configure each PlateSpin Migrate Connector host in the network as a proxy client. As proxy clients, the appliance VM and Connector hosts will use your proxy server for HTTP and HTTPS communications over the Internet.

The Proxy client informs applications of the Proxy Server URL and credentials to use (if you specify them). It does not affect how the applications communicate with the server.

5.1.1 Configuring Proxy Client Settings for the PTM Appliance

You can enable the PlateSpin Transformation Manager Appliance to work with the Proxy Server in your environment. The PTM Server, PlateSpin Migrate Connector instance, PTM Web Interface, and Appliance Management Console running on the Appliance will use the proxy client settings you set for the Appliance VM.

To configure proxy client settings, log in to the Appliance VM through SSH, then use YaST to configure the Internet proxy client settings compatible with your proxy server.

To configure proxy client settings on the PTM Appliance VM:

  1. Enable the SSH protocol on the Appliance VM.

    SSH is disabled by default on the Appliance.

    1. In a web browser, log in to the Appliance Management Console as the vaadmin user.

      https://<ptm-ipaddr-or-dns-name>:9443

    2. Click System Services .

    3. Select the SSH service.

    4. Select Action > Start.

    5. Click Close to exit System Services.

    6. Log out of the Appliance Management Console, then close your web browser.

  2. Configure the Proxy client settings needed to access your Proxy Server:

    1. From your computer, start an SSH session for ptm-ipaddr-or-dns-name on port 22, then log in as the root user to the Appliance.

      You can use any SSH tool, such as Putty.

    2. At the terminal prompt, enter

      yast

    3. In YaST, navigate to Network Services, select Proxy, then press Enter.

    4. On the Proxy Configuration page, on Enable Proxy, press the Space bar to select the check box.

    5. Tab to navigate to the fields and configure the Proxy settings by using the information for your Proxy Server. Provide the URL for the Proxy Server for HTTP or HTTPS (or both) communications, depending on what protocols you enabled for the Appliance.

      HTTP Proxy URL: The URL (with host name and port number) of the Proxy Server used for non-secure access to the Internet. For example: http://proxy1.example.com:3126/

      HTTPS Proxy URL: The URL (with host name and port number) of the Proxy Server used for secure access to the Internet. For example: https://proxy2.example.com:3128/

      FTP Proxy URL: The URL (with host name and port number) of the Proxy Server used for access to the file transfer services (FTP). For example: https://ftp.proxy.example.com:2121/

      Use the Same Proxy for All Protocols: Enable this option and provide a single URL in HTTP Proxy URL that will be used as the Proxy Server for HTTP, HTTPS, and FTP communications.

      No Proxy Domains: Specify a comma-separated list of domains for which requests should be made directly without caching. The default is localhost.

      Proxy User Name and Proxy Password: Provide the credentials for your Proxy Server if it requires authorization.

    6. (Optional) Tab to Test Proxy Settings, then press Enter.

    7. Tab to OK, then press Enter to save and apply the settings.

    8. Tab to Quit, then press Enter to exit YaST.

    9. At the terminal prompt, enter exit to close the SSH session.

  3. (Optional) Disable the SSH protocol on the Appliance.

    1. In a web browser, log in to the Appliance Management Console as the vaadmin user.

      https://<ptm-ipaddr-or-dns-name>:9443

    2. Click System Services .

    3. Select the SSH service.

    4. Select Action > Stop.

    5. Click Close to exit System Services.

    6. Log out of the Appliance Management Console, then close your web browser.

5.1.2 Configuring Proxy Client Settings for Migrate Connector Hosts

You can enable the PlateSpin Migrate Connector host servers to work with the Proxy Server in your environment. The Connector instance will use the proxy client settings you set for the Connector host.

On SUSE Linux Enterprise Server (SLES) servers that host an instance of Migrate Connector, log in to the desktop and use YaST2 to configure the Internet proxy client settings compatible with your proxy server.

NOTE:YaST2 is a management tool for SUSE Linux Enterprise operating system. If your Connector host runs a different Linux operating system, use the OS management tool from your Linux vendor to apply the settings described in this procedure.

To configure proxy client settings on SLES servers that host a Migrate Connector instance:

  1. Log in as the root user to the desktop on the SLES server.

  2. Start the YaST Control Center from the main menu. Provide the root user password if you are prompted for it.

    To start the YaST Control Center from the command line, open a terminal, then enter yast2.

  3. Select Network Services, then select Proxy.

  4. Configure the Proxy settings by using the information for your Proxy Server. Provide the URL for the Proxy Server for HTTP and HTTPS communications.

    HTTP Proxy URL: The URL (with host name and port number) of the Proxy Server used for non-secure access to the Internet. For example: http://proxy1.example.com:3126/

    HTTPS Proxy URL: The URL (with host name and port number) of the Proxy Server used for secure access to the Internet. For example: https://proxy2.example.com:3128/

    FTP Proxy URL: The URL (with host name and port number) of the Proxy Server used for access to the file transfer services (FTP). For example: https://ftp.proxy3.example.com:2121/

    Use the Same Proxy for All Protocols: Enable this option and provide a single URL in HTTP Proxy URL that will be used as the Proxy Server for HTTP, HTTPS, and FTP communications.

    No Proxy Domains: Specify a comma-separated list of domains for which requests should be made directly without caching. The default is localhost.

    Proxy User Name and Proxy Password: Provide the credentials for your Proxy Server if it requires authorization.

  5. Click Test Proxy Settings.

  6. Click Finish to save and apply the settings.

  7. Exit YaST.

  8. Log out of the server.