How To - Edit the OpenVPN TextEdit box, quickstart

[GoogleCodeExporter]

More of a "this I know".

To use the Installer like its intended.

(for Leopard)

1. download the dmg image by going to http://code.google.com/p/tunnelblick 
and clicking on [ Featured Downloads: ] Tunnelblick_3.0b9.dmg

2. the disk image (dmg) will download and automount then open the mounted 
image in your finder

3. in the same finder window, drag and drop the Tunnelblick icon into your 
Applications folder, you will be prompted for the system password 

4. click on the Applications folder in the finder window to switch your 
view to the Applications folder and double click the Tunnelblick icon you 
copied there

5. you'll get a warning about starting an app downloaded from the Internet 
[ Continue ]

6. you'll get a warning [ Welcome to OpenVPN on Mac OS X: Please put your 
config file (e.g. openvpn.conf) into 'Library/openvpn/'. ] click [ 
Continue ]

7. you'll get a padlock with the Tunnelblick icon [Tunnelblick requires 
that you type your password. ] Name: Password: enter and click [Ok]

8. you may get a question about auto checking for updates

9. you may get TextEdit opening up a blank window (the exact behavior 
seems to depend if you have ever had a version of openVPN or tunnelblick 
installed on this system and if it retains some of the previous 
preferences) on a fresh system it should open the TextEdit window

A. the important thing to recognize is the TextEdit window is in RTF mode 
and not plain text mode, it will automatically append a hidden .rtf 
extension to any file you save with it unless you change the mode before 
saving. You cannot use 'Save As..' to override the extension, you must 
change the TextEdit mode before saving

B. go to the Apple menu bar and click on TextEdit: -> Format, and 
select 'Make Plain Text'.. the fonts and other RTF options tool bar, 
should disappear in the edit window

C. Type or Cut 'n Paste a sample openVPN client configuration, like this:

NOTE! This example works for me on a Windows system and probably needs 
further modifications to work on a Mac.. this is only to give you some 
ideas and demonstrate how to use the installer to get openVPN Tunnelblick 
to start recognizing the client config file

# ---- john willis
client
dev tun
proto tcp

# Change my.publicdomain.com to your public domain or IP address
remote 165.xx.xx.xx 1194  # where the IP and port is that of the server

resolv-retry infinite
nobind
persist-key
persist-tun

route-method exe
route-delay 2

ca ca.crt
cert client1.crt
key client1.key

ns-cert-type server

#DNS Options here, CHANGE THESE !!
push "dhcp-options DNS 172.24.1.1"
push "dhcp-options DNS 172.24.1.12":

comp-lzo

verb 3

D. TextEdit: -> Save As

E. navigate to the [Macintosh]->[Users]->[jwillis]->[Library]->[openvpn] 
folder

F. change the name from [Untitled.txt] to [openvpn.conf] and uncheck the 
box [x] If no extension is provided, use ".txt" then click Save

G. TextEdit: -> Quit TextEdit

H. Tunnelblick should be happy and running in the toolbar and waiting for 
your command

I. Click on the Tunnelblick icon in the upper right of the Apple menu bar.

J. It should say [ OpenVPN: 0 connections active ] [ Connect 'openvpn' ] [ 
Details... ] [ Quit ]

K. Click on [ Connect 'openvpn' ]

L. Tunneblick requires that you type your password (system password)

M. If you want to look at the status of the link, click on the Tunnelblick 
icon again and select [ Details... ] a window should open and indicate the 
status of the connection.

In my case since I haven't uploaded a certificate yet to my Mac so it says:

Cannot load certificate file client1.crt: No such file or directory

- hope this helps a little, I'll update this when I get it completely 
working but its a bit late on a Saturday night

Original issue reported on code.google.com by goop...@gmail.com on 26 Oct 2008 at 11:48

[GoogleCodeExporter]

.. oh yeah, from that [ Details... ] or log window is an [ Edit Configuration ] 
button, it 'will' open the config in a TextEdit window that 'is' in plain text 
mode

Original comment by goop...@gmail.com on 26 Oct 2008 at 11:54

[GoogleCodeExporter]

Ok.. I copied my client1.crt and client1.key into 
/users/jwillis/Library/openvpn 
directory and 'Connect'ed by clicking on the Tunnelblick icon and selecting 
connect.

First time was a little shaky and it immediately said Connected and then a few 
second later disconnected automatically.. I was watching the 'Details..' window.

But I selected 'Connect' again and its been stable ever since.

It could have been the load on the vpn server, since there are some other 
services 
running in lifesupport mode on the gateway as well.

"No" modifications to the windows openvpn.conf file were needed.

And if you noticed I'm running a private DNS named on the openvpn gateway that 
serves only the private subnet. That works. When connected the Mac can resolve 
private IP space numbers to names, when disconnected it cannot.

One other thing, everyone probably already knows this about openvpn, but my 
business 
runs an IPSec based service at the border. So I have that client fired up.

This is running happily (the openvpn SSL based service) over that.

Original comment by goop...@gmail.com on 27 Oct 2008 at 12:26

[GoogleCodeExporter]

Original comment by angelol...@gmail.com on 19 Nov 2008 at 3:09

• Changed state: Fixed