Installing H@H on Debian

2014-02-18T14:46:39Z

Yukarin: /* Install Java */

Installing H@H on Debian

2014-02-18T14:29:37Z

Yukarin: Created page with " ==Requirements== *Being able to search Google. *Basic Linux knowledge is recommended. *A running Debian GNU/Linux server with configured network and base system. *It is re..."

Hentai@Home

2014-02-18T10:59:51Z

Yukarin: /* Installation Guides */

Hentai@Home (H@H) is a Peer-2-Peer gallery distribution system which reduces the load of the [[E-Hentai Galleries]].

==General Information==
H@H is a project that can be compared to a cross between the [http://setiathome.ssl.berkeley.edu/ SETI@home] project and [http://en.wikipedia.org/wiki/BitTorrent_(protocol) BitTorrent].

All participating members run a small Java-based client that downloads files from the main E-Hentai server to their computer and passes the files on to people who browse E-Hentai.org and the [[E-Hentai User Galleries]]. This allows E-Hentai to serve many more files without using vast amounts of costly bandwidth.

The client may be run freely for any duration of time but it is recommended to run it continuously for as long as possible for maximum [[#Rewards|rewards]].

==Signing Up==
[[Image:H@H Application.png|thumb|The Application screen.]]
===Requirements===
(See the [http://forums.e-hentai.org/index.php?showtopic=19795 H@H FAQ topic]).

*[http://www.oracle.com/technetwork/java/javase/downloads/jre7-downloads-1880261.html Java 7 Runtime Environment] (the [http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html Java 7 SDK] is also usable). There is one known issue that can be avoided by using Java 6 but it doesn't affect most users[http://forums.e-hentai.org/index.php?s=&showtopic=97152&view=findpost&p=2265428].
*3 Mbit/s burst upload speed or higher. Users may make limits on how much bandwidth is used per hour if they have a bandwidth cap (100 MB/hour minimum). This requirement varies from region to region.
*2 GB of hard drive space or higher.
*[http://portforward.com/ An open port] (TCP only).
*An additional IP address for each additional client (must be IPv4).

===Obtaining Client Keys===
Users who are signing up for their first client simply go to the [[My_Home#Hentai.40Home | Hentai@Home page]] in their [[My Home]] area. A flash interface will appear where one may fill in their qualifications. Once submitted, simply wait a few days for approval.

To sign up for any additional clients, please [http://forums.e-hentai.org/index.php?act=Msg&CODE=4&MID=6 PM Tenboro]. For users wishing to run more than five clients the average quality of their existing clients must be stable above 7,500 before more keys can be assigned.

<div id="Installation"></div>
==Installation Guides==
*[http://forums.e-hentai.org/index.php?showtopic=19795 Windows]
*[http://forums.e-hentai.org/index.php?showtopic=100453 FreeBSD with Jails]
*[http://forums.e-hentai.org/index.php?s=&showtopic=19795&view=findpost&p=797807 Linux]
**[[Installing H@H on Ubuntu|Ubuntu]]
**[[Installing H@H on Debian|Debian]]
**[http://forums.e-hentai.org/index.php?showtopic=69880 Debian on Raspberry Pi]
**[http://forums.e-hentai.org/index.php?showtopic=69887 Solaris]
*[http://forums.e-hentai.org/index.php?showtopic=97809 Rented Server]
*[http://forums.e-hentai.org/index.php?showtopic=132751 Python Client]

==Limits==
*Ports that can be used for H@H: 80 or any port between 1024-65534
**Exceptions: 2049, 3659, 4045, 6000, 6665-6669

A client's maximum burst speed will determine:
*The maximum number of connections that can be had simultaneously (up to 500).
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">'''Maximum Connections''' = 20 + max_burst_speed / 10000</pre>

*The maximum disk cache size (in GBs).
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">'''Cache Size''' = max_burst_speed / 10</pre>

===Speed Test===
When the H@H client starts, it contacts one of the H@H main servers which tests the Internet connection of the client in order to check if it can upload data at the configured maximum burst speed. If it cannot the maximum burst speed is reduced internally to the measured upload speed in order to prevent the connection from being overloaded.

It is possible for the measured upload speed to be significantly lower than real upload speed of the Internet connection, especially if that connection isn't located on the European continent (where the H@H main servers are located). In such a case the H@H client will be underused and its owner can request a speed test override from [http://forums.e-hentai.org/index.php?act=Msg&CODE=4&MID=6 Tenboro] by sending him proof that the Internet connection the H@H client runs on can upload at a higher speed than the measured speed (e.g. a screenshot of their [http://speedtest.net SpeedTest]'s results).

==Scheduler==
Each client can be scheduled to use less than its maximum burst speed and bandwidth. These can be based on particular days but are limited to using precise times (every hour on the hour).

==Software==
A few command line switches may be given to the H@H application in order to change some of its behaviors:
:--disable_bwm
::Disables the bandwidth monitor which is the part that makes sure the H@H application does not use more upload speed than the value of the "Maximum Burst Speed" parameter. When the bandwidth monitor is disabled, the H@H dispatcher will still respect the "Maximum Burst Speed" parameter so that the mean upload speed of the H@H application won't exceed the value of that parameter. However, the H@H application might use as much upload speed as the Internet connection on which it runs can provide in order to send image files, which generally results in upload peaks.
::In some cases, the bandwidth monitor is unable to use the whole maximum upload speed that has been set, which can result in an under-utilization of the H@H application upload speed (and might trigger false overload notifications). In such cases, it is better to disable the bandwidth monitor in order for the H@H application to give better performances.
:--disable_logging
::Disables the writing of log entries in the ''log_out'' file. Enabling this switch might increase the performance of the application by reducing its I/O usage.
:--force_dirty
::Forces a check of the database for errors (as if the database was dirty).
:--max_connections=''conn''
::Sets the maximum number of connections the application can handle to ''conn''. The default maximum number of connections depends on the max burst speed parameter, and is computed as detailed above. In some rare circumstances the default value is too low and the maximum number of connections needs to be increased slightly in order to avoid triggering false overload notifications. Setting this value to a too high limit might have severe consequences on a client's performance, and impact the whole H@H network badly. '''DO NOT CHANGE THIS VALUE UNLESS YOU ABSOLUTELY KNOW WHAT YOU ARE DOING'''!
:--silentstart
::Starts the UI in minimized mode (tray icon).
:--skip_free_space_check
::Disables the free space check so that the application won't err if the space left on the partition that contains the ''cache'' folder is less than the configured parameter (or 100MB if that parameter is set to a value less than 100MB).
:--use_more_memory
::Allows the application to use more memory in order to increase its performances (by reducing the number of I/O operations). More specifically, the application will use more memory when building the cached files list, sending the file's content, and it will use a memory cache in order to reduce the number of times the files' access timestamps are updated in the database.
:--verify_cache
::Forces a check of the entire cache. This is the same as --force_dirty, except that the content of each file in the cache is also checked (which can take a lot of time).
:-xmx''mem''m
::Limits the use of memory to ''mem'' (in MB).

==Cache==
The system will fill the cache will recently in-demand files and will delete least recently used files once it fills up to the set capacity. It is important for users not to manually tamper with any files in the cache as this will cause major trust and cache database issues for the client.

==Trust==
Trust merely indicates how well the client is performing according to other clients[http://forums.e-hentai.org/index.php?s=&showtopic=40925&view=findpost&p=1210510][http://forums.e-hentai.org/index.php?s=&showtopic=115037&view=findpost&p=2464003]. Trust slowly goes up if the client is behaving normally, even if it is not serving files. Negative trust often occurs from improper shutdowns or bad connections. Trust caps at +1000.

==Quality==
Quality measures the long-term overall stability and reliability of a client up to a value 10,000. It prioritizes clients for file requests (along with raw speed and proximity factors).
*New clients and clients that have been unused for several days will start out with 0 quality; it can take several days for it to stabilize at the baseline value.
*What constitutes a decent quality rating varies between geographical regions.

==[[Rewards]]==
Users receive 1 [[GP]] for each hit on their client, as well as be able to compete for a position on the [[Toplists#Hentai.40Home_Toplists|H@H toplist]].

The currency known as [[Hath]] is also be generated (calculated roughly every minute), which can be used to purchase [[Hath Perks]]. The minimum speed required to earn hath is 40 KB/s. The maximum amount that can be earned per day per client is 20 hath (this requires a rate of 300+ hits per minute).

===H@H Image Proxy===
To use H@H as a proxy for the [[galleries]], users simply need to enable it through their [[My_Home#My_Settings|My Settings]] page. This enables any images viewed in galleries to be loaded through the H@H client. As such, these images are added to the user's H@H cache, making them instantly (re)viewable as long as they remain cached.

===Hentai@Home Downloader===
Users can utilize an H@H client to [[download]] [[galleries]] as a alternative to [[Doggie Bag]]ging or [[torrents]]. This method does not cost any [[credits]] or [[GP]].

====How-To====
# Make sure that an H@H client has been running properly for at least 1 hour (add 15 minutes if coming out of a suspend) and has positive [[#Trust|trust]].
# In the desired gallery click the "Hentai@Home Downloader" link on the right-side column.
# Save the ".hathdl" file in the "hathdl" subdirectory found under the H@H directory.

Multiple galleries can be downloaded automatically over time (will be done in the order that the .hathdl files were added). As a gallery is being downloaded it will be saved in the "downloaded" subdirectory. When it is finished a file named "galleryinfo.txt" will be placed in the folder with the most current information for the gallery. The client will attempt to download from other H@H clients first but if this fails for 3 attempts it will pull the images from E-Hentai's image servers.

====Notes====
*The speed at which H@H downloads files varies based on the time the client has been online and the rate at which it has served files.
*Only the down-sampled pictures available from the E-Hentai server are downloaded, not the high quality images available from the other [[downloading]] options.
*Downloaded files '''do''' count against a user's daily image viewing limit. If the limit is hit the client will request extensions in blocks of 100 images costing the user 100 [[GP]] each time this occurs.
*This does not match the effect of the [[#H@H Image Proxy|H@H Image Proxy]] in the long-term. Files in the "downloaded" folder are not utilized when viewing galleries on the site but they are likely to be loaded from the "cache" folder since the client also copies them there during the downloading process.

=====Folder Filenames=====
*Will always end with the gallery ID in square brackets.
*Any characters in excess of the first 100 will be replaced by an ellipsis (not including the gallery ID).
*Some characters will be changed to their HTML escape equivalents (e.g. ' -> &#039;)

'''Example''':
The gallery [http://g.e-hentai.org/g/584539/ec70d28127/ http://g.e-hentai.org/g/584539/ec70d28127/] will create the following folder name: "[Drill Chichikuri (Warugaki)] Green - Ganbare! (Cry) Kogasa-chan!! ~Return~ Green - Do your Best... [584539]"

==See also==
*[[Hath]]
*[[Doggie Bag]]
*[[EHTracker]]
*[[Renting A Seedbox]]
*[[Technical_Issues#H.40H|Technical Issues - H@H]]

==Forum Links==
*[http://forums.e-hentai.org/index.php?s=&showtopic=117291&view=findpost&p=2493908 How quality is measured]

{{Template:EHGNav}}

[[Category:E-Hentai Galleries]][[Category:Site Features]]