Installing H@H on Debian

From EHWiki
Jump to: navigation, search


  • Being able to use Google.
  • Basic Linux knowledge.
  • A running Debian GNU/Linux server.
  • PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

A couple things to be aware of before starting

  • Linux IS case sensitive on file names. Therefore, it is best to use lower case names everywhere to make it easier for yourself.
  • Commands you should type are given in Green;
  • Output from the command prompt is given in Red;
  • Text in commands that you'll probably need to change is given in Blue.
  • Commands starting with $ are to be run as current user, those starting with # - as root (using su/sudo).
  • This manual is based on a virtual server (VPS/VDS). The use of a physical server, home PC or any program other than VMware to virtualize your server may require doing some things differently.

Installing Java

To run the H@H server you will have to have Java installed on the server.

Now select Java package on official download page, accept license and copy download link depending on your OS (32-bit/64-bit).

For our case JDK isn't needed. If you need some monitoring tools (and know how to use them) - pick Server JRE. Otherwise, your choice is JRE.

Download the JRE can be with the following command:

$ wget --no-cookies --header "Cookie: oraclelicense=accept-securebackup-cookie" ""

Create directory for JVM in /opt:

# mkdir /opt/java-oracle

Unpack the downloaded archive in /opt:

# tar -zxf jre-7u67-linux-x64.tar.gz -C /opt/java-oracle

Set our JVM to be used as the default Java on the system:

$ Java_Home=/opt/java-oracle/jre1.7.0_67
# update-alternatives --install /usr/bin/java java ${Java_Home%*/}/bin/java 20000
# update-alternatives --install /usr/bin/javac javac ${Java_Home%*/}/bin/javac 20000
# update-alternatives --install /usr/bin/javaws javaws ${Java_Home%*/}/bin/javaws 20000

Verify (or set) JVM to be used as a default Java on the system:

# update-alternatives --config java
There is only one alternative in link group java (providing /usr/bin/java): /opt/java-oracle/jre1.7.0_67/bin/java
Nothing to configure.

Verify Java version:

$ java -version
java version "1.7.0_67"
Java(TM) SE Runtime Environment (build 1.7.0_67-b01)
Java HotSpot(TM) 64-Bit Server VM (build 24.65-b04, mixed mode)

Installing H@H

For more security let's create new user for H@H:

# adduser hath

Now login as the new user and create a directory for H@H client:

# login hath
$ mkdir hath

Download H@H (check for the latest version here):

$ wget

Unzip the downloaded archive (install unzip if you haven't yet):

$ unzip -d hath/

Well done, let's launch it!

$ cd hath
$ java -jar HentaiAtHome.jar

You will be prompted for your client ID and Password which you can find on your H@H page

You will need to configure your client settings on the above page before you get your 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.

Controlling H@H with the screen utility

To make it very short and simple, the screen utility is a package available in many Linux distributions, that allows one to run commands in a dedicated environement. It is very useful when it comes to run a H@H client, as you can simply start your H@H client in a "screen" and leave it there to work, allowing you to perform other actions, like closing your SSH connection.

Installing the screen utility

First, download and install the package from the depository:

$ apt-get install screen

And that's all.

Using the screen utility to control your H@H client

First connect to your server using a SSH connection, as the user 'hath'. Then start the screen utility by entering the following command:

$ screen -r

You are now "inside" the screen utility, which looks and acts just like the command line. You can control the utility itself with the following key combinations:

Ctrl+A, then C - Create a new screen window
Ctrl+A, then N - Switch to next screen window
Ctrl+A, then P - Switch to previous screen window
Ctrl+A, then K - Kill the current screen window
Ctrl+A, then D - Detach from the screen utility (quit without closing)

To start your H@H client, follow these steps:

  1. Create a new window (Ctrl+A, then N)
  2. Start your H@H client in the window's command line
  3. Detach from the screen utility (Ctrl+A, then D)
  4. You can now close your SSH connection, the H@H client will keep running.

Point.png Always detach from the screen utility before closing your SSH connection. Otherwise, the screen utility and its windows will be killed, which means your H@H client will be shut down improperly.

You can control how your client is performing later on, by connecting to your server and perform the following actions:

  1. Start the scren utility (screen -r)
  2. Browse through your windows with Ctrl+A, then P (previous) or N (next) until you see your H@H client's command line
  3. Again, use Ctrl+A then D to detach once you're done
  4. You can close the SSH connection

Run H@H as service

Point.png This section was designed for an older version of H@H. The script used here is not reliable to run H@H 1.4.2 on Debian 7/8, due to being unable to start up/shut down H@H properly. Feel free to contact one of the wiki contributors if you've got an updated version.

Now, finally, we've got our H@H. But to start it manually every single time is quite a bother.

Here's the init script to make work with H@H more comfortable.

Download the script:

$ wget -O hentaiathome

If you haven't created new user for H@H - edit presented script and replace USER and DIR variables to your correct:

$ nano hentaiathome

Copy script into /etc/init.d:

# cp hentaiathome /etc/init.d/

Fix chmod:

# chmod 755 /etc/init.d/hentaiathome

Stop H@H if it already running and start is as a service:

# /etc/init.d/hentaiathome start

And check if it is working properly:

# /etc/init.d/hentaiathome status

Or by using top/htop. You can also see the server status on your H@H page.

Now let's make H@H auto start:

# update-rc.d hentaiathome defaults

So if your server will reboot, H@H will start automatically right after boot.

You can start/stop/restart H@H as a simple service.

Also you can get systemd service for H@H here

See also