|
|
(21 intermediate revisions by 8 users not shown) |
Line 1: |
Line 1: |
− | == Setting up [[aMuleWeb|Webserver]] with [[aMule]] ==
| + | #REDIRECT [[aMuleWeb]] |
− | | + | |
− | === [[Webserver-1.2.x|Webserver with aMule 1.2.8 or earlier]] ===
| + | |
− | | + | |
− | === Webserver with [[aMule]] 2.0.0-rc1 or later ===
| + | |
− | | + | |
− | *[http://www.gnu.org/software/tar/tar.html 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 [http://www.faqs.org/faqs/internet/tcp-ip/resource-list TCP] port. Very important since [http://www.unix.org 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 [[aMuleWeb|webserver]] login.
| + | |
− | ::'''NOTE:''' When you change your [[aMuleWeb|webserver]] and [[External Connections]] ports here, make sure to restart [[aMule]].
| + | |
− | ::'''NOTE:''' that ''"Enable [[aMuleWeb|Webserver]]"'' has no effect and will be renamed in 2.0.0rc8. [[aMuleWeb|Webserver]] is always enabled as long as you have [[External Connections]] enabled.
| + | |
− | ::'''NOTE:''' For users running [[aMuled|aMule Daemon]] you have to edit the ''.eMule'' file like shown above. For a way to setup a password check the [[Webserver-1.2.x|1.2.8 aMule HowTo]]. You can still do it in the same way.
| + | |
− | | + | |
− | *Now you're done! You are ready to run [[aMuleWeb|amuleweb]] and connect to it.
| + | |
− | | + | |
− | '''[[User:Stefanero|Stefanero]]'''
| + | |
− | | + | |
− | === 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.
| + | |
− | ::'''NOTE:''' When you change your [[aMuleWeb|webserver]] and [[External Connections]] ports here, make sure to restart [[aMule]].
| + | |
− | | + | |
− | *For users running the [[aMule|aMule daemon]]:
| + | |
− | **Shutdown [[aMule|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 [http://www.faqs.org/faqs/internet/tcp-ip/resource-list TCP] port. Very important since [http://www.unix.org 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|aMuled]]
| + | |
− | | + | |
− | '''NOTE:''' In [[aMule]] version 2.0.0 and later you don't need to do any copy/link of [[aMuleWeb|webserver]] files.
| + | |
− | | + | |
− | Thanks to [[User:Stefanero|Stefanero]], from who I shamelessly stole a lot from his tutorial.
| + | |
− | | + | |
− | ==== Skin support ====
| + | |
− | | + | |
− | [[aMuleWeb|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]], [[aMuleWeb|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 :)]
| + | |
− | | + | |
− | '''[[User:GonoszTopi|GonoszTopi]]'''
| + | |
− | | + | |
− | == Connecting to [[aMuleWeb|amuleweb]] ==
| + | |
− | | + | |
− | To run [[aMuleWeb]] run '''''amuleweb''''' on a terminal. For more information about running [[aMuleWeb]] check the [[aMuleWeb|aMuleWeb document]].
| + | |
− | | + | |
− | Once [[aMuleWeb]] is running, open a web browser and connect to:
| + | |
− | | + | |
− | ''http://host:port''
| + | |
− | | + | |
− | 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|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 [irc://irc.freenode.net/amule #amule] at [irc://irc.freenode.net irc.freenode.net]
| + | |