Difference between revisions of "Hamachi"

Revision as of 09:37, 13 June 2012 (view source) Kynikos.bot (talk | contribs) (Template:i18n is deprecated, use intelanguage links, see Help talk:I18n#"Dummy" interlanguage links and deprecation of Template:i18n) ← Older edit		Revision as of 04:27, 28 January 2013 (view source) Iruel (talk | contribs) (→‎Systemd) Newer edit →
(16 intermediate revisions by 6 users not shown)
Line 1:		Line 1:
		+	[[it:Hamachi]]
		+
	[[Category:Virtual Private Network]]		[[Category:Virtual Private Network]]
		+	{{Poor writing|Needs to be updated for [[Help:Style]] compliance.}}
	[[Wikipedia:Hamachi (software)|Hamachi]] is a proprietary (closed source) commercial VPN software. With Hamachi you can organize two or more computers with an Internet connection into their own virtual network for direct secure communication.		[[Wikipedia:Hamachi (software)|Hamachi]] is a proprietary (closed source) commercial VPN software. With Hamachi you can organize two or more computers with an Internet connection into their own virtual network for direct secure communication.
−	==Initial Configuration==	+	== Installation ==
		+	Version 2 of the Linux Hamachi client exists and is currently in beta.  It is available from [https://secure.logmein.com/US/labs/ the labs page on the Hamachi website]; however, the vendor's tarball requires LSB and will not install correctly. You should use the {{AUR|logmein-hamachi}} package from the [[AUR]] instead.
−	To run Hamachi you need /dev/net/tun.	+	==Configuration==
		+	=== Set up tun ===
−	This is created by the tun module. As root run,	+	To run Hamachi you need /dev/net/tun.
		+
		+	This is created by the tun module. As root, run:
	{{bc|		{{bc|
	modprobe tun		modprobe tun
	}}		}}
−	Or you can manually create /dev/net/tun by running...	+	Or you can manually create /dev/net/tun by running:
	{{bc|		{{bc|
	mkdir /dev/net		mkdir /dev/net
Line 23:		Line 30:
	}}		}}
−	==Download And Install Hamachi==
−	===Manual installation===
−	{{accuracy|reason=Why use make install and skip package management?}}
−	Head to [http://files.hamachi.cc/linux/ hamachi.cc] and download their linux client.
−	Untar it	+	=== Set Up Tun For Systemd ===
		+
		+	Being as section above can only be applied for init.scripts, in order to install the module, as root run:
		+
	{{bc|		{{bc|
−	tar zxvf hamachi-x.x.x-x.tar.gz	+	modprobe tun
	}}		}}
−	Compile:	+	Then add tun to the list of modules by using your favorite text editor and running
−	{{bc|	+	{{bc|# vi /etc/modules-load.d/tun.conf |
−	cd hamachi-x.x.x-x	+	#Load tun module at boot.
−	make install	+	tun
	}}		}}
−	And run tunecfg	+	=== Hamachi 2 (beta) ===
−	{{bc|	+
−	cd tuncfg	+	Hamachi 2 is configured in {{ic|/var/lib/logmein-hamachi/h2-engine-override.cfg}} (create that file if it doesn't exist).
−	./tuncfg	+	Unfortunately, it isn't easy to find a comprehensive list of possible configuration options, so here are a few that you can use.
−	}}
−	Run hamachi-init	+	====Using the hamachi command line tool as a regular user====
−	{{bc|	+	In order to use the {{ic|hamachi}} command line tool as a regular user, add the following line to the configuration file:
−	$hamachi-init	+	{{bc|Ipc.User YourUserNameHere}}
−	}}
−	And thats the installation.
−	===Version 2 beta===	+	====Automatically setting a custom nickname====
		+	Normally, Hamachi uses your system's hostname as the nickname that other Hamachi users will see. If you want to automatically set a custom nickname every time Hamachi starts, add the following line to the configuration file:
		+	{{bc|Setup.AutoNick YourNicknameHere}}
−	Version 2 of the Linux Hamachi client exists, and is currently in beta.  It is available from [https://secure.logmein.com/US/labs/ the labs page on the hamachi website].	+	You can also manually set a nickname using the {{ic|hamachi}} command line tool:
		+	{{bc|# hamachi set-nick YourNicknameHere}}
−	{{aur|hamachi}} is available in the [[AUR]]. The vendor's tarball requires LSB and will not install correctly.	+	However, this needs to be done every time Hamachi is (re-)started, so if you always want to use the same nickname, setting it automatically (as explained above) is probably easier.
	==Running Hamachi==		==Running Hamachi==
		+
	Start up the (matt) daemon		Start up the (matt) daemon
	{{bc|		{{bc|
	$hamachi start		$hamachi start
	}}		}}
−	Now you have a whole bunch of commands at your disposal. These are in no particular order, and are fairly self explanitory.	+	Now you have a whole bunch of commands at your disposal. These are in no particular order and are fairly self explanatory.
	{{bc|		{{bc|
Line 73:		Line 80:
	}}		}}
−	To get a list of all the commands just run:	+	To get a list of all the commands, run:
	{{bc|		{{bc|
	$hamachi ?		$hamachi ?
	}}		}}
−	'''Note:''' Make sure you change the status of the channel(s) you are in to online if you want to perform any network actions on computers in there.	+	'''Note:''' Make sure you change the status of the channel(s) you are in to "online" if you want to perform any network actions on computers in there.
		+
		+	===Systemd===
		+
		+	The {{AUR|logmein-hamachi}} AUR package also includes a nice little [[Systemd]] daemon.
		+
		+	If you feel like it, you can set Hamachi to start at every boot with Systemd:
		+
		+	{{Bc|
		+	systemctl enable logmein-hamachi
		+	}}
		+
		+	To start the Hamachi Daemon immediately, use this command:
		+
		+	{{Bc|
		+	systemctl start logmein-hamachi
		+	}}
		+
		+	{{Note|If for some reason, hamachi doesn't have a Systemd daemon, you can use [[Services#Logmein_Hamachi|one from here]].}}
		+
		+	===init.scripts (depreciated)===
−	===As a Daemon===	+	{{Note|If you run a newer Arch system, use the Systemd method above. This section below can only be applied for init.scripts.}}
−	You can run hamachi as a daemon this way:	+	You can run Hamachi as a daemon this way:
	Copy your configuration to ''/root'' directory:		Copy your configuration to ''/root'' directory:
Line 135:		Line 162:
	</nowiki>}}		</nowiki>}}
−	Remeber to add ''hamachi'' to your ''daemons'' array in ''/etc/rc.conf'', it should be put after ''tuntap''.	+	Remember to add ''hamachi'' to your ''daemons'' array in ''/etc/rc.conf'', it should be put after ''tuntap''.
	And do not forget to:		And do not forget to:
Line 144:		Line 171:
	==GUI==		==GUI==
−	Various GUI frontends to hamachi are available in the AUR.	+	Various GUI frontends for Hamachi are available in the AUR.
−	For hamachi 1:	+	For Hamachi 1:
	*haguichi (Gtk2, mono)		*haguichi (Gtk2, mono)
Line 152:		Line 179:
	*hamachi-gui (Gtk2)		*hamachi-gui (Gtk2)
−	For hamachi 2 beta:	+	For Hamachi 2 (beta):
	*quamachi (Qt4)		*quamachi (Qt4)
Line 158:		Line 185:
	==Troubleshooting==		==Troubleshooting==
−	===If Hamachi times out soon after launch===	+	===Hamachi times out soon after launch===
	If hamachi stops working after a short period of time it can be that the client is timing out. Create ~/.hamachi/config and add the following to it:		If hamachi stops working after a short period of time it can be that the client is timing out. Create ~/.hamachi/config and add the following to it:
Line 165:		Line 192:
	}}		}}
−	===If you have problem connecting to some hosts===	+	===If you have problems connecting to some hosts===
−	Check if they are using Hamachi2, if that is the case then it is a known issue in Hamachi2 client connecting to the Hamachi linux client.	+	Check if they are using Hamachi 2. If that is the case, then it is a known issue with the Hamachi 2 client connecting to the Hamachi Linux client.
−	===If ''/etc/init.d/logmein-hamachi'' is not found===	+	===''/etc/init.d/logmein-hamachi'' is not found===
−	Replace this with ''/etc/rc.d/logmein-hamachi''.	+	Replace that path with ''/etc/rc.d/logmein-hamachi''.
	===Error when trying to run hamachi-init===		===Error when trying to run hamachi-init===
−	If there is error while trying to load libstdc++.so.5 you want to install it can be found from extra repository so you can install it with Pacman -S libstdc++5	+	If there is an error while trying to load libstdc++.so.5, you want to install it. This library can be found in the ''extra'' repository, so you can install it by running {{ic|pacman -S libstdc++5}}.
−	If you get error while trying to load libcrypto.so.0.9.7 temporarily solution is to create link from /usr/lib/libcrypto.so.0.9.7 to /usr/lib/libcrypto.so with ln -s /usr/lib/libcrypto.so /usr/lib/libcrypto.so.0.9.7	+	If you get an error while trying to load libcrypto.so.0.9.7, a temporary solution is to create a link from /usr/lib/libcrypto.so.0.9.7 to /usr/lib/libcrypto.so by running {{ic|ln -s /usr/lib/libcrypto.so /usr/lib/libcrypto.so.0.9.7}}.
−	===See also===	+	==See also==
	* [https://secure.logmein.com/products/hamachi/ Project home page]		* [https://secure.logmein.com/products/hamachi/ Project home page]

---

Revision as of 04:27, 28 January 2013

Hamachi is a proprietary (closed source) commercial VPN software. With Hamachi you can organize two or more computers with an Internet connection into their own virtual network for direct secure communication.

Installation

Version 2 of the Linux Hamachi client exists and is currently in beta. It is available from the labs page on the Hamachi website; however, the vendor's tarball requires LSB and will not install correctly. You should use the logmein-hamachi^AUR package from the AUR instead.

Configuration

Set up tun

To run Hamachi you need /dev/net/tun.

This is created by the tun module. As root, run:

modprobe tun

Or you can manually create /dev/net/tun by running:

mkdir /dev/net
mknod /dev/net/tun c 10 200

Also, make sure to add the "tun" modules to rc.conf so that /dev/net/tun is created next time your computer turns on.

MODULES=(... ... ... ... ... tun ... ... ...)

Set Up Tun For Systemd

Being as section above can only be applied for init.scripts, in order to install the module, as root run:

modprobe tun

Then add tun to the list of modules by using your favorite text editor and running

# vi /etc/modules-load.d/tun.conf 

Hamachi 2 (beta)

Hamachi 2 is configured in /var/lib/logmein-hamachi/h2-engine-override.cfg (create that file if it doesn't exist). Unfortunately, it isn't easy to find a comprehensive list of possible configuration options, so here are a few that you can use.

Using the hamachi command line tool as a regular user

In order to use the hamachi command line tool as a regular user, add the following line to the configuration file:

Ipc.User YourUserNameHere

Automatically setting a custom nickname

Normally, Hamachi uses your system's hostname as the nickname that other Hamachi users will see. If you want to automatically set a custom nickname every time Hamachi starts, add the following line to the configuration file:

Setup.AutoNick YourNicknameHere

You can also manually set a nickname using the hamachi command line tool:

# hamachi set-nick YourNicknameHere

However, this needs to be done every time Hamachi is (re-)started, so if you always want to use the same nickname, setting it automatically (as explained above) is probably easier.

Running Hamachi

Start up the (matt) daemon

$hamachi start

Now you have a whole bunch of commands at your disposal. These are in no particular order and are fairly self explanatory.

$hamachi set-nick bob
$hamachi login
$hamachi create my-net secretpassword
$hamachi go-online my-net
$hamachi list
$hamachi go-offline my-net

To get a list of all the commands, run:

$hamachi ?

Note: Make sure you change the status of the channel(s) you are in to "online" if you want to perform any network actions on computers in there.

Systemd

The logmein-hamachi^AUR AUR package also includes a nice little Systemd daemon.

If you feel like it, you can set Hamachi to start at every boot with Systemd:

systemctl enable logmein-hamachi

To start the Hamachi Daemon immediately, use this command:

systemctl start logmein-hamachi

init.scripts (depreciated)

You can run Hamachi as a daemon this way:

Copy your configuration to /root directory:

cp -R ~/.hamachi /root/

Create a script in /etc/rc.d/ called hamachi using your preferred editor:

. /etc/rc.conf
. /etc/rc.d/functions

DAEMON=/usr/bin/hamachi
NAME=hamachi
DESC="Hamachi VPN client"
PID_FILE=/var/run/daemons/hamachi

case "$1" in
    start)
        #Check for running tuntap, start when not running
        ck_daemon tuntap && /etc/rc.d/tuntap start
        stat_busy "Starting $DESC"
        $DAEMON -c /root/.hamachi $1 > /dev/null
        if [ $? -gt 0 ]; then
            stat_fail
        else
            add_daemon $NAME
            stat_done
        fi
        ;;
    stop)
        stat_busy "Stopping $DESC"
        [ -f $PID_FILE ] && $DAEMON -c /root/.hamachi $1 > /dev/null
        if [ $? -gt 0 ]; then
            stat_fail
        else
            rm_daemon $NAME
            stat_done
        fi
        ;;
    restart)
        $0 stop
        $0 start
        ;;
    *)
        echo "usage: $0 {start|stop|restart}"
	;;
