Installing H@H on Debian

From EHWiki
Jump to: navigation, search

Requirements

  • 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" "https://download.oracle.com/otn-pub/java/jdk/7u80-b15/jdk-7u80-linux-x64.tar.gz"

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 http://hentaiathome.net/get/HentaiAtHome_1.2.1.zip

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

$ unzip HentaiAtHome_1.2.1.zip -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.

Run H@H as service

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 https://github.com/Yukariin/hath-scripts/raw/master/hentaiathome -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