Installing H@H on Debian

From EHWiki
Revision as of 02:08, 17 August 2014 by LostLogia4 (talk | contribs) (Updated to latest Java and H@H version.)
Jump to navigationJump to 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: gpw_e24=http%3A%2F%2Fwww.oracle.com%2F" "https://download.oracle.com/otn-pub/java/jdk/7u67-b01/jre-7u67-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

Retrieved from "https://ehwiki.org/index.php?title=Installing_H@H_on_Debian&oldid=30476"