Skip to content

Commit

Permalink
Merge pull request #38 from mattock/installwin32_release23
Browse files Browse the repository at this point in the history
Migrate INSTALL-win32.txt from OpenVPN "release/2.3" to openvpn-build
  • Loading branch information
mattock committed Oct 24, 2016
2 parents 0c10c1a + e6f71af commit 43a8d54
Show file tree
Hide file tree
Showing 2 changed files with 78 additions and 1 deletion.
77 changes: 77 additions & 0 deletions windows-nsis/INSTALL-win32.txt
@@ -0,0 +1,77 @@
UPGRADING FROM 2.3-ALPHA1 AND EARLIER

OpenVPN Windows installer went through major changes in
2.3-alpha2. To avoid any unexpected behavior, it is strongly
suggested to upgrade as follows.

First backup configuration files and certificates from your
current installation; by default they're in

C:\Program Files\OpenVPN\config (32-bit Windows)
C:\Program Files (x86)\OpenVPN\config (64-bit Windows)

After this, stop the openvpn-gui or the openvpn service
wrapper, if either of them is running and uninstall OpenVPN.
Finally, remove the OpenVPN install directory entirely (e.g.
using Windows Explorer as administrator).

Finally, install the new version of OpenVPN and copy over
your configuration files and certificates, which now go to

C:\Program Files\OpenVPN\config

provided you did not install the 32-bit version on 64-bit
Windows.

IMPORTANT NOTE FOR WINDOWS VISTA/7 USERS

Note that on Windows Vista, you will need to run the OpenVPN
GUI with administrator privileges, so that it can add routes
to the routing table that are pulled from the OpenVPN server.
You can do this by right-clicking on the OpenVPN GUI
desktop icon, and selecting "Run as administrator".

GENERAL QUICKSTART FOR WINDOWS

The OpenVPN Client requires a configuration file
and key/certificate files. You should obtain
these and save them to OpenVPN's configuration
directory, usually C:\Program Files\OpenVPN\config.

You can run OpenVPN as a Windows system service or by using
the client GUI. To use the OpenVPN GUI, double click on the
desktop icon or start menu icon. The OpenVPN GUI is a
system-tray applet, so an icon for the GUI will appear in
the lower-right corner of the screen. Right click on the
system tray icon, and a menu should appear showing the names
of your OpenVPN configuration files, and giving you the
option to connect.

BUILDING OPENVPN FOR WINDOWS

Official OpenVPN Windows releases are cross-compiled on Linux using the
openvpn-build buildsystem:

https://community.openvpn.net/openvpn/wiki/BuildingUsingGenericBuildsystem

First setup the build environment as shown in the above article. Then fetch the
openvpn-build repository:

git clone https://github.com/OpenVPN/openvpn-build.git

Review the build configuration:

openvpn-build/generic/build.vars
openvpn-build/windows-nsis/build-complete.vars

Build (unsigned):

cd openvpn-build/windows-nsis
./build-complete

Build (signed):

cd openvpn-build/windows-nsis
./build-complete --sign --sign-pkcs12=<pkcs12-file>\
--sign-pkcs12-pass=<pkcs12-file-password> \
--sign-timestamp="<timestamp-url>"
2 changes: 1 addition & 1 deletion windows-nsis/openvpn.nsi
Expand Up @@ -234,7 +234,7 @@ Section /o "${PACKAGE_NAME} User-Space Components" SecOpenVPNUserSpace
File "${OPENVPN_ROOT}\bin\openvpn.exe"

SetOutPath "$INSTDIR\doc"
File "${OPENVPN_ROOT}\share\doc\openvpn\INSTALL-win32.txt"
File "INSTALL-win32.txt"
File "${OPENVPN_ROOT}\share\doc\openvpn\openvpn.8.html"

${If} ${SectionIsSelected} ${SecAddShortcutsWorkaround}
Expand Down

0 comments on commit 43a8d54

Please sign in to comment.