Difference between revisions of "FAQ webserver"

From AMule Project FAQ
Jump to: navigation, search
m (Removed Version Tag)
 
(15 intermediate revisions by 9 users not shown)
Line 1: Line 1:
 
== What is [[aMuleWeb]]? ==
 
== What is [[aMuleWeb]]? ==
 
 
Take a look at [[aMuleWeb|this]].
 
Take a look at [[aMuleWeb|this]].
  
 
== How can I setup [[aMuleWeb]] with [[aMule]] v2? ==
 
== How can I setup [[aMuleWeb]] with [[aMule]] v2? ==
 +
To configure it, please follow [[AMuleWeb#Configuring_aMuleWeb|this HowTo]].
 +
 +
== How can I setup [[aMuleWeb]] with [[aMule]] v1? ==
 +
Read [[Webserver-old|this HowTo]], but be aware that using [[aMule]] v2 is '''recommended''' and that [[aMule]] v1's [[aMuleWeb]] has some security bugs.
 +
 +
== What should I see when [[aMuleWeb]] is running correctly? ==
 +
After running ''amuleweb'' in a terminal, you should see something like this:
 +
 +
:''Web Server: Started''<br>
 +
:''WSThread: Thread started''<br>
 +
:''WSThread: created service''<br>
 +
:''WSThread: created socket listening on :4711''<br>
 +
:''amuleweb$''
 +
 +
== Can I run [[aMuleWeb]] as a daemon? ==
 +
Since [[aMule]] 2.0.0-rc6, [[aMuleWeb]] supports ''--quiet'' switch (or ''-q'' also) which renders allows    [[aMuleWeb]] to be easily run on the background.<
 +
 +
However, on previous [[aMule]] releases, although [[aMuleWeb]] works well, it's actually quite tricky to run it in the background because it's continuously asking for user commands and showing the prompt. The obvious way to avoid this would be running amuleweb with the output redirected to ''/dev/null'', but this hogs the CPU due to the constant writing, so a better approach is to use the program [http://directory.fsf.org/GNU/screen.html screen], which is a terminal emulator. In order to run [[aMuleWeb]] inside a virtual terminal, the following command should be executed: ''screen -d -m -S amulewebsession amuleweb -p 7000 -pw password'' (assuming that [[aMule]] is listening for [[External Connections]] on port ''7000'' and the password is ''password''). Then, [[aMuleWeb]] will start listening for HTTP connections, but will show the prompt and all messages in this virtual terminal. It's possible to switch to this terminal using the command ''screen -r amulewebsession'', please refer to [http://directory.fsf.org/GNU/screen.html screen] documentation for info about session switching, internal commands, etc.
 +
 +
==  Why is [[aMuleWeb]] failing to connect? ==
 +
If you followed the [[AMuleWeb|above HowTo]] correctly, make sure that you are using an [[aMuleWeb]] binary distributed with the same release as the [[aMule]] binnary. For example, [[aMuleWeb]] binary from the [[aMule]] 2.0.0-rc3 release will '''not''' connect with [[aMule]] 2.0.0-rc4, [[aMule]] 2.0.0-rc2 or any other version (including v1 versions).
 +
 +
== Why i always get "''No password specified, login will not be allowed.''" in amuleweb login page with [[aMule]] 2.2 (or CVS), even if i followed correctly how to set passwords, or i already did that successfully in [[aMule]] 2.1.x? ==
 +
Please make sure to follow the [[HowTo_get_aMule_web_interface#Configuration_of_the_aMule_web_interface]], line by line (especially end of article), some behaviors changed in [[aMule]] 2.2.
 +
Make sure to configure amuleweb in monolitic amule or amulegui and before using amuleweb --write-config (unless you know exactly what you are doing).
 +
Verify in the file ~/.aMule/remote.conf if the keys Password and AdminPassword are set with a md5 encrypted password value.
  
To configure it, please follow [[Webserver|this HowTo]].
+
== Why does the web interface keep going back to the login page ? ==
 +
Try deleting the cookies from the web browser.

Latest revision as of 10:05, 29 June 2008

What is aMuleWeb?

Take a look at this.

How can I setup aMuleWeb with aMule v2?

To configure it, please follow this HowTo.

How can I setup aMuleWeb with aMule v1?

Read this HowTo, but be aware that using aMule v2 is recommended and that aMule v1's aMuleWeb has some security bugs.

What should I see when aMuleWeb is running correctly?

After running amuleweb in a terminal, you should see something like this:

Web Server: Started
WSThread: Thread started
WSThread: created service
WSThread: created socket listening on :4711
amuleweb$

Can I run aMuleWeb as a daemon?

Since aMule 2.0.0-rc6, aMuleWeb supports --quiet switch (or -q also) which renders allows aMuleWeb to be easily run on the background.<

However, on previous aMule releases, although aMuleWeb works well, it's actually quite tricky to run it in the background because it's continuously asking for user commands and showing the prompt. The obvious way to avoid this would be running amuleweb with the output redirected to /dev/null, but this hogs the CPU due to the constant writing, so a better approach is to use the program screen, which is a terminal emulator. In order to run aMuleWeb inside a virtual terminal, the following command should be executed: screen -d -m -S amulewebsession amuleweb -p 7000 -pw password (assuming that aMule is listening for External Connections on port 7000 and the password is password). Then, aMuleWeb will start listening for HTTP connections, but will show the prompt and all messages in this virtual terminal. It's possible to switch to this terminal using the command screen -r amulewebsession, please refer to screen documentation for info about session switching, internal commands, etc.

Why is aMuleWeb failing to connect?

If you followed the above HowTo correctly, make sure that you are using an aMuleWeb binary distributed with the same release as the aMule binnary. For example, aMuleWeb binary from the aMule 2.0.0-rc3 release will not connect with aMule 2.0.0-rc4, aMule 2.0.0-rc2 or any other version (including v1 versions).

Why i always get "No password specified, login will not be allowed." in amuleweb login page with aMule 2.2 (or CVS), even if i followed correctly how to set passwords, or i already did that successfully in aMule 2.1.x?

Please make sure to follow the HowTo_get_aMule_web_interface#Configuration_of_the_aMule_web_interface, line by line (especially end of article), some behaviors changed in aMule 2.2. Make sure to configure amuleweb in monolitic amule or amulegui and before using amuleweb --write-config (unless you know exactly what you are doing). Verify in the file ~/.aMule/remote.conf if the keys Password and AdminPassword are set with a md5 encrypted password value.

Why does the web interface keep going back to the login page ?

Try deleting the cookies from the web browser.