Webserver
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 or in new versions only the following dir 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 -r /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). Use this if you want to run amuled, too. 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=ca3c365274907c6fd527068788e14639 <-- 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.
Webserver with aMule 2.0.0 or later (starting from CVS 2005.02.27)
- For users running the monotlithic aMule application:
- 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.
- Go to "Preferences"->"Remote Controls" (in aMule) and...
- NOTE: When you change your webserver and External Connections ports here, make sure to restart aMule.
- For users running the aMule daemon:
- Shutdown aMuled 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=ca3c365274907c6fd527068788e14639 <-- To find the MD5 string for your password, do:
- $ echo -n yourpasswordhere | md5sum | cut -d ' ' -f 1
- ca3c365274907c6fd527068788e14639
- Restart aMuled
NOTE: In aMule version 2.0.0 and later you don't need to do any copy/link of webserver files.
Thanks to Stefanero, from who I shamelessly stole a lot from his tutorial.
Skin support
Webserver now looks for its files in a number of places:
- In your home directory: $HOME/.aMule/webserver/[skin name]/
- And at it's install location, in this order.
Default skin (template) name is 'default'.
If, after installing aMule, webserver refuses to run because of not being able to load template:
- please report this situation to us, and then
- create the directories webserver/default in the .aMule subdirectory of your home directory, and copy the contents of the src/webserver directory there from the aMule tarball (I mean to $HOME/.aMule/webserver/default). [New record, four 'directory' word in one sentence :)]
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