www/vpnc-script.xml

   1 <PAGE>
   2         <VAR match="VAR_ORIGIN" replace="" />
   3         <VAR match="VAR_CVSID" replace=""/>
   4         <INCLUDE file="inc/header.tmpl" />
   5
   6         <VAR match="VAR_SEL_STARTED" replace="selected" />
   7         <VAR match="VAR_SEL_VPNCSCRIPT" replace="selected" />
   8         <PARSE file="menu1.xml" />
   9         <PARSE file="menu2-started.xml" />
  10
  11         <INCLUDE file="inc/content.tmpl" />
  12
  13 <h1>Install a <tt>vpnc-script</tt>.</h1>
  14
  15 <p>OpenConnect just handles the communication with the VPN server; it does
  16 not know how to configure the network routing and name service on all the
  17 various operating systems that it runs on.</p>
  18
  19 <p>To set the routing and name service up, it uses an external script
  20 which is usually called <tt>vpnc-script</tt>. It's exactly the same script that
  21 <a href="http://www.unix-ag.uni-kl.de/~massar/vpnc/">vpnc</a> uses.
  22 You may already have a <tt>vpnc-script</tt> installed on your system,
  23 perhaps in a location such as <tt>/etc/vpnc/vpnc-script</tt>.</p>
  24
  25 <p>If you don't already have it, you can get a current version from <a
  26 href="http://git.infradead.org/users/dwmw2/vpnc-scripts.git/blob_plain/HEAD:/vpnc-script">here</a>.
  27 Even if you already have a copy from vpnc, you may wish to install this updated
  28 version which has support for IPv6, and for running on Solaris and on newer Linux
  29 kernels amongst other bug fixes.</p>
  30
  31 <p>Note that the script needs to be executable, and stored somewhere
  32 where SELinux or similar security systems won't prevent the root user
  33 from accessing it.</p>
  34
  35 <p>Current versions of OpenConnect <i>(since version 3.17)</i> are configured
  36 with the location of the script at build time, and will use the script
  37 automatically. If you are using a packaged build of OpenConnect rather than
  38 building it yourself, then the OpenConnect package should have a dependency
  39 on a suitable version of <tt>vpnc-script</tt> and should be built to look in
  40 the right place for it. Hopefully your distributions gets that right.</p>
  41
  42 <p>If you're using an older version of OpenConnect, or if you want to use
  43 a script other than the one that OpenConnect was configured to use, you
  44 can use the <tt>--script</tt> argument on the command line. For example:
  45  <ul><li><tt>openconnect --script /etc/vpnc/vpnc-script https://vpn.example.com/</tt></li></ul></p>
  46
  47 <p>If OpenConnect is invoked without a suitable script, it will not be able
  48 to configure the routing or name service for the VPN.</p>
  49
  50         <INCLUDE file="inc/footer.tmpl" />
  51 </PAGE>
  52