4.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.

4.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 network 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.

4.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.

To configure proxy client settings on Migrate Connector host server:

  1. Log in as the root user to the desktop on the Migrate Connector host 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.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.

  5. Click Test Proxy Settings.

  6. Click Finish to save and apply the settings.

  7. Exit YaST.

  8. Log out of the server.