release/src/router/openvpn/INSTALL-win32.txt

   1 UPGRADING FROM 2.3-ALPHA1 AND EARLIER
   2
   3 OpenVPN Windows installer went through major changes in
   4 2.3-alpha2. To avoid any unexpected behavior, it is strongly
   5 suggested to upgrade as follows.
   6
   7 First backup configuration files and certificates from your
   8 current installation; by default they're in
   9
  10     C:\Program Files\OpenVPN\config (32-bit Windows)
  11     C:\Program Files (x86)\OpenVPN\config (64-bit Windows)
  12
  13 After this, stop the openvpn-gui or the openvpn service
  14 wrapper, if either of them is running and uninstall OpenVPN.
  15 Finally, remove the OpenVPN install directory entirely (e.g.
  16 using Windows Explorer as administrator).
  17
  18 Finally, install the new version of OpenVPN and copy over
  19 your configuration files and certificates, which now go to
  20
  21     C:\Program Files\OpenVPN\config
  22
  23 provided you did not install the 32-bit version on 64-bit
  24 Windows.
  25
  26 IMPORTANT NOTE FOR WINDOWS VISTA/7 USERS
  27
  28 Note that on Windows Vista, you will need to run the OpenVPN
  29 GUI with administrator privileges, so that it can add routes
  30 to the routing table that are pulled from the OpenVPN server.
  31 You can do this by right-clicking on the OpenVPN GUI
  32 desktop icon, and selecting "Run as administrator".
  33
  34 GENERAL QUICKSTART FOR WINDOWS
  35
  36 The OpenVPN Client requires a configuration file
  37 and key/certificate files. You should obtain
  38 these and save them to OpenVPN's configuration
  39 directory, usually C:\Program Files\OpenVPN\config.
  40
  41 You can run OpenVPN as a Windows system service or by using
  42 the client GUI. To use the OpenVPN GUI, double click on the
  43 desktop icon or start menu icon. The OpenVPN GUI is a
  44 system-tray applet, so an icon for the GUI will appear in
  45 the lower-right corner of the screen. Right click on the
  46 system tray icon, and a menu should appear showing the names
  47 of your OpenVPN configuration files, and giving you the
  48 option to connect.
  49
  50 BUILDING OPENVPN FOR WINDOWS
  51
  52 Official OpenVPN Windows releases are cross-compiled on Linux using the
  53 openvpn-build buildsystem:
  54
  55     https://community.openvpn.net/openvpn/wiki/BuildingUsingGenericBuildsystem
  56
  57 First setup the build environment as shown in the above article. Then fetch the
  58 openvpn-build repository:
  59
  60     git clone https://github.com/OpenVPN/openvpn-build.git
  61
  62 Review the build configuration:
  63
  64     openvpn-build/generic/build.vars
  65     openvpn-build/windows-nsis/build-complete.vars
  66
  67 Build (unsigned):
  68
  69     cd openvpn-build/windows-nsis
  70     ./build-complete
  71
  72 Build (signed):
  73
  74     cd openvpn-build/windows-nsis
  75     ./build-complete --sign --sign-pkcs12=<pkcs12-file>\
  76     --sign-pkcs12-pass=<pkcs12-file-password> \
  77     --sign-timestamp="<timestamp-url>"