Difference between revisions of "Connect"

From twofo wiki
Jump to navigation Jump to search
Line 101: Line 101:
Those wishing to use valknut will need to download and compile from the source as describe at http://wxdcgui.sourceforge.net/compile.html  '''The valknut in your repositories is too old and thus cannot download from modern DC++ clients (ie. everybody else)'''<br>
Those wishing to use valknut will need to download and compile from the source as describe at http://wxdcgui.sourceforge.net/compile.html  '''The valknut in your repositories is too old and thus cannot download from modern DC++ clients (ie. everybody else)'''<br>
In Valknut you can simply add a Bookmark to your Hub List for twofo - Address: hub.twofo.co.uk:4146 and then under 'Profile' make sure you've ticked the 'Secure Socket Layer' (SSL) box. (Same as the guide for Valknut for mac users below)  This avoids the need to install stunnel completely.
In Valknut you can simply add a Bookmark to your Hub List for twofo - Address: hub.twofo.co.uk:4146 and then under 'Profile' make sure you've ticked the 'Secure Socket Layer' (SSL) box. (Same as the guide for Valknut for mac users below)  This avoids the need to install stunnel completely.


====CrZDC++====
====CrZDC++====

Revision as of 16:10, 30 August 2010

If you are new to DC++ then there is a preconfigured file providing all the files and information you need to connect to the hub, from either on or off campus, available from http://www.twofo.co.uk/resources/twofoDC++.exe This file has the optimum settings for people using twofo. Obviously if you are running Linux or MacOS that won't work so you will have to follow the guides below.
If you are already connected to the hub but can't connect to any of the people online then check the Client Help page for details on correctly setting up your client.
If you still can't connect to the hub after following these instructions ask on the forums at http://www.twofo.co.uk/forum, but do try to be specific about where the connection is going wrong, or any error message you are getting as this makes it alot easier for us to diagnose.

Getting Started

twofo is a Direct Connect hub. This means that you will need a suitable Direct Connect client for you computer in order to connect. These clients are available for many operating systems, including Windows, Linux and MacOS.

A basic guide to using DC++ can be found at http://www.b.ali.btinternet.co.uk/DCPlusPlus/gettingStarted.html

Available Clients:

Windows - DC++ - There is now a preconfigured DC++ client for those wishing to use twofo, either on or off campus, available at http://www.twofo.co.uk/resources/twofoDC++.exe Simply download the file to a directory you will remember and run; instructions are provided on how to connect within the file.
Should you wish to install the standard version, the recommended versions are DC++ v0.761 or DC++ v0.699

If you download v0.761 from the DC++ website, be aware that it comes with a feature called segmented downloads, for more information click here, or to see how to disable it, please click here. The preconfigured client has this turned off by default.

Linux - Valknut , LinuxDC++, nanodc, microdc2

MacOS - Shakespeer, Valknut - Scroll down for instructions on how to use stunnel with these clients.

Connecting from Off Campus

Using a client off campus is much the same as using one on campus, except for the lack of necessity for using stunnel. Windows users can again use the preconfigured client at http://www.twofo.co.uk/resources/twofoDC++.exe and just connect to the off campus option in favourite hubs as displayed, however many of the options set are optimised for a campus connection rather than a broadband one so ask on the hub if you need advice about disabling some of them.

Connect to hub.twofo.co.uk:4144 (Please do not use stunnel, it confuses other users into thinking you are on campus). This connects on the standard port which typically is not blocked by ISPs. We ask that people off campus set up their client so that the client speed is not set to LAN(T1) or LAN(T3). Other speeds, such as 28.8k, Cable, DSL, 0.1, 0.2 etc are OK. This is to make it easier for other users to distinguish off campus users from on campus when on the hub.

You WILL need port forwarding set up to use DC++ from off campus and behind a router. Please see this guide

Connecting from the Campus Residential Network

Windows Users

The traffic shaper on resnet prevents a normal connection from DC++, so in order to connect you will have to use a program called stunnel

The easiest way to do this is to download the preconfigured client from http://www.twofo.co.uk/resources/twofoDC++.exe This contains both stunnel and DC++ and a set of instructions on how to set it up to connect to the hub.


However, if you already have DC++ installed and just require stunnel then please follow the steps below:

  1. Download the rar file from http://www.twofo.co.uk/resources/stunnel.rar (or http://www.twofo.co.uk/resources/stunnel.zip for if you don't have winrar installed)
  2. Extract ALL the files into a folder.
  3. Then run the stunnel.exe.
  4. Once the icon is in the tray, just set DC++ to connect to localhost:8000 (File -> Quick Connect) and it takes you straight onto twofo.

