Difference between revisions of "Webserver"

From AMule Project FAQ
Redirect page
Jump to: navigation, search
(=Webserver with aMule 2.0.0-rc1 or later=)
 
(18 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''
+
 
+
::'''NOTE:''' Since a couple days and from now on, there will be no .eMule file anymore! The new Config-File will be amule.conf in your ~/.aMule directory!!! <br>
+
*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]
+

Latest revision as of 00:16, 13 November 2005