(r3) SquidProxyJazzSCMWindows < Deployment

Engineering Lifecycle Management Wiki - Deployment
Community information and contribution guidelines
~~EditAttach~~Printable
TWiki > Deployment Web > DeploymentInstallingUpgradingAndMigrating > InstallProxyServers > SquidProxyJazzSCMWindows
Revision 3 - 2017-01-11 - 15:28:24 - 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%">
---+!! Setting up Squid content caching proxy for Jazz Source Control on Microsoft Windows platform <img src="https://jazz.net/wiki/pub/Deployment/WebPreferences/todo.png" alt="todo.png" width="50" height="50" align="right"> 
%DKGRAY% Authors: Main.HirotakaMatsumoto, Main.ShubjitNaik, Main.MadanKumar <br>
Build basis: Rational Team Concert 5.x,6.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>

This is a supplemental document to our article [[ContentCachingProxyJazzSCM][Using content caching proxies for Jazz Source Control]] (includes additional information on using a content caching Proxy for Rational Team Concert). This document focuses and includes configuration details of  Squid Caching Proxy Server on Microsoft Windows Environment.

---++ Setting up Squid on Microsoft Windows with HTTPS as Accelerator Proxy

Squid can compile and run on Windows as a system service using the [[https://www.cygwin.com][Cygwin]] emulation environment, or can be compiled in Windows native mode using the !MinGW + MSYS development environment. Windows NT 4 SP4 and later are supported. In this document we use [[https://www.cygwin.com][Cygwin]].

---+++ Pre-requisites
   * Squid Installer - You can download Windows installer from [[http://wiki.squid-cache.org/KnowledgeBase/Windows][squid-cache wiki]]. Download the supported version for specific version of RTC as per System Requirement. For RTC v6.0.3 the minimum supported version of Squid is 3.3.3. 
   * Cygwin - This article includes steps to download and install Cygwin
   * OpenSSL and CURL - openssl is necessary to generate a certificate for SSL communication. CURL we have used to to verify squid installation. Both can be installed through Cygwin. Instructions included in this article

---+++ Installation
---++++ Squid
   * Download *squid.msi* from [[http://wiki.squid-cache.org/KnowledgeBase/Windows][squid-cache wiki]] (version 3.5), here is the direct [[http://squid.diladele.com/][link]]
   * Select *squid.msi*, open its context menu and select “Install”
   * The install option you need to decide is the install location. The default is C:\Squid and it is suggested to use this default location.
   * Squid is installed as Windows Service, and you can start/stop it from the toolbar’s squid’s icon tray %BR%
   <img src="%ATTACHURLPATH%/Squid_Start_Stop.png" alt="Squid_Start_Stop.png" width="250" height="275" /> %BR%
   * If squid’s icon tray isn’t in the toolbar, you can start it by Services control panel or “net” command.
      * Services: You can start/stop squid service from Services control panel. Please see below.%BR%
      <img src="%ATTACHURLPATH%/Squid_Service.png" alt="Squid_Service.png" width="500" height="250" /> %BR%
      * Command line : You can start/stop squid service by the commands below<verbatim>*Start: net start squidsrv
Stop: net stop squidsrv*</verbatim>
   * Just after the installation is done, squid should be automatically started. Let’s stop it now by squid’s icon tray or Windows Services or net command.

---++++ Cygwin !OpenSSL and CURL
   * Download the installer from [[https://www.cygwin.com][Cygwin]]. You can download “setup-x86.exe” for 32-bit installation ( direct [[https://www.cygwin.com/setup-x86.exe][link]] ) or “setup-x86_64.exe” for 64-bit installation (direct [[https://www.cygwin.com/setup-x86_64.exe][link]] )
   * Select “Install from internet” in the “Choose Installation Type” panel %BR%
      <img src="%ATTACHURLPATH%/Cygwin_install_type.png" alt="Cygwin_install_type.png" width="500" height="400" /> %BR%

   * You could use the Default location in the “Choose Installation Directory” panel%BR%
      <img src="%ATTACHURLPATH%/Cygwin_install_dir.png" alt="Cygwin_install_dir.png" width="500" height="400" /> %BR%

   * Specify the directory where setup will store the installation files in “Select Local Package Directory” panel. You could leave it at default as well.%BR%
      <img src="%ATTACHURLPATH%/Cygwin_pkg_dir.png" alt="Cygwin_pkg_dir.png" width="500" height="400" /> %BR%

   * Select your preferred network connection in “Select Connection Type” panel. If you can access Internet directly, “Direct Connection” should be okay. Or if you need to use Proxy, you can select either IE Proxy settings or you can specify your own proxy.%BR%
      <img src="%ATTACHURLPATH%/Cygwin_connection_type.png" alt="Cygwin_connection_type.png" width="500" height="400" /> %BR%

   * Specify the nearest download site in “Choose Download Site(s)” panel. In the example below, =ftp://ftp.jaist.ac.jp= is selected. If your network can’t access ftp, then you can try http ( for example, =http://ftp.jaist.ac.jp= )%BR%
      <img src="%ATTACHURLPATH%/Cygwin_download_site.png" alt="Cygwin_download_site.png" width="500" height="400" /> %BR%

   * After some of the files are downloaded, you will see the “Select Packages” panel%BR%
      <img src="%ATTACHURLPATH%/Cygwin_select_pkgs.png" alt="Cygwin_select_pkgs.png" width="500" height="400" /> %BR%

   * Type *openssl* in *Search* and expand *Base* category, so you will see something like%BR%
      <img src="%ATTACHURLPATH%/Cygwin_openssl1.png" alt="Cygwin_openssl1.png" width="550" height="250" /> %BR%
   * If both has a check mark under *Bin?* column in the above image , openssl will be installed. However, if you instead see *n/a* like in the image below, then you need to click on =Skip= icon so that you would see check boxes under *Bin?*  %BR%
      <img src="%ATTACHURLPATH%/Cygwin_openssl2.png" alt="Cygwin_openssl2.png" width="400" height="350" /> %BR%
   * Type *curl* in *Search* and expand *Net* category and perform the same steps as followed for *openssl* above%BR%
      <img src="%ATTACHURLPATH%/Cygwin_curl1.png" alt="Cygwin_curl1.png" width="500" height="300" /> %BR% %BR%
      * You can add other packages as you like (But for this Proxy, openssl and curl are enough)
   * Click “Next” and the download starts. Once it is completed, click “Finish”.
   * Add a path to Cygwin’s bin directory to your PATH environment variable.

---+++ Configuration of squid

Majority of the Squid configuration is in *squid.conf* file. Here are some of the pre-requisites to plan followed by a sample squid.conf.

   * Port number: You need to decide the proxy’s port number. It is recommended to use the same port number of RTC on WAS. If there is an IBM HTTP Server in place or if you want to use the different port number, please follow this [[https://www-01.ibm.com/support/docview.wss?rs=3488&uid=swg21405179][technote]
   * Directories for Certificate, Cache and Coredump files. Three directories are necessary, for example:
      * Certificate: C:\Squid\certs
      * Cache: C:\Squid\cachedir (Note: The size of cache files will be huge, so you need to plan it well)
      * Coredump: C:\Squid\coredump
   * SSL Certificates for Squid: The certificate is needed since this Proxy uses SSL to connect to both RTC SCM client and server. Here is an instruction

---+++ Heading 2 (use sentence-style capitalization)

Sub-Section text Sub-Section text  Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text

---++ Heading 1

---+++++!! Related topics: [[DeploymentWebHome][Deployment web home]], [[DeploymentWebHome][Deployment web home]]

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

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

---+++++!! Additional contributors: Main.TWikiUser, Main.TWikiUser

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