|
|
| (7 intermediate revisions by 3 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-rcX versions ===
| + | |
| − | | + | |
| − | *[http://www.gnu.org/software/tar/tar.html Untar] the sources and copy '''''src/aMule.tmpl''''' or in new versions (you are using a ''new version'' if you don't have the file ''aMule.tmpl'' in ''src/'') 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/''
| + | |
| − | :'''NOTE''': Note that in current versions (since [[aMule]] 2.0.0) the above step is not necessary (in fact, it is incorrect).
| + | |
| − | | + | |
| − | *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''
| + | |
| − | | + | |
| − | ::'''NOTE:''' Since [[aMule]] 2.0.0 the ''~/.eMule'' file is now called ''~/.aMule/amule.conf''.
| + | |
| − | | + | |
| − | *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 ===
| + | |
| − | | + | |
| − | *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" (This option doesn't exist since version 2.1.0)
| + | |
| − | ***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 ''~/.aMule/amule.conf'' file, and locate or create the following lines:
| + | |
| − | ::'''NEW VERSION REVIEW:''' For newer aMuled/aMuleWeb versions, you must run ''amuleweb -w'' and edit ''~/.aMule/remote.conf'' for these options. If in doubt, edit both.
| + | |
| − | **''[ExternalConnect]'' <- Section header
| + | |
| − | **''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 (by default, ''/usr/local/share/amule/webserver'' if you compiled [[aMule]], or ''/usr/share/amule/webserver'' if you installed it from a package).
| + | |
| − | | + | |
| − | 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]
| + | |
| − | | + | |
| − | == Other sources of information ==
| + | |
| − | | + | |
| − | Read the [[aMuleWeb]] man page, which is available in English, French, German, Hungarian and Spanish.
| + | |