esac
exit 0

Remember to add hamachi to your daemons array in /etc/rc.conf, it should be put after tuntap.

And do not forget to:

chmod +x /etc/rc.d/hamachi

GUI

Various GUI frontends for Hamachi are available in the AUR.

For Hamachi 1:

• haguichi (Gtk2, mono)
• ghamachi (Gtk2)
• hamachi-gui (Gtk2)

For Hamachi 2 (beta):

• quamachi (Qt4)
• haguichi (Gtk2, mono)

Troubleshooting

Hamachi times out soon after launch

If hamachi stops working after a short period of time it can be that the client is timing out. Create ~/.hamachi/config and add the following to it:

KeepAlive 10

If you have problems connecting to some hosts

Check if they are using Hamachi 2. If that is the case, then it is a known issue with the Hamachi 2 client connecting to the Hamachi Linux client.

/etc/init.d/logmein-hamachi is not found

Replace that path with /etc/rc.d/logmein-hamachi.

Error when trying to run hamachi-init

If there is an error while trying to load libstdc++.so.5, you want to install it. This library can be found in the extra repository, so you can install it by running pacman -S libstdc++5.

If you get an error while trying to load libcrypto.so.0.9.7, a temporary solution is to create a link from /usr/lib/libcrypto.so.0.9.7 to /usr/lib/libcrypto.so by running ln -s /usr/lib/libcrypto.so /usr/lib/libcrypto.so.0.9.7.

See also

• Project home page