Once connected you can type /fav in the main chat window to add twofo to your favourite hubs.


If you wish, you can of course download stunnel yourself from http://www.stunnel.org/ , but you would have to configure it yourself to connect to the SSL server hub.twofo.co.uk:4146

If you are getting the message '*** Connection refused by target machine' when trying to connect to the hub then make sure that stunnel is running. You will need to restart stunnel each time your restart your computer, and without it running in the background you will not be able to connect to the hub. The above message is almost always caused by the lack of stunnel. When stunnel is running it should put an icon in your system tray (next to the clock). If you still can't connect then ask on the forums.


YOU WILL HAVE TO BE IN ACTIVE MODE (on the latest versions of DC++, this is called "Direct Connection") AND HAVE THE CORRECT IP IN DC++ IN ORDER TO SEARCH AND DOWNLOAD. You can find your IP at http://checkip.dyndns.org/

There is an extensive guide to any other problems you may have downloading here

It is a very good idea to consider setting up your firewall to block Off Campus connections to DC++ when on campus. Guides to doing this can be found here

Linux Users

If you are an off campus user, you only need to download and install a relevant client, any of the stuff about using stunnel or SSL encryption can be ignored as you just need to connect to hub.twofo.co.uk:4144 and set up port forwarding.

LinuxDC

To use LinuxDC on twofo, you will need to run stunnel separatly. You can get Stunnel from http://www.stunnel.org/ or your package manager/repositories or use the command "sudo aptitude install stunnel4", depending on your distro.

Once installed make the following changes to /etc/stunnel/stunnel.conf (or replace it with the preconfigured one from http://www.twofo.co.uk/resources/stunnel.conf)


Under 'Service-level configuration' add the following lines:

[twofo]

accept = 8000

connect = hub.twofo.co.uk:4146


Now you need to modify these existing lines:

"cert = /etc/stunnel/mail.pem" should be changed to ";cert = /etc/stunnel/mail.pem"

";client = yes" should be changed to "client = yes"

(You can pick any high numbered port you like instead of 8000)


Next open a root terminal and type the command (stunnel has to be run as root):

stunnel4

Or you could type the following command (should ideally work without modifying the configuration in the stunnel.conf file)

stunnel -c -d 8000 -r hub.twofo.co.uk:4146


Finally, open your Direct Connect client, set yourself to Active mode and put in your IP from http://checkip.dyndns.org/ , and connect to 'localhost:8000'

Valknut

Those wishing to use valknut will need to download and compile from the source as describe at http://wxdcgui.sourceforge.net/compile.html The valknut in your repositories is too old and thus cannot download from modern DC++ clients (ie. everybody else)
In Valknut you can simply add a Bookmark to your Hub List for twofo - Address: hub.twofo.co.uk:4146 and then under 'Profile' make sure you've ticked the 'Secure Socket Layer' (SSL) box. (Same as the guide for Valknut for mac users below) This avoids the need to install stunnel completely.

CrZDC++

CrZDC++ is based on a more recent version of DC++ and is available from http://www.crzdc.net/ To use it on campus you will however need to compile both it and stunnel. As such the instructions for stunnel and what address to connect to are the same as for LinuxDC above.

Command Line Clients

For any users wishing to use a command line client on linux there are two options available to you, nanodc and microdc2. Neither of these clients are still in development but both have been shown to allow users to chat and share on DC++ successfully.

The latest version of nanodc can be downloaded from http://sourceforge.net/projects/nanodc/ and there is a guide to using http://nanodc.sourceforge.net/nanodc2.html. NB. The download links off the guide are for a slightly older version of nanodc so you are recommended to get the latest from souceforge, however the guide is still accurate

The original microdc2 site has been down now for some time, but for the purposes of here there is a copy of the page with the build instructions at http://astropointy.kicks-ass.net/~james/microdc2.htm The tar.gz source file can be found at http://astropointy.kicks-ass.net/~james/microdc2-0.15.6.tar.gz

The original microdc2 site was hosted at http://corsair626.no-ip.org/microdc/

Mac Users

As for the linux users, if you are an off campus user, you only need to download and install a relevant client, any of the stuff about using stunnel or SSL encryption can be ignored as you just need to connect to hub.twofo.co.uk:4144 and set up port forwarding.

Shakespeer

Recommended Method

The recommended method method (as Valknut isn't a very user friendly program for novice users) is to use Shakespeer. If you are off campus you can just download Shakespeer and connect directly to hub.twofo.co.uk:4144 and not have to worry about stunnel, SSLEnabler etc.

1) Make sure you have Developer Tools installed. They can be installed on the OS X install Disc under Optional Installs/Xcode Tools/XcodeTools.mpkg ...

2) Download, extract and compile stunnel from stunnel.org - should compile just fine. To do this follow the steps below:
2a) Download the latest stunnel source package from http://www.stunnel.org/download/source.html (the tar.gz version). By default this will go to your 'Downloads' folder.
2b) Extract the files by double clicking on the file.
2c) Open a Terminal: Applications > Utilities > Terminal.app
2d) Navigate to the extracted files (if on the desktop still, cd desktop/stunnel-4.26 (or whatever version you have downloaded)).
2e) Run 'sudo ./configure' entering the password if/when asked.
2f) Run 'sudo make'
2g) Run 'sudo make install'

