Difference between revisions of "Webserver"
From AMule Project FAQ
(Installing from rpms is not a problem) |
(how to calculate md5 password) |
||
| Line 1: | Line 1: | ||
| − | == | + | == Setting up [[aMuleWeb|Webserver]] with [[aMule]] == |
| − | [[Webserver-1.2.x|Webserver with aMule 1.2.8 or earlier]] | + | === [[Webserver-1.2.x|Webserver with aMule 1.2.8 or earlier]] === |
=== Webserver with [[aMule]] 2.0.0-rc1 or later === | === Webserver with [[aMule]] 2.0.0-rc1 or later === | ||
| Line 15: | Line 15: | ||
**Enable "Accept External Connections". | **Enable "Accept External Connections". | ||
**Enable "Use TCP ports instead of unix local sockets". | **Enable "Use TCP ports instead of unix local sockets". | ||
| + | **Enter a password for external connections. If you don't do this, amuleweb will not communicate with amule. | ||
| − | + | :'''NOTE:''' On some early [[aMule]] 2.0.0-rcX versions the above options weren't available (or didn't work). If you are using such [[aMule]] version and you don't wish to upgrade, then do the following: | |
| − | + | :Shutdown [[aMule]] if it is still running. | |
| − | + | :Edit your ''~/.eMule'' file, locate the ''[ExternalConnect]'' section and change: | |
| − | + | ::''AcceptExternalConnections=1'' <-- To enable [[aMule]] listening for [[External Connections]]. | |
| − | + | ::''ECUseTCPPort=1'' <-- To use the [http://www.faqs.org/faqs/internet/tcp-ip/resource-list TCP] port. Very important since [http://www.unix.org Unix] sockets are disabled. | |
| + | ::''ECPassword=0a98sd7f0a9s8d7f0a98sd7f'' <-- To find the MD5 string for your password, do: | ||
| + | :::''$ echo -n yourpasswordhere | md5sum | cut -d ' ' -f 1'' | ||
| + | :::''ca3c365274907c6fd527068788e14639'' | ||
*Restart [[aMule]] | *Restart [[aMule]] | ||
Revision as of 17:36, 27 January 2005
Contents
Setting up Webserver with aMule
Webserver with aMule 1.2.8 or earlier
Webserver with aMule 2.0.0-rc1 or later
- Untar the sources and copy src/aMule.tmpl and src/webserver/ into your ~/.aMule/ directory. The following (run from the sources directory), should do so:
- $ cp -r src/aMule.tmpl src/webserver/ ~/.aMule/
- If you installed aMule from rpm, then you can do:
- $ cp /usr/share/amuleweb/aMule.tmpl ~/.aMule/
- $ cp /usr/share/amuleweb/webserver/ ~/.aMule/
- Go to "Preferences"->"Remote Controls" (in aMule) and...
- Enable "Accept External Connections".
- Enable "Use TCP ports instead of unix local sockets".
- Enter a password for external connections. If you don't do this, amuleweb will not communicate with amule.
- NOTE: On some early aMule 2.0.0-rcX versions the above options weren't available (or didn't work). If you are using such aMule version and you don't wish to upgrade, then do the following:
- Shutdown aMule if it is still running.
- Edit your ~/.eMule file, locate the [ExternalConnect] section and change:
- AcceptExternalConnections=1 <-- To enable aMule listening for External Connections.
- ECUseTCPPort=1 <-- To use the TCP port. Very important since Unix sockets are disabled.
- ECPassword=0a98sd7f0a9s8d7f0a98sd7f <-- To find the MD5 string for your password, do:
- $ echo -n yourpasswordhere | md5sum | cut -d ' ' -f 1
- ca3c365274907c6fd527068788e14639
- Restart aMule
- Go to your "Preferences"->"Remote Controls" (in aMule) and setup your passwords here for External Connections and webserver login.
- NOTE: When you change your webserver and External Connections ports here, make sure to restart aMule.
- NOTE: that "Enable Webserver" has no effect and will be renamed in 2.0.0rc8. Webserver is always enabled as long as you have External Connections enabled.
- NOTE: For users running aMule Daemon you have to edit the .eMule file like shown above. For a way to setup a password check the 1.2.8 aMule HowTo. You can still do it in the same way.
- Now you're done! You are ready to run amuleweb and connect to it.
Connecting to amuleweb
To run aMuleWeb run amuleweb on a terminal. For more information about running aMuleWeb check the aMuleWeb document.
Once aMuleWeb is running, open a web browser and connect to:
where host stands for your host's name (try with localhost) and port stands for the aMuleWeb port (NOT the External Connections port).
For example: http://localhost:4711
Standard ports
The ports can be set to anything, but this are the most used (the standard ones):
- External Connections: 4712
- amuleweb: 4711
Make sure you do not confuse with what each of them is.
Where to report problems and questions?
For Problems or Questions just report on http://forum.amule.org forum or join IRC channel #amule at irc.freenode.net
