Difference between revisions of "Hamachi"
Kynikos.bot (talk | contribs) (Template:i18n is deprecated, use intelanguage links, see Help talk:I18n#"Dummy" interlanguage links and deprecation of Template:i18n) |
(→Systemd) |
||
(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. | ||
− | == | + | == 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. | ||
− | + | ==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: | ||
}} | }} | ||
− | |||
− | |||
− | |||
− | |||
− | + | === 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| | ||
− | + | modprobe tun | |
}} | }} | ||
− | + | 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 | |
− | + | #Load tun module at boot. | |
− | + | tun | |
}} | }} | ||
− | + | === Hamachi 2 (beta) === | |
− | {{ | + | |
− | + | 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. |
− | }} | ||
− | + | ====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: |
− | + | {{bc|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: | ||
+ | {{bc|Setup.AutoNick YourNicknameHere}} | ||
− | + | You can also manually set a nickname using the {{ic|hamachi}} command line tool: | |
+ | {{bc|# 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== | ==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 | + | 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 | + | 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)=== | ||
− | + | {{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 | + | 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>}} | ||
− | + | 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 | + | Various GUI frontends for Hamachi are available in the AUR. |
− | For | + | For Hamachi 1: |
*haguichi (Gtk2, mono) | *haguichi (Gtk2, mono) | ||
Line 152: | Line 179: | ||
*hamachi-gui (Gtk2) | *hamachi-gui (Gtk2) | ||
− | For | + | For Hamachi 2 (beta): |
*quamachi (Qt4) | *quamachi (Qt4) | ||
Line 158: | Line 185: | ||
==Troubleshooting== | ==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: | 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 | + | ===If you have problems connecting to some hosts=== |
− | Check if they are using | + | 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 | + | 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 | + | 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 | + | 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== | |
* [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
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-hamachiAUR 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-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
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
.