Antsp2p / Hornetp2p Tutorial


To run Ants p2p And / Or Hornet you need:

* Java Virtual Machine 1.5 (JRE or JDK)
* Internet connection

These applications can work on any operating system supporting JAVA. A Win32 special purpouse version is avaiable and it supports traybar docking.


There is no particular action to do in order to set up a good environment for them. If you use the JRE setup kit, it'll install everything you need to run the program.


Installing The Application


Once you set up your environment you have to install the client.

There are three way to perform the program setup:

* Using the Java Web Start autoinstaller you can find in the official ANts P2P website (There is not yet one for hornet)
* Downloading the lastest build from SourceForge as a zip archive
* Downloading the source code from SourceForge and compiling it

If you are not a programmer you should use the Java Web Start autoinstaller, cause it manages everything on its own.


Instead if you want a deeper control you can use the zip archive. The archive can be decompressed anywhere on your filesystem and everything related to the client will remain in that folder.


If you use the autoinstaller insted, you'll find a new folder in your home directory (i.e. C:\Documents and settings\[user] in Windows or /home/[user] in linux), where files and downloads related to the client will be put. Jar files and program related stuffs are managed by Java Web Start and you don't have to care about 'em.


To uninstall ANtsP2P you can use the Java Web Start control panel (if you installed ANtsP2P through Java Web Start). The control panel can be accessed from the Windows Start menu -> All the programs -> Java Web Start; to visualize ANtsP2P you must select Visualize -> Donwloaded Applications.





If you unzipped the archive insted, you just have to remove the folder to deflated the archive to.

Windows XP Firewall

The WindowsXP firewall does provide some functionality, and can be quite effective, though it only offers basic management functions.

To configure the WindowsXP Internet Connection Firewall (this process will require administrator privileges on the machine), follow these steps:
- Start
- Control Panel
- Network Connections
- right click on the connection that connects you to the Internet, select Properties.
- Advanced Tab
- Settings

You will need to create one entry for TCP incoming connections.
- Click on Add
- Under description of service, enter ANtsTCP or HornetTCP
- Under Name or IP address of machine, enter 127.0.0.1
- Under Internal port, enter the TCP port (4567 is the default)
- Under External port, enter the TCP port (4567 is the default)
- Ensure the TCP radio button is selected
- Click OK

and one entry for TCP server queries connections.
- Click on Add
- Under description of service, enter ANtsServersTCP or HornetServersTCP
- Under Name or IP address of machine, enter 127.0.0.1
- Under Internal port, enter the TCP port (4568 is the default, xxxx+1 if you changed the default ANtsTCP or HornetTCP port 4567 in xxxx)
- Under External port, enter the TCP port (4568 is the default, xxxx+1 if you changed the default ANtsTCP or HornetTCP port 4567 in xxxx)
- Ensure the TCP radio button is selected
- Click OK

When you start the P2P client you should see this window





This is the main connection panel. Clicking on SETTINGS you will be taken to another tab





This tab let you manage every program setting. You don't have to care about everything on this window... Single feartures will be described in Settings section of this guide. By now just set your connection speed and your IP address (if the one displayed is not your internet one), if you don't have a pubblic internet IP address dont care about that setting.


After you set these settings you can return to the initial tab (Connection) and click on Start Ant (you can also choose a diffrent nickname).


Once you pressed start ant you can see the program setting up everything and getting connected to IRC. Now you can ask in chat if you have doubts. Connection to Antsp2p (beta testers) or Hornet (end users) ants networks is not immediate. You have to wait for your node finds another nodes through IRC. You can also speed up you connection doing request to other people in chat: right click on a user in the chat panel and do Request Connection. You can either manually insert trusted peers by checking the Advanced checkbox in the Connection tab and putting their IPs in the dedicated list.





How can you figure out you are connected? Simply check that Download, Query and Upload panels have been added to the tabbed panel:




If you see this you are connected! Well done!

