Installing H@H on Debian

2018-08-24T18:38:10Z

EmuAGR:

==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.

* An “active” H@H client (https://e-hentai.org/hentaiathome.php).

===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 [https://www.oracle.com/technetwork/java/javase/downloads/index.html 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:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ 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"</pre>

Create directory for JVM in /opt:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># mkdir /opt/java-oracle</pre>

Unpack the downloaded archive in /opt:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># tar -zxf jre-7u67-linux-x64.tar.gz -C /opt/java-oracle</pre>

Set our JVM to be used as the default Java on the system:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ 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</pre>

Verify (or set) JVM to be used as a default Java on the system:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># 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.</pre>

Verify Java version:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ 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)</pre>

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://hentaiathome.net/get/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php 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:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ apt-get install screen</pre>
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:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ screen -r</pre>

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:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">'''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)
</pre>

To start your H@H client, follow these steps:
#Create a new window (Ctrl+A, then N)
#Start your H@H client in the window's command line
#Detach from the screen utility (Ctrl+A, then D)
#You can now close your SSH connection, the H@H client will keep running.

[[File: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:
#Start the scren utility (screen -r)
#Browse through your windows with Ctrl+A, then P (previous) or N (next) until you see your H@H client's command line
#Again, use Ctrl+A then D to detach once you're done
#You can close the SSH connection

==Run H@H as service==
[[File: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:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://github.com/Yukariin/hath-scripts/raw/master/hentaiathome -O hentaiathome</pre>

If you haven't created new user for H@H - edit presented script and replace USER and DIR variables to your correct:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ nano hentaiathome</pre>

Copy script into /etc/init.d:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># cp hentaiathome /etc/init.d/</pre>

Fix chmod:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># chmod 755 /etc/init.d/hentaiathome</pre>

Stop H@H if it already running and start is as a service:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># /etc/init.d/hentaiathome start</pre>

And check if it is working properly:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># /etc/init.d/hentaiathome status</pre>

Or by using top/htop. You can also see the server status on [https://e-hentai.org/hentaiathome.php your H@H page].

Now let's make H@H auto start:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># update-rc.d hentaiathome defaults</pre>

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 [https://github.com/Yukariin/hath-scripts/blob/master/systemd.service here]

==See also==
*[[Hentai@Home]]
*[[Installing H@H on Ubuntu]]
*[https://forums.e-hentai.org/index.php?showtopic=19795&st=0&p=797807&#entry797807 Advanced Linux Installation]

[[Category:E-Hentai Galleries]]

EHWiki - User contributions [en]

Installing H@H on Debian