Initial Setup Guide

From AzureusWiki

Contents 1 Installation 1.1 Java 1.2 Azureus 1.2.1 Windows 1.2.2 Linux 1.2.3 Mac OS X 2 Setup and Optimization 2.1 Choosing a Port 2.2 Connectivity 2.2.1 Port Forwarding for Routers 2.2.2 Opening Ports for Firewalls 2.3 Connection Settings 3 Finally

Installation

While the installation for Azureus is, all in all, pretty straight forward, we realize that if you're not very confident with computers installing anything can be daunting. This page is a quick guide to help you get Azureus up and running, so you can start downloading files and contribute to the torrent community.

Java

You have probably already noticed that Azureus is written in Java, and you must have Java installed to use it. Having an outdated version of Java, or having more than one copy of Java installed, can cause majour problems for Azureus; such as your CPU usage spiking to 100%! Before installing Azureus, we recommend you read through the Java guide and make sure it is installed correctly.

Azureus

Azureus itself comes in several installation packages, depending on your operating system. If you've installed programs before these will likely seem familiar. If you are unfamiliar with installing applications on your Operating System or just want some hints, follow the steps below.

Windows

Windows, despite all of its flaws, has the redeeming quality of having the easiest installer system (assuming you're an Administrator on Windows NT/2000/XP). To install Azureus on a Windows computer:

1. Download Azureus from the official download page, saving it to somewhere you can find at a later date. If you unsure, you can always save it to the desktop.
2. Wait for the download to complete. Once it does, you can click "open" if your browser has that function, or you can find and double click the "Azureus_<version>_Win32.setup.exe" file. If you saved to the desktop then minimize everything and you should be able to find it (hint: Hitting M with the Windows Key held down will minimize all open windows).
3. Follow the installer instructions, clicking the "Next" button when you have finished with each page.

Linux

x86 and x86_64 tested PPC should be the same

1. Download platform source file from download page http://azureus.sourceforge.net/download.php
2. Place Azureus_(version)_linux-(platform).tar.bz2 in directory where you want to install Azureus

   cp Azureus_(version)_linux-(platform).tar.bz2 /directory/to/install/in/.

3. Untar the file

   tar -xjf Azureus_(version)_linux-(platform).tar.bz2

4. Make sure you have Java in your path if necessary

   export PATH=/path/to/java/bin:$PATH

5. Change to that directory

   cd azureus

6. Run script

   ./azureus

7. Follow setup directions

Note: if you wish to add Azureus to your /usr/bin directory you need to redirect it with a script rather than linking it.

Example Script:

 #!/usr/bin/bash
 /path/to/azureus

Mac OS X

1. Download the latest version of Azureus from Sourceforge
2. Mount the downloaded disk image
3. Accept the GPL license agreement
4. Drag the Azureus.app file to your application directory and double click it.

Setup and Optimization

A good setup is vital for your download speed and the bit-torrent community as a whole. Here are some simple points that should be followed after a fresh install of Azureus.

When you first run Azureus, the "Configuration Wizard" pops up, asking for some basic information. Using these settings is OK (especially if you don't know your upload bandwidth), but ideally you will want to optimize them for your specific connection. If you know your connection speed, go ahead and select it. Otherwise just leave it and follow the Connection Settings guide.

Note: "adsl/cable xxx/128 kbps" setting refers to a broadband connection with any download speed, but only 128 kbps upload.

Choosing a Port

Once you have (or haven't) finished with the Transfer and Connection page, click Next and you will see the NAT/Server port page. Here you can change the port number Azureus uses to listen for incoming connections. It is best to change the port number from the default 6881, because some trackers blacklist it, for reasons better explained on that page.

Pick a number between 49152 and 65534, and enter it into the box. Hit the "Test" button.

If the test returns:

"Testing port XXXXX ... OK !"

Then you can skip the entire Connectivity section and go to Connection Settings.

Connectivity

If your NAT/Firewall test says:

Testing port XXXXX ... NAT Error

Then you have a small problem: the listening port is closed and Azureus will be unable to accept incoming connections. This will limit the number of peers you can connect to, because you won't be able to make outgoing connections to other peers with NAT errors (ie, neither peer responds when trying to open a connection). This is normally caused by one of two things.

Port Forwarding for Routers

If your router doesn't know where to send the incoming connections, you will need to tell it. If you know how to do port forwarding, tell your router to forward the port you selected earlier (shown on Tools > Options > Connection) for both TCP and UDP protocols. If you are unfamiliar with port forwarding, there is a far more in-depth guide about NAT. Remember: you will need a static Local IP for port forwarding.

Opening Ports for Firewalls

Another common connectivity problem is caused by firewalls rejecting connections, even when they reach your computer. If this is the case, you will need to change your firewall settings to either allow the process Azureus.exe complete access to the internet, or allow the port you selected earlier. Further more detailed information about Firewalling.

Connection Settings

This is the final part of your setup, and, sadly, the downfall of most users. Read some more about Good settings.

There are a few basic things to do. The one that will affect you most is your upload limit. This should be set to roughly 80% of your actual upload ability (note: not what your ISP says you have). You can check your upload bandwidth at websites like DSLreports (US) or TestMy.Net (EU). You may want to run the test a few times to check the results for errors.

There are many connection efficiency settings that can be altered. To make it easier for you, The_8472 has written a calculator for all the settings. Just enter your upload results in the "Required data" section, and type the connection settings back into Azureus.

Finally

You need to start using Azureus! There are plenty of helpful links to get you going, and an article on what to do now when you've got Azureus installed and working properly!