Difference between revisions of "Hamachi"

From ArchWiki
Jump to: navigation, search
m (Configuration: Hamachi 2 is in beta)
m (= Installation: Fix heading.)
(26 intermediate revisions by 9 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.}}
 +
{{Out of date|initscripts and sysvinit are deprecated but this page isn't clear on what service info pertains to what}}
 
[[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 ==
 +
Best way to install hamachi2 is to download the .deb package from the official source and then installing it (with sudo dpkg -i pakcage.deb && apt-get install -f), hamachi settings are available via command line. Look at the bottom of the page for GUI.
 +
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].
  
To run Hamachi you need /dev/net/tun.
+
== Configuration ==
  
This is created by the tun module. As root run,
+
=== Set Up Tun ===
{{bc|
+
modprobe tun
+
}}
+
  
Or you can manually create /dev/net/tun by running...
+
Being as section above can only be applied for init.scripts, in order to install the module, as root run:
{{bc|
+
# modprobe tun
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.
+
Then add tun to the list of modules by using your favorite text editor and Create
 
+
{{hc|/etc/modules-load.d/tun.conf |
{{bc|1=
+
#Load tun module at boot.
MODULES=(... ... ... ... ... tun ... ... ...)
+
tun
 
}}
 
}}
  
==Download And Install Hamachi==
+
=== Hamachi 2 (beta) ===
===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
+
{{bc|
+
tar zxvf hamachi-x.x.x-x.tar.gz
+
}}
+
 
+
Compile:
+
{{bc|
+
cd hamachi-x.x.x-x
+
make install
+
}}
+
 
+
And run tunecfg
+
{{bc|
+
cd tuncfg
+
./tuncfg
+
}}
+
 
+
Run hamachi-init
+
{{bc|
+
$hamachi-init
+
}}
+
And thats the installation.
+
 
+
===Version 2 beta===
+
 
+
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.
+
 
+
==Configuration==
+
{{Note|The following section only applies to Hamachi version 2 (beta).}}
+
  
Configuration is done in {{ic|/var/lib/logmein-hamachi/h2-engine-override.cfg}} (create that file if it doesn't exist).
+
Hamachi 2 is configured in {{ic|/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.
 
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===
+
====Using the hamachi command line tool as a regular user====
 
In order to use the {{ic|hamachi}} command line tool as a regular user, add the following line to the configuration file:
 
In order to use the {{ic|hamachi}} command line tool as a regular user, add the following line to the configuration file:
 
{{bc|Ipc.User YourUserNameHere}}
 
{{bc|Ipc.User YourUserNameHere}}
  
===Automatically setting a custom nickname===
+
====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:
 
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}}
 
{{bc|Setup.AutoNick YourNicknameHere}}
Line 75: Line 42:
  
 
==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.  
+
 
 +
or, if you use systemd
 +
 +
{{bc|
 +
#systemctl start logmein-hamachi}}
 +
 
 +
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 90: Line 64:
 
}}
 
}}
  
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.
  
===As a Daemon===
+
===Systemd===
  
You can run hamachi as a daemon this way:
+
The {{AUR|logmein-hamachi}} AUR package also includes a nice little [[Systemd]] daemon.
  
Copy your configuration to ''/root'' directory:
+
If you feel like it, you can set Hamachi to start at every boot with Systemd:
  
{{bc|
+
{{Bc|
cp -R ~/.hamachi /root/
+
systemctl enable logmein-hamachi
}}
+
}}  
  
Create a script in ''/etc/rc.d/'' called ''hamachi'' using your preferred editor:
+
To start the Hamachi Daemon immediately, use this command:
  
{{bc|<nowiki>
+
{{Bc|
. /etc/rc.conf
+
systemctl start logmein-hamachi
. /etc/rc.d/functions
+
}}
  
DAEMON=/usr/bin/hamachi
+
{{Note|If for some reason, hamachi doesn't have a Systemd daemon, you can use [[Services#Logmein_Hamachi|one from here]].}}
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
+
</nowiki>}}
+
 
+
Remeber to add ''hamachi'' to your ''daemons'' array in ''/etc/rc.conf'', it should be put after ''tuntap''.
+
 
+
And do not forget to:
+
 
+
{{bc|
+
chmod +x /etc/rc.d/hamachi
+
}}
+
  
 
==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 169: Line 98:
 
*hamachi-gui (Gtk2)
 
*hamachi-gui (Gtk2)
  
For hamachi 2 beta:
+
For Hamachi 2 (beta):
  
 
*quamachi (Qt4)
 
*quamachi (Qt4)
Line 175: Line 104:
  
 
==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 182: Line 111:
 
}}
 
}}
  
===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 03:45, 21 June 2013

Tango-edit-clear.pngThis article or section needs language, wiki syntax or style improvements.Tango-edit-clear.png

Reason: Needs to be updated for Help:Style compliance. (Discuss in Talk:Hamachi#)

Tango-view-refresh-red.pngThis article or section is out of date.Tango-view-refresh-red.png

Reason: initscripts and sysvinit are deprecated but this page isn't clear on what service info pertains to what (Discuss in Talk:Hamachi#)
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

Best way to install hamachi2 is to download the .deb package from the official source and then installing it (with sudo dpkg -i pakcage.deb && apt-get install -f), hamachi settings are available via command line. Look at the bottom of the page for GUI. Version 2 of the Linux Hamachi client exists and is currently in beta. It is available from the labs page on the Hamachi website.

Configuration

Set Up Tun

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 Create

/etc/modules-load.d/tun.conf 
#Load tun module at boot.
tun

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

or, if you use systemd

#systemctl start logmein-hamachi

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-hamachiAUR 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
Note: If for some reason, hamachi doesn't have a Systemd daemon, you can use one from here.

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