User:Bipface
(draft)
Prerequisites
- Basic familiarity with Linux.
- A Linux server running Debian version 9 (Stretch) or newer, or Ubuntu version 16 (Xenial Xerus) or newer.
To use earlier versions you will need to determine how to install a Java 8 runtime, which may not be a straightforward process and is beyond the scope of this guide.
- Root access to your server (i.e.
su/sudo).
- 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).
- An open port through which H@H can accept connections from the internet.
You may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.
- This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.
A couple things to be aware of before starting
- Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.
- Commands starting with $ are to be run as current user, those starting with # as root.
- H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the ntp package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.
Installing Java - Using packages
Don't use Debian 8's repository for H@H 1.6.0 and above. The JRE provided in the packages for Debian 8 is Java 7, and H@H 1.6.0 needs Java 8 or above.
If you are running Debian 8, install Java by using a downloaded archive, like described in the next section.
To run the H@H server you will have to have Java installed on the server.
The best and easiest method is to use the Debian packages.
To do so, connect to your server, and run the following commands either as root, or by prefixing them by sudo (if you have the sudo package installed):
# apt-get update # apt-get install default-jre
And that's it, you're already done. Simple isn't it?
Installing Java - Using a downloaded archive
If you can't (or don't want to) use the method that uses the Debian packages, you can download and install your package on the Oracle website. Select your 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 https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip
Unzip the downloaded archive (install unzip if you haven't yet):
$ unzip HentaiAtHome_1.4.2.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.
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:
- 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.
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
