Installing H@H on Ubuntu
This page will tell you how to set up a Hentai@Home client using a Linux Ubuntu Server
Before you start reading at all, to use this guide you should be “above average” interested in computers, having a little more than “standard” equipment is recommended! (Meaning this guide is for advanced users)
- Being able to search Google.
- Basic Linux knowledge is recommended.
- A running Linux server (I used version 12.04) (for setting one up refer to: https://www.howtoforge.com/perfect-server-ubuntu-12.04-lts-apache2-bind-dovecot-ispconfig-3 page 1 and 2)
- It is recommended to use PuTTY or any other SSH program to connect to your server, this allows the copying/pasting of commands to the server.
- You have an “active” H@H client (https://e-hentai.org/hentaiathome.php) if not you will have to request this first.
A couple things to be aware of before starting:
- Linux IS case sensitive on file names. Therefore, best thing is to create everything with lower case names to make it easier for yourself.
- Commands you should type is given in Green, output from the command prompt is given in Red. Text in commands that is marked in Blue is part of a command that typically you would have to change.
- This manual was developed based on a virtual server. The use of a physical server or another program than VMware to virtualize your server may require doing some things differently.
Configuring the Network
First thing you would want to do with your server is setting a static IP address. Use this command
sudo nano /etc/network/interfaces
The file that is opened should look something like this:
This file describes the network interfaces available on your system # and how to activate them. For more information, see interfaces(5). # The loopback network interface auto lo iface lo inet loopback # The primary network interface auto eth0 iface eth0 inet dhcp
Below where it says “# The primary network interface”
Type in this information:
auto eth0 iface eth0 inet static address 192.168.0.100 netmask 255.255.255.0 gateway 192.168.0.1 dns-nameservers 192.168.0.1
Change the IP addresses with what is relevant for your network.
When you have made the changes to the file press “ctrl+o” and press enter to save changes. Then press “ctrl+x” to exit the text editor.
When you have exited the file, type this command to restart the network interface and activate the new configuration.
sudo /etc/init.d/networking restart
You can check and see if your IP has changed by typing:
You should see something like this:
eth0 Link encap:Ethernet HWaddr 00:00:00:00:00:00 inet addr:192.168.0.100 Bcast:192.168.0.255 Mask:255.255.255.0 inet6 addr: ffff::fff:ffff:ffff:ffff/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:0 errors:0 dropped:0 overruns:0 frame:0 TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:0 RX bytes:0 (0.0 MB) TX bytes:0 (0.0 GB)
The second line is what is important.
You can test and see if the network is working by pinging an internet server:
If this returns an error try pinging:
If this last one works and not the first, there is a problem with your DNS settings (refer to “dns-nameservers” that was typed in when you configured the network, this setting is typically the same as you gateway).
If none of them work there is no connection to internet. If this is the case you can try pinging your inside router(gateway) to check if you have network connection at all, if not check the IP you set for your server, make sure it's not in use by another computer and make sure you server is physically connected to the network.
That’s it for setting up the network.
P.S: Important thing to do when you have confirmed network connection on your server, run these commands to update you server with latest security patches.
sudo apt-get update sudo apt-get upgrade
Installing Java (Pick 6 or 7)
apt-get OpenJDK Installation
OpenJDK is a free and open source implementation of Sun's Java SE Platform. It is also the default Java software package included in Ubuntu Package archive.
It allows you to install Java through the usual apt-get command, and is the easiest way to install Java on your Ubuntu machine. This will install OpenJDK 6 on Ubuntu 12.04 and earlier and OpenJDK 7 on 12.10+.
Despite earlier reports, the latest H@H client works perfectly with OpenJDK.
First, update the package index:
sudo apt-get update
Then, check if Java has already been installed:
If it returns "The program java can be found in the following packages", Java hasn't been installed yet, so execute the following command:
sudo apt-get install default-jre
This will install the Java Runtime Environment (JRE). Finally, check if Java has been installed correctly:
If properly installed, the expected output is:
java version "1.7.0_65" OpenJDK Runtime Environment (IcedTea 2.5.3) (7u71-2.5.3-0ubuntu0.14.04.1) OpenJDK 64-Bit Server VM (build 24.65-b04, mixed mode)
Oracle Java 6 Installation
(old source: http://www.devsniper.com/ubuntu-12-04-install-sun-jdk-6-7/ rewritten by Melkeku and Fyxie)
To run the H@H server you will have to have java installed on the server.
As far as I was told on the forums and as I installed you have to use Sun's(/Oracle's) Java. It will not work with other versions.
First download the JDK can be with the following command. (Official download is here https://www.oracle.com/technetwork/java/javase/downloads/index.html)
wget --no-cookies --header "Cookie: gpw_e24=http%3A%2F%2Fwww.oracle.com%2F" "https://download.oracle.com/otn-pub/java/jdk/6u32-b05/jdk-6u32-linux-x64.bin"
Extract the (bin) file:
If you type «ls» you should now see 2 files:
Now move the extracted file:
sudo mv jdk1.6.0_32 /usr/lib/jvm/
Now type in these commands to “install” Java (as 3 separate commands)
sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/jdk1.6.0_32/bin/javac 1 sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk1.6.0_32/bin/java 1 sudo update-alternatives --install /usr/bin/javaws javaws /usr/lib/jvm/jdk1.6.0_32/bin/javaws 1
Now tell the server that this java installation is the default one (as 3 separate commands):
sudo update-alternatives --config javac sudo update-alternatives --config java sudo update-alternatives --config javaws
To verify the installation is complete type:
You should see this message:
java version "1.6.0_32" Java(TM) SE Runtime Environment (build 1.6.0_32-b05) Java HotSpot(TM) 64-Bit Server VM (build 20.7-b02, mixed mode)
Oracle Java 7 Installation
Note that 7 is said to have issues with the graphical client. 7 Should be fine for a headless machine.
Download and exract files (Official download is here https://www.oracle.com/technetwork/java/javase/downloads/index.html)
wget --no-cookies --header "Cookie: gpw_e24=http%3A%2F%2Fwww.oracle.com%2F" "https://download.oracle.com/otn-pub/java/jdk/7u9-b05/jdk-7u9-linux-x64.tar.gz" tar xvfo jdk-7u9-linux-x64.tar.gz
Move java files into their place
mkdir /usr/lib/jvm mv jdk1.7.0_09 /usr/lib/jvm/jdk1.7.0_09
Set alternatives links
update-alternatives --install "/usr/bin/java" "java" "/usr/lib/jvm/jdk1.7.0_09/bin/java" 1 update-alternatives --install "/usr/bin/javac" "javac" "/usr/lib/jvm/jdk1.7.0_09/bin/javac" 1 update-alternatives --install "/usr/bin/javaws" "javaws" "/usr/lib/jvm/jdk1.7.0_09/bin/javaws" 1
Config alternatives links
update-alternatives --config java update-alternatives --config javac update-alternatives --config javaws
Verify java version
java version "1.7.0_09" Java(TM) SE Runtime Environment (build 1.7.0_09-b05) Java HotSpot(TM) 64-Bit Server VM (build 23.5-b02, mixed mode)
Download H@H (check the newest version in here)
To download H@H first make a new directory for where you want to run the files from:
sudo mkdir /home/”username”/hath cd /home/”username”/hath
This creates a folder called “hath” in your home directory and moves you to it. Now download the H@H program by typing:
sudo wget repo.e-hentai.org/hath/HentaiAtHome_1.6.1.zip
This might take time depending on your network speed.
When finished downloading you will have to install “unzip” to unzip the file. Type:
sudo apt-get install unzip
Now unzip the file by typing:
sudo unzip HentaiAtHome_1.6.1.zip
If you type «ls» you should see all the files extracted from the zip file.
Now, if everything went as planned before you can type:
java -jar HentaiAtHome.jar
And the server should start up.
You will be prompted for your client ID and Password which you can find on your H@H page: https://e-hentai.org/hentaiathome.php
You will need to configure the server settings on the above page before you get you client password. If you have not applied to run a H@H client yet you will have to do so first.
To stop the server, press "Ctrl+C" and wait for a couple seconds.
If you restart the server or for some reason are not in the folder where the H@H program is located you can also start it by typing
sudo java -jar /home/"username"/hath/HentaiAtHome.jar
If you want to start the server in the background so that you can access the console or close the console without closing the server together, use "nohup" and append a "&" at the end of the command:
nohup java -jar /home/"username"/hath/HentaiAtHome.jar &
nohup java -jar HentaiAtHome.jar &
when you are inside the directory where H@H client is located.
If you want to close the background process, use the following command to identify the process ID (PID):
ps aux | grep -i hentai
Result similar to the following will be returned:
user@host:~# ps aux | grep -i hentai user xxxx 0.4 7.0 1366476 71976 ? Sl Jan15 39:09 java -jar HentaiAtHome.jar user yyyy 0.0 0.0 11744 932 pts/2 S+ 16:35 0:00 grep --color=auto -i hentai
where xxxx is the PID of the HentaiAtHome.jar. Execute the following command to kill the process:
sudo kill xxxx
If you are having trouble when downloading updates or when installing the unzip program, if the command prompt is stuck saying ”[waiting for headers]” please refer to this page (it's a common/known problem): https://askubuntu.com/questions/37753/how-can-i-get-apt-to-use-a-mirror-close-to-me-or-choose-a-faster-mirror
As always check the H@H technical issues first!
For problems after starting the H@H program that are not explained in the FAQ make a forum post here.
For problems related to putty, Ubuntu or Java please use a search engine.