Difference between revisions of "External Connections"

From AMule Project FAQ
Jump to: navigation, search
m (Corrected last correction)
 
(21 intermediate revisions by 13 users not shown)
Line 1: Line 1:
External Connections are the ''bi-directional'' way [[aMule]] has to communicate with external utilities, like the [[aMuleWeb]] and [[aMuleCMD]]. So, when a user is controlling [[aMule]] remotely, it is sending the commands through the External Conections port and [[aMule]] is reading them there (when controlling through a web browser, what is really happening is that [[aMuleWeb]] is getting the actions, interpreting them and sending the commands to the External Connection ports).
+
<center>'''English''' | [[External_Connections-de|Deutsch]]</center>
  
If both [[aMule]] and their utilities run on the same machine, there's no need to redirect the External Connections port in a [[Firewall]]ed environment (NAT network with a router, etc...). If you had to connect to the External Connections port from somewhere out the network, it would be necessary to configure the router/[[Firewall]]/etc properly to accept connections through the External Connection port (this would happen, for example, connecting through [[aMuleCMD]] from somewhere outside the network).
+
''''External Connections''' (EC) is a bi-directional interface [[aMule]] uses to communicate with external utilities, specifically:
  
'''NOTE:''' There are alternate ways of communicating with [[aMule]] although External Connections is the only ''bi-directional'' way.<br>
+
* [[aMuleWeb]]
Other ways would be the [[Signature|Online Signature]] (outgoing direction) and [[ED2KLinks]] file (ingoing direction).
+
* [[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.