ConfigureForwardProxyELM < Deployment

Engineering Lifecycle Management Wiki - Deployment
Community information and contribution guidelines
TWiki > Deployment Web > DeploymentInstallingUpgradingAndMigrating > ConfigureForwardProxyELM
Revision 16 - 2021-03-25 - 14:11:56 - ShubjitNaik
<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%">
---+!! Configure Proxy Settings for Engineering Lifecycle Management Clients   
%DKGRAY% Authors: Main.ShubjitNaik, Main.BhagathPB, Main.ArtaChaudhury, Main.DineshKumar <br>
Build basis: Engineering Lifecycle Management 7.x
%ENDCOLOR%</div></sticky>

<!-- Page contents top of page on right hand side in box -->
<sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;">
%TOC{title="Page contents"}%
</div></sticky>

<sticky><div style="margin:15px;"></sticky>
<br>
There are instances where IBM ELM Applications are deployed on Secure zones and can only be accessed via a forward Proxy Server. For Web Clients the browser is configurable to connect via a Proxy server. Non-Web clients have different configurations to be able to connect to ELM applications via a Proxy server. <br><br>

This article focuses on configuring proxy settings for ELM Non-Web Clients.

---++ Engineering Workflow Management
---+++ Eclipse Client

Eclipse includes proxy settings under Network connections by default that can be configured.<br>

Startup the Engineering Workflow Management Eclipse Client and perform the following steps:
   * Click on Window > Preferences
   * Select the General > Network Connections category.
   * Change Active Provider to Manual, Select HTTPS and the Edit <br><br>
   <img src="https://jazz.net/wiki/pub/Deployment/ConfigureForwardProxyELM/eclipse_proxy.png" alt="eclipse_proxy.png" width="725" height="500" /> <br><br>

   * For password protected Proxy servers check the box "Requires Authentication" and enter the User and password <br>

---+++ Shell Client

For EWM Shell Clients to connect to an EWM server via a Forward Proxy server, Enable Microsoft Windows Proxy setup (Or Via Microsoft Internet Explorer)  <br>
   * On Microsoft Windows 10 Click Start > Settings > Network & Internet > Proxy and Click "Use a proxy server" and enter the details <br>
    <img src="https://jazz.net/wiki/pub/Deployment/ConfigureForwardProxyELM/proxy_shell.png" alt="proxy_shell.png" width="600" height="500" />
<br>
   * For password protected Proxy server use the format =[Username]:[Password]@[proxyhost]:[proxyPort]=

   * In case the client machine connects via VPN, you can change the HTTP Tunneling JVM property for the connection to work.
      * Edit =[EWM Shell Install Folder]\3rd Party\jre\lib\net.properties= and Change<br>
        From: *jdk.http.auth.tunneling.disabledSchemes=Basic* <br>
        To: *jdk.http.auth.tunneling.disabledSchemes=""* <br>

---+++ SCMTools 

For SCM or LSCM executables to connect to a EWM repo via proxy server perform the following

   * Microsoft Windows : Define System Environment Variables <br><br>
    <img src="https://jazz.net/wiki/pub/Deployment/ConfigureForwardProxyELM/proxy_env_variable.png" alt="proxy_env_variable.png" width="475" height="200" /> <br> <br>

   * OR Configure your Terminal / Command window to take advantage of a forward proxy by setting one of two environment variables prior to executing the command line. <br><br>
    *Microsoft Windows* 
     <verbatim>SET http_proxy=<proxy_host>:<proxy_Port>
SET https_proxy=<proxy_host>:<proxy_Port> </verbatim> 
    *Unix Based Systems*
      <verbatim>export http_proxy=<proxy_host>:<proxy_Port>
export https_proxy=<proxy_host>:<proxy_Port>  </verbatim>

<br>
For LSCM there is an alternate way is to configure these variables<br>

   * Microsoft Windows : Navigate to scm command line installation directory, search and edit lscm.bat file and add the proxy parameters after PRGPATH as shown below
      <verbatim>
@echo off
SET PRGPATH=%~dp0
SET http_proxy=<proxy_host>:<proxy_Port>
SET https_proxy=<proxy_host>:<proxy_Port>
....
</verbatim>

   * Unix based Systems : Navigate to scm command line installation directorym search and edit the lscm file and add the proxy parameters after PRGPATH, 
       <verbatim>
#!/bin/sh
PRGPATH="`dirname "$0"`"
export PRGPATH
export http_proxy=<proxyhost>:<proxyPort>
export https_proxy=<proxyhost>:<proxyPort>
...
</verbatim>

<br>
For Password protected Proxy servers the syntax is =https_proxy=[Username]:[Password]@[proxyhost]:[proxyPort]= <br>

