Hi there,
sorry for lack of news/help from my side but I was away for xmas' holidays... but now I'm here ;) , so let's go to write a mini-howto for amuleweb.
At the moment amule lack of a webserver tab in preferences, so while waiting for it, follow these instructions (based on old Bigbob's instructions) to configure and use the amule's web interface.
1)
Shutdown aMule to avoid overwriting of config files while shutting down.
2) copy from sources of aMule (1.2.x, where x>=4, or CVS) the directory "src/webserver/" in your "~/.aMule/webserver/"
3) copy from sources of aMule (1.2.x, where x>=4, or CVS) the file "src/aMule.tmpl" in your "~/.aMule/aMule.tmpl"
4) open a terminal and type:
echo -n "THEPASWORDYOUWANT" | md5sum | cut -d " " -f 1 This reply something like that :
324f85f6095f9e5fe25b6c85af44b4455) edit your "~/.eMule" file and locate the "
[ExternalConnect]" section and change fields:
AcceptExternalConnections=1 <- to enable amule listening for external connections
ECUseTCPPort=0 <- 0/1 (disable/enable) the use of a tcp port (if disabled use a unix socket in your "~/.aMule/muleconn") for external communications
ECPort=4712 <- put here the port you want amule listen on for external connections
ECPassword=39e5049d0614baf21906500e2261d500 <-put here the password for external connections' authentications you have generated in terminal
6) edit your "~/.eMule" file and locate the "
[WebServer]" section and change fields:
Password=324f85f6095f9e5fe25b6c85af44b445 <- put here the password generated in term for the admin (full privileged users)
PasswordLow=1db5a746266e941b3ef7dd3586863ca7 <- put here the password generated in term for "low users" (low privileged users)
Port=10000 <- put the port you want amuleweb listen on (now it works ;)
Enabled=1 <- this is useless now (see below)
UseGzip=1 PageRefreshTime=120 <- put here the web page refresh time (in seconds)
UseLowRightsUser=0 <- 0/1 (disabled/enabled) "low user" access
7) Restart aMule
8) Start web interface (amuleweb or amulewebDLG) (NOTE: at the moment amulewebDLG has problems):
- amuleweb get 2 args: hostname and port. Launching amuleweb -h
-p will cause to amuleweb to communicate with amule through external connection module on listening on :.
By default: is localhost and is 4712 (the default ECPort value)
- if amule is up, running and listening for external connection, amuleweb starts listening on "Port" port for web requests
- point your web browser on http://hostrunningamuleweb:port/ and authenticate yourself with "Password" (for full privileged user) or "PasswordLow" (for low privileged user, if enabled)
- that's all :)
@stefanero:
- WebTemplateFile is set to eMule.tmpl by default, but isn't used yet. However will be used aMule.tmpl when I'll enable it.
- the tag "Enabled" in [WebServer] is not used now. It is useless 'cause we enable the web interface enabling external connections and then launching amuleweb or amulewebDLG, so (i think) no need for this tag.
- ./amuleweb -p 8890 does not create the webinterface listening at port 8890. It tells amuleweb to communicate with amule through external connection module on tcp port 8890 (only if ECUseTCPPort and ECPort are set). To change the amuleweb listening port change the "Port" value in the [WebServer] section of your ~/.eMule
NOTES on web interface (browser side):
- lacks in search and statistics features (working on)
If any news, I'll edit as necessary.
