Diff: [root] @ a8f6ae05535 | faq | css

Hellnet & hellspawn update

File created: hellnet/hellage/admin [Diff]

-- /dev/null++ b/hellnet/hellage/admin
@@ -1 +1,14 @@
h1. How to run your own Hellage index

First, see [[use]] for installing Hellage.

Then, see [[/hellnet/hspawn/use#metatrees]] for information how to create your own meta key.

Last, run

bc. $ hellage-genmeta mykey hackage

Where @mykey@ is your key alias and @hackage@ is your meta name.

This will download index and packages from [http://hackage.haskell.org] and store links in your meta. If download of certain package is stalled for too long, feel free to interrupt the program; next time it will start where it ended, only need to re-download index.

File created: hellnet/hellage/index [Diff]

-- /dev/null++ b/hellnet/hellage/index
@@ -1 +1,5 @@
use - How to use it
admin - How to run your own mirror

Hellage is a distributed "Hackage":http://hackage.haskell.org/ haskell packages' repository mirror.

File created: hellnet/hellage/use [Diff]

-- /dev/null++ b/hellnet/hellage/use
@@ -1 +1,69 @@
h1. How to use Hellage

h2. Install

This may be insanely difficult. Or not.

First, "install Hellnet":/hellnet/hspawn/build. If you manage it, the rest is simple:

bc. $ cabal install hellage

or, @git clone git://git.bitcheese.net/hellage && cd hellage && runghc Setup.hs install@ and have fun.

h2. Actually use it

First, you need to add at least one Hellnet node to your nodelist. You can use bitcheese.net:6666 for now.

bc. $ hell-nodes handshake bitcheese.net 6666

Then you need to run hellage daemon on your machine:

bc. $ hellage 8da7ec91e46c4b1444bd1b1a151a038a0544fad23266111a8a84178efb9499cb756a265bbe456bd9ec9ba309bf146f8453ba17201ff968e181e36b5efe54fc1f hackage

Here, *8da7ec...* is my encryption key ID and *hackage* is meta name of hellage. If you plan to use this (or any other) key often, you can create an alias:

bc. $ hell-meta alias add voker57_key 8da7ec91e46c4b1444bd1b1a151a038a0544fad23266111a8a84178efb9499cb756a265bbe456bd9ec9ba309bf146f8453ba17201ff968e181e36b5efe54fc1f

and then refer to this key as "voker57" everywhere:

bc. $ hellage voker57_key hackage

This command will run hellage on its default port, which is 6609. If you want to change it, run hellage with -p 64657.

*WARNING WARNING*: Currently hellage does not bind to localhost, thus anybody with access to port can use it. Use firewalls or whatever to protect.

Now, let's add hellage to cabal's sources:

bc. $ editor ~/.cabal/config

Search out the @remote-repo:@, comment it out and add hellage:

bc. -- remote-repo: hackage.haskell.org:http://hackage.haskell.org/packages/archive
remote-repo: hellage:http://localhost:6609

Update the hellage index:

bc. $ wget http://localhost:6609/update -O- 2>/dev/null

If result is "Failed" then something went wrong and hellage won't work. Check node connectivity.

Then, run @cabal update@ to get package index:

bc. $ cabal update

If everything was OK, then you can download packages now:

bc. $ cabal install empty

Congratulations! You got hellage up and running.

h2. Tricks

* If you don't like to keep a terminal emulator constantly running, i suggest using "daemontools":http://packages.debian.org/sid/daemontools or "dtach":http://dtach.sourceforge.net/ or "screen":http://www.gnu.org/software/screen/ for daemonizing hellage.
* You can update hellage via hellage!

h2. Troubleshooting / Feedback

If you succeeded, or failed, in installing hellage by this manual, share your experience in "hellnet mailing list":http://groups.google.com/group/hellnet.

File: hellnet/hspawn/build [Diff]

-- a/hellnet/hspawn/build++ b/hellnet/hspawn/build
@@ -2,11 +2,11 @@

Warning: this requires lot of magic

h2. Downloading Manually

Get the latest source from git: @git clone git://git.bitcheese.net/Hellnet@

Requirements are: "GHC":http://haskell.org/ghc 6.10 6.12 (didn't check with other compilers), "Cabal":http://haskell.org/cabal (you will have to install them manually, as described "here":http://book.realworldhaskell.org/read/installing-ghc-and-haskell-libraries.html) HTTP, Lucu, Crypto (these are Cabal packages, you can install them with @cabal install name@)

Once you have all those installed, Hellnet can be built with

@@ -17,6 +17,14 @@
On first stage, Cabal may complain about missing dependencies, you'll have to install them.

Alternatively, if you don't want to mess with Cabal, you can just run 'make', it will compile all the executables in current folder. They are static and can be safely moved.

h2. Via cabal

Hellnet is available on Hackage. To install it, you'll need working Cabal setup (see above). Then

bc. $ cabal install hellnet

And pray, since not all packages on hackage are ready for GHC 6.12 and you may have to patch them.

Now, to the next step, [[use]].

File: hellnet/hspawn/use [Diff]

-- a/hellnet/hspawn/use++ b/hellnet/hspawn/use
@@ -51,7 +51,7 @@

And after short wait read the text of GPL.


h2(#metatrees). Meta trees

[[/hellnet/tech/metatrees|Meta trees]] are tool to publish named information to Hellnet and keep it updated. Authenticity of information is guaranteed via digital signatures.

File: hellnet/index [Diff]

-- a/hellnet/index++ b/hellnet/index
@@ -1,3 +1,9 @@
tech - descriptions of technologies used in Hellnet
hspawn - documentation related to Haskell implementation
protocols - protocols' documentation
crypto - cryptographic stuff used in Hellnet
hellage - distributed hackage mirror using Hellnet

Hellnet is a project to create simple, distributed, anonymous data sharing network.

You can see current state of matters on [[status]] page.

By Voker57 on 2010-02-28 16:29:42 +0000