LRM Proxy Configuration

LRM Proxy Configuration

To use LRM through a proxy, you will need to set java proxy settings before executing the LRM jar file. To set java proxy settings, configure the shell to have a '_JAVA_OPTIONS' variable with the proxy settings listed. Like so:

export _JAVA_OPTIONS="-Dhttp.proxyHost=some.url.here -Dhttp.proxyPort=3128 -Dhttps.proxyHost=some.url.here -Dhttps.proxyPort=3128 -Dftp.proxyHost=some.url.here -Dftp.proxyPort=3128"

This may be added to the following locations:

Jenkins Config

• This will affect LRM when run through Jenkins.
• In Jenkins, select 'Manage Jenkins' then 'Configure System'.
• Under 'Global properties' ensure that 'Environment variables' is checked.
• At the bottom of the Environment variables section, there will be a button 'Add' to add new environment variables.
• Name: _JAVA_OPTIONS
• Value: -Dhttp.proxyHost=some.url.here -Dhttp.proxyPort=3128 -Dhttps.proxyHost=some.url.here -Dhttps.proxyPort=3128 -Dftp.proxyHost=some.url.here -Dftp.proxyPort=3128
  • Replace 3128 with the port number appropriate for your proxy.

User Config

• This will affect LRM commands run at the command prompt for a specific user. It will also affect other java programs run at the command prompt by this user. May not affect commands run within Jenkins builds.
• Edit $HOME/.bashrc
  • $ vim $HOME/.bashrc
• Add the following line somewhere in the file
  • export _JAVA_OPTIONS="-Dhttp.proxyHost=some.url.here -Dhttp.proxyPort=3128 -Dhttps.proxyHost=some.url.here -Dhttps.proxyPort=3128 -Dftp.proxyHost=some.url.here -Dftp.proxyPort=3128"

System Config

• This will affect all users on the system. All java commands run at the command prompt will use the configured proxy settings. May not affect commands run within Jenkins builds.
• Create a file /etc/profile.d/custom.sh
  • sudo vim /etc/profile.d/custom.sh
• Add the following line to the file and save it:
  • export _JAVA_OPTIONS="-Dhttp.proxyHost=some.url.here -Dhttp.proxyPort=3128 -Dhttps.proxyHost=some.url.here -Dhttps.proxyPort=3128 -Dftp.proxyHost=some.url.here -Dftp.proxyPort=3128"

Notes on the JAVA_OPTIONS setting

• The url should not include the preceeding 'http://' or 'www'
  • Good
    • internet.proxy.yourcompany.com
  • Bad
    • http://internet.proxy.yourcompany.com
    • www.internet.proxy.yourcompany.com
    • https://www.internet.proxy.yourcompany.com
• The port number will be dependent on your proxy. 3128 is merely used as an example above.