Difference between revisions of "External Connections"

From AMule Project FAQ
Jump to: navigation, search
 
m (Corrected last correction)
 
(24 intermediate revisions by 13 users not shown)
Line 1: Line 1:
''Note: Since there's no info at all about this, I'll write what I think External Connections are. I'm no expert so I may be wrong, so take the following with a grain of salt. If some experts thinks this info is right, then please remove this comment (and if it's not, please correct it and remove the comment anyway! ;-) ).''
+
<center>'''English''' | [[External_Connections-de|Deutsch]]</center>
  
External connections are the way aMule has to communicate with external utilities, like the webserver. So, when an user is controlling aMule remotely with a web browser, he's not talking directly with aMule, but with another program (amuleweb in this case) that is who really listens at port 4711. This program then talks with aMule using the external connections mechanism.
+
''''External Connections''' (EC) is a bi-directional interface [[aMule]] uses to communicate with external utilities, specifically:
  
Since usually both aMule and their utilities run on the same machine, there's no need to redirect the external connections port in a firewalled environment (NAT network with a router, etc.).
+
* [[aMuleWeb]]
 +
* [[aMuleCMD]]
 +
* [[aMuleGUI]]
 +
 
 +
When a user is using one of these programs, it is sending the commands via the External Connections port and [[aMule]] is reading them there.
 +
 
 +
Unless [[aMule]] and the external utilities are used on the same machine, you may need to configure your firewall and/or router to manage the ports properly, ie, open them to incoming traffic.
 +
 
 +
The [[Firewall]] article has instructions on how to do this.
 +
 
 +
As of December 2006, aMule SVN has experimental code enabling [[Universal Plug and Play]] (uPnP), which enables you to configure the ports on a uPnP-compatible router automatically. This functionality should soon be available in a general release.
 +
 
 +
'''NOTE for [[aMule_SVN|SVN]] users:''' It is very important that the aMuleWeb, aMuleCMD, and aMuleGUI you use are built from the same daily CVS tarball as aMule; mixing versions you are liable to experience crashes. For official releases, the developers take extra care that the worst that happens when you mix versions is a message "Invalid protocol version".
 +
 
 +
'''NOTE:''' There are alternate ways of communicating with [[aMule]] although External Connections is the only ''bi-directional'' way. Other ways of communication with [[aMule]] would be the [[Signature|Online Signature]] (outgoing direction) and [[ED2KLinks file]] (ingoing direction).
 +
 
 +
For more information on the EC protocol, see [[ECv2|External Connections v2]].

Latest revision as of 11:57, 3 August 2008

English | Deutsch

'External Connections (EC) is a bi-directional interface aMule uses to communicate with external utilities, specifically:

When a user is using one of these programs, it is sending the commands via the External Connections port and aMule is reading them there.

Unless aMule and the external utilities are used on the same machine, you may need to configure your firewall and/or router to manage the ports properly, ie, open them to incoming traffic.

The Firewall article has instructions on how to do this.

As of December 2006, aMule SVN has experimental code enabling Universal Plug and Play (uPnP), which enables you to configure the ports on a uPnP-compatible router automatically. This functionality should soon be available in a general release.

NOTE for SVN users: It is very important that the aMuleWeb, aMuleCMD, and aMuleGUI you use are built from the same daily CVS tarball as aMule; mixing versions you are liable to experience crashes. For official releases, the developers take extra care that the worst that happens when you mix versions is a message "Invalid protocol version".

NOTE: There are alternate ways of communicating with aMule although External Connections is the only bi-directional way. Other ways of communication with aMule would be the Online Signature (outgoing direction) and ED2KLinks file (ingoing direction).

For more information on the EC protocol, see External Connections v2.