---+++ Jazz Build Engine

For Jazz Build Engines we can use the JVM Arguments while running the command or include it in the jbe.ini file

   * Start the Jazz Build Engine with proxy arguments as shown below:
    <verbatim> ./jbe -repository <EWM Repository URL> -userId <User Id> -pass <Password> -engineId <Build Engine Id> -vmargs -Dhttps.proxyHost=<proxy_host> -Dhttps.proxyPort=<proxy_port> </verbatim>
   OR <br>
   * Edit the jbe.ini file located under [EWM_Build_Install_Path]\buildsystem\buildengine\eclipse
   <verbatim>
-Dhttps.proxyHost=<proxy_host>
-Dhttps.proxyPort=<proxy_port> </verbatim>

   * For Password protected Proxy servers add the following JVM variables <br>
   <verbatim>
-Dhttps.proxyUser=<Username>
-Dhttps.proxyPassword=<Password> </verbatim>

---++ Engineering Systems Design Rhapsody
---+++ Rhapsody Client
For Rhapsody Clients there are two key settings as there is a browser login as well while accessing ELM applications. <br>

*1. Edit Rhapsody.ini file and add data to the variable* =TakeProxyHostInfoFromFile= <br>

   * First make sure lscm.bat file is updated with the proxy details
      * Navigate to scm command line installation directory, search and edit lscm.bat file and add the proxy parameters after PRGPATH as shown below
      <verbatim>
@echo off
SET PRGPATH=%~dp0
SET http_proxy=<proxy_host>:<proxy_Port>
SET https_proxy=<proxy_host>:<proxy_Port>
....
</verbatim>

   * Then edit the Rhapsody.ini file =C:\ProgramData\IBM\Rhapsody\9.0.1x64\rhapsody.ini=
   * Update the !TakeProxyHostInfoFromFile value to
   <verbatim> TakeProxyHostInfoFromFile=[EWM_Install_Folder]\scmtools\eclipse\lscm.bat </verbatim>
   OR
   * If you have not updated lscm.bat file , edit the rhapsody.ini file and add the following 
   <verbatim>
[JVM]
Options=ClassPath,LibPath,MaxHeap,MaxStack,ProxyHost,ProxyPort
ProxyHost=-Dhttps.proxyHost=<proxy host>
ProxyPort=-Dhttps.proxyPort=<proxy port>   </verbatim>
<br>
*2. Enable Microsoft Windows Proxy setup (Or Via Microsoft Internet Explorer)* <br>
   * On Microsoft Windows 10 Click Start > Settings > Network & Internet > Proxy and Click "Use a proxy server" and enter the details <br>
    <img src="https://jazz.net/wiki/pub/Deployment/ConfigureForwardProxyELM/proxy_shell.png" alt="proxy_shell.png" width="600" height="500" />
<br>
   * For password protected Proxy server use the format =[Username]:[Password]@[proxyhost]:[proxyPort]=
<br>
---++ Engineering Test Management
---+++ Microsoft Excel/Word to ETM Import Utility

For Microsoft Excel and Word Import utilities to connect to an ETM server via a Forward Proxy server, Enable Microsoft Windows Proxy setup (Or Via Microsoft Internet Explorer)  <br>

   * On Microsoft Windows 10 Click Start > Settings > Network & Internet > Proxy and Click "Use a proxy server" and enter the details <br>
    <img src="https://jazz.net/wiki/pub/Deployment/ConfigureForwardProxyELM/proxy_shell.png" alt="proxy_shell.png" width="600" height="500" />
<br>
   * For password protected Proxy server use the format =[Username]:[Password]@[proxyhost]:[proxyPort]=

---++ Rational Publishing Engine

Note: =Forward Proxy configurations on a Rational Publishing Engine Client works from Client version 7.x onwards= <br>

For Rational Publishing Engine Clients, we have to enable a few JVM Arguments in =rpe-studio.ini= file.

   *  Edit the file =[RPE_INSTALL_DIR]\studio\rpe-studio.ini=
   * Add the following parameters
   <verbatim>
-Dcom.ibm.rational.rrdg.enableProxyConnectionCheck=true
-Dhttps.proxyHost=<proxy_host>
-Dhttps.proxyPort=<proxy_port> </verbatim>

   * For Password protected Proxy servers add the following JVM variables <br>
   <verbatim>
-Dhttps.proxyUser=<Username>
-Dhttps.proxyPassword=<Password> </verbatim>
<br>
---+++++!! Related topics: [[DeploymentWebHome][Deployment web home]]

---+++++!! External links:          

   * [[https://www.ibm.com][IBM]]

<sticky></div></sticky>
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our Terms of Use. Please read the following disclaimer.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.