Managing queries

After you are connected you can do several things:

* Searching for files
* Connecting to web sites
* Managing your shared files
* Downloading or Resuming files

Let's begin from performing queries:

move to query panel...

type your search string (google syntax) and click on search by string, after a while you'll see result appearing as in the following picture.

To improve theresults accuracy you can follow the instruction in the query reference





Once you got results you can begin your download:





choose a source and righ click, you'll see download tab appearing. Left click to begin. Autoresume feature is enabled by default, so the client manages either alternative sources research and multiple sources download... you don't have to care of anything, simply check your download progress in download tab.


Managing downloads

By the download tab you can manage your downloads. Downloads can be active or interrupted. If autoresume is activated the client will manage everything, so it'll move active downloads to interrupted if no sources are avaiable anymore and it will resume them if it finds some sources... You can remove sources, interrupt downloads, activate and deactivate autoresume for each single download. You can also search for alternate sources for a download (this is useful if you want to manage your download manually without using the autoresume features).




Managing uploads

Upload interface is very easy... you can only interrupt active uploads. If you do this the current chunck upload will be interrupted, but this doesn't inibit the requirer, so it can perform new requests for that chunk. This means there is no way to completely interrupt an upload.




ED2K & ANts2K Links


Managing links

ANts can monitor the system clipboard for ants2k and ed2k links you copied from any other application.


let's make an example with mozilla:





once you copied the link in the clipboard switching to the client you should get the following confirmation box:





This happends if you enabled the clipboard monitoring for ed2k and ants2k links in the settings panel.


Selecting OK a new Query tab appears and a search is performed to find the file you selected.


Http connections


This feature lets you access remote websites hosted on other nodes through the ants networks.


To access this feature open the Http Connection tab once connected.




hitting refresh you can obtain a list of some web sites currently active on ants network. Just choose one, right click and select activate proxy. This will create a proxy to that site on a port you can set in settings. After the proxy has been created you will be able to see a gray background under the site infos.





Click again on the site row and select Open Browser. Notice that this will work only if you choosed a proper browser in settings.


Once you opened the browser you will be able to surf nto the selected web site.




There are several settings you can manage from this panel. They are groupped basically in five areas.


Beggining from the top-left area you can find settings regarding you connection speed (i.e. DSL, LAN etc). You should only set your connection speed as the other settings will be automatically set once you select it. You can anyway set every signle setting in this area and create a personalized configuration, this configuration will be lost as you restart the client.


Above this area you can find IRC settings: server/channel. You can also decide to use irc as a source of peers addresses. Selecting the autoreconnect option you can let the client automatically reconnect to irc if disconnected.


IP settings help you to be found by other peers. If you correctly set your public internet address it will be easy for other peers to find you. You can memorize a particular IP and you can also choose to let the client autostart on run... (immediate connection, no need to click on start ant): this is useful if you want to run the client at startup. Selecting the autoresume option you can activate the automatic source search & download for pending files when run.


ANts path area let you choose path for downloaded files, partial download chuncks, and browser executable file location.


On the left you can see the HTTP server settings. You should activate http service only if you are running a local http server (i.e. Apache, Jetty or the hornet webserver plugin). If you activate this option you have to choose a local port, that HAVE to match your webserver port and a Proxy port (any free port). You should give also info about your home page (full relative path) and a brief description (less than or equal to 255 chars) of the web site.

If you want to keep privacy in publishing web contents you HAVE to configure your web server to only allow local access (ie the machine it's being run on) so to make it accessible only through ANts http service, it also might help to configure your firewall to block outside access to the port the webserver is running on (though it isn't needed at all with the hornet webserver plugin).


Author / Source Credit

Original Tutorial Location - Dutchp2pforum.com
Posted By Shredder
Thanks Very Much For the Cool Tutorial, Keep Up The Good Work. Why? Description Screenshots User Guide Tutorial Chat Forums Planetpeer Forums Wiki