3) Download and install SSL Enabler, hosted at http://www.twofo.co.uk/resources/SSLEnabler.dmg

4) Download Shakespeer from http://shakespeer.googlecode.com/files/shakespeer-0.9.11.dmg

5) Start Shakespeer, share some files and folders in order to get it hashing while you complete the rest of the setup

6) Start SSL Enabler. It will ask to install Stunnel. Click yes, the install happens in the background, but doesn't work very well in reality (so yes, that's why we need step 2), but at least it wont ask you again. Then, configure followingly:

Localport: any of your choosing. eg. 8000. Remote Server IP: hub.twofo.co.uk Remote Port: 4146

--> Press Save

7) Go to Shakespeer settings, set network mode to Active, and enter your ip-address manually in the settings (it wont work with automatic mode). Port can be anything really (eg. 9176).

8 ) Go to bookmarks: Add a bookmark.

Name: twofo Address: 127.0.0.1:8000 (or the port you chose earlier, obviously)

9) Connect and enjoy a healthier (??) Valknut-free life at twofo.

10) FINALLY, AND IMPORTANTLY : Make sure your firewall is set up correctly. Go to System Preferences --> Security --> firewall. Make sure it is not set on "Allow only essential services", but rather on "Set Access For specific services and applications". Press the + button in the bottom left and add Shakespeer. Then set it to allow incoming connections. Now, you should be good to go !

Alternate Method

Note: This has only been tested on Intel Macs.

This may work as an alternative if you are having trouble getting stunnel to compile, however it should be noted that this method has failed for alot of people, as of yet we don't know why so you would be far better trying the method above first. This has been left here in case anybody is able to refine it.

1) Programs you will need installed to your Applications Folder: Darwine: http://darwine.sourceforge.net/download.php stunnel from the twofo website: http://www.twofo.co.uk/resources/stunnel.zip
2) Check Darwine is setup correctly by running notepad.exe in the Sample Applications folder within Darwine. If it is, notepad will open up.
3) Unpack the stunnel zip file into a new folder in Applications, and execute the stunnel.exe file with darwine. The only way you will know if this has loaded is by the Darwine status window... Once you see it there you're all set to connect to the hub!
4) Next set ShakesPeer to share some files, wait for them to hash, then connect to 127.0.0.1:8000

Valknut

The other method is to download Valknut for Mac OS X, http://snaggledworks.com/software/valknut/. Users of Intel Macs will need to download and install Fink in order to be able to install valknut.

Next, customise your settings, making sure you share at least 5GB of data. Add a bookmark with a profile and tick the "Secure Socket Layer" option: this will save you from installing stunnel , set the host as: hub.twofo.co.uk:4146 by doing the following:

1. Open the hub list (Action menu -> Hub list), if it's not already open

2. Click the "Bookmarks" tab

3. Right click anywhere in the bookmarks list and choose "Add" to bring up the add bookmark dialog

4. Put "hub.twofo.co.uk:4146" in the "Host" box

5. Tick the box next to "Profile", so that the Profile button gets enabled

6. Press the Profile button. The dialog gets bigger, and a "Secure Socket Layer" checkbox appears

7. Tick the "Secure Socket Layer" box, and just connect to the hub.

8. Put your IP from http://checkip.dyndns.org into the IP box in settings.

9. Go to File --> Quick Options --> Download Mode: Single to disable multi source downloading if on campus. See the FAQ for a detailed explanation as to why this should be done.

10. Valknut may need to be allowed in the Mac firewall. A guide to this can be found at http://www.umnp2p.com/mac/ Although this is aimed at Shakespeer users, the basic steps ought to be the same. You just have to choose Valknut instead of Shakespeer and set the TCP and UDP ports Valknut uses by default. Otherwise the firewall may need to be switched off in order to download.

This works for sure on Panther Mac OS 10.3.9 and Intel 10.4