ezmlm-browse install

[m3mary]

hello
want to install ezmlm-browse0.12
any one can help


thanks

[m3mary]

i have its folder and files unedited on server

[m3mary]

README FILE :
ezmlm-browse
Web browser for ezmlm-idx archives
Bruce Guenter <bruce -@- untroubled.org>
Version 0.12
2006-11-14

This is ezmlm-browse, a web interface for browsing ezmlm-idx (version
0.40 or later) archives. The presentation is modeled from that of the
ezmlm-cgi archive browser that is part of ezmlm-idx, but with several
additions. However, the output is completely template driven, so you
can make it fit into your current web scheme.

A mailing list has been set up to discuss this and other packages.
To subscribe, send an email to:
bgware-subscribe -@- lists.untroubled.org
A mailing list archive is available at:
http://lists.untroubled.org/?list=bgware

Development versions of ezmlm-browse are available via Subversion at:
svn://bruce-guenter.dyndns.org/ezmlm-browse/trunk

Requirements:

- Python 2 (tested with 2.3, should work with version 2.2 or later)
- ezmlm 0.53 + idx 0.40 or later. If you are using an older version of
ezmlm-idx, you MUST upgrade and run the "ezmlm-idx" and
"ezmlm-archive" commands on all lists you wish to browse.
- bglibs to compile the wrapper program.

Security Notes:

- You will need to choose one of the following options:

- Make your mailing list archives readable to the UID that the web
server operates under. This will likely allow anybody on your
system to read the contents of the mailing lists, including the
unfiltered header lines (which include full email addresses, etc.)

- Make the wrapper CGI program owned by the mailing list archive owner
and setuid. If I have not been adequately careful, this may allow
an attacker to execute code as that user.

- Use the Apache suexec module.

This program is Copyright(C) 2006 Bruce Guenter, and may be copied
according to the GNU GENERAL PUBLIC LICENSE (GPL) Version 2 or a later
version. A copy of this license is included with this package. This
package comes with no warranty of any kind.

[m3mary]

INSTALL FILE :
Building the Sources:

- Unpack ezmlm-browse into a non-web-visible directory. This is the
directory from which ezmlm-browse will execute.

- Make sure all the conf-* files have values appropriate for your
system (they contain notes about what they are used for). They are
set to appropriate defaults for most systems using GCC.

- If your python program is not in the path, put the full path to it in
the first line of a file called "auto-python".

- Run "make".

Recommended Installation:

- Create a new subdirectory in your web directory and change into it.

- Symlink "browse.cgi" into that directory as "index.cgi" if your site
is using Apache suexec or equivalent. Otherwise symlink "wrapper" in
as "index.cgi" and make it setuid.

- Symlink the "files" directory in as-is.

- Copy in the "config.py" file and edit it as appropriate for your site
and lists. Set "FILESPREFIX" to "files/".

- If using Apache, make sure CGI execution is enabled in that directory
by adding the following lines to a ".htaccess" file in the same
directory:
Options +ExecCGI
AddHandler cgi-script .cgi
DirectoryIndex index.cgi
Other server software should be similarly configured.

Generic Installation:

- Symlink either "wrapper" or "browse.cgi" into a location where CGI
programs may be executed. Usually this is either something in a
"cgi-bin" directory or a file elsewhere named "something.cgi". The
destination name does not need to be either "wrapper" or "browse.cgi"
as the script will automatically determine its own name for the links
it creates.

- Symlink the "files" directory into a web-visible directory, and make
note of that location for the configuration below. The visible name
does not need to remain as "files".

Configuration:

- If necessary, make the "wrapper" program setuid to whatever user has
read access to the mailing list archive files. Do *NOT* make any
Python script setuid. This is necessary if the web server process
does not have read access to the web archives and is not using the
Apache suexec module or equivalent.

- Edit config.py to declare which mailing lists are visible to the web,
and set the other defaults as appropriate (most notably, the web path
to the "files" directory installed above should go in FILESPREFIX).

- Mailing lists should have the ezmlm-make "-i" option enabled to keep
the necessary indices up to date. If this is not enabled, run the
following command for each list:

ezmlm-make -+ -i /path/to/list

[Jeff]

Are you getting stuck at a specific point?

[m3mary]

im stuck at the begining :(
- Unpack ezmlm-browse into a non-web-visible directory. This is the
directory from which ezmlm-browse will execute.
i did this, unpacked the file at big/dom/xuser/user/

i dont know at all what to do next, there are 3 config files
each config file have some data which i didnt work with befor, and asking about server infos and system which are strange for me !

what is this
- Run "make".

i dont have "browse.cgi" , where i get it


what is "wrapper"
what is : setuid
and what this mean :
- You will need to choose one of the following options:

- Make your mailing list archives readable to the UID that the web
server operates under. This will likely allow anybody on your
system to read the contents of the mailing lists, including the
unfiltered header lines (which include full email addresses, etc.)

- Make the wrapper CGI program owned by the mailing list archive owner
and setuid. If I have not been adequately careful, this may allow
an attacker to execute code as that user.

- Use the Apache suexec module.

!! whats going on !!

[sheila]

i did this, unpacked the file at big/dom/xuser/user/

That might not be a good choice of directory, because it is your $HOME directory, and apache and the mail system do not have permission to access that directory. Since ezmlm-browse will be running from the directory you choose (as it states in the docs) you might rather create a directory for this purpose in
/big/dom/xdomain/
such as
/big/dom/xdomain/ezmlmbrowse
and unpack in there.
i dont know at all what to do next, there are 3 config files
each config file have some data which i didnt work with befor, and asking about server infos and system which are strange for me !

You'd need to show the specific values that you don't understand, so that we can advise.
what is this
That is a command line command. You have to be in a telnet or SSH session in the shell environment and type that command, AFTER you've configured and set up the config files properly.


i dont have "browse.cgi" , where i get it
It should be created as a result of running the "make" command.


what is "wrapper"
what is : setuid
and what this mean :


!! whats going on !!
At FutureQuest we use the Apache suexec model, so you don't have to worry about that part.

[m3mary]

gcc -W -Wall -Wshadow -O -g -I/usr/local/include >>>> conf-cc
gcc -s -L/usr/local/lib >>>> conf-ld

config.py >>>
FILESPREFIX: '/files/',
FEEDTYPE: 'atom',



also how i do this :


end config.py file >>>>
# For each mailing list you want to have visible to the web, add an
# entry to this table. Each entry consists of a dictionary
# containing:
#
# LISTDESC: The description to show for this list when producing the index
# LISTDIR: The directory in which the "archive" directory can be found.
# LISTEMAIL: The email address to use to send messages to the list.
# LISTSUB: The email address to use to subscribe to the list.
#
# If they are not present, the LISTDIR, LISTEMAIL, and LISTSUB values
# are automatically generated from the list name and the base directory
# or host above.


i did add the hostname + path to maillists folder in config.py

the path is now : /big/dom/xuser/ezmlmbrowse/

[m3mary]

any one can help, please
are that infos right ??
and how i do run "make"??

[Bruce]

and how i do run "make"??To run "make" simply type the word "make" on the telnet/SSH command line and press Enter. That's all.

For the list of mailing list archives in config.py, replace the example list at the end of config.py with a list containing the names of your mailing lists and their description(s). If you follow the same format as what is in there, you don't need to worry about an of the other configuration items.

[m3mary]

[#user#@FQ-MQS0033:~ ]$ make
make: *** No targets specified and no makefile found. Stop.


something wrong or missing

[Arthur]

You have to run the command in the directory where you unpacked the archive, i.e. /big/dom/xdomain/ezmlmbrowse

If you're in your home directory, type cd ../ezmlmbrowse or cd /big/dom/xdomain/ezmlmbrowse.

Replace xdomain with your xdomain where appropriate.

-Arthur

[m3mary]

(this is the first time i know that i can move in ssh like dos which is wonderfull)

OK i did it..
what next ?
i still dont see "browse.cgi"

[Bruce]

(this is the first time i know that i can move in ssh like dos which is wonderfull)

OK i did it..
what next ?
i still dont see "browse.cgi"It appears that browse.cgi was missing from the distributed package. Create a new browse.cgi file containing the following:#!/usr/bin/python2
import sys
import os
sys.path.insert(0, os.getcwd())
import main
main.main()Make it executable by running:chmod +x browse.cgiThen symlink it into your web space by running:ln -s $PWD/browse.cgi /big/dom/xdom/www/whereIwantmyliststoshowup/index.cgi

[m3mary]

[#user#@FQ-MQS:/big/dom/xuser/ezmlmbrowse ]$ chmod +x browse.cgi

[#user#@FQ-MQS:/big/dom/xuser/ezmlmbrowse ]$ ln -s $PWD/browse.cgi /big/dom/xuser/www/main_section/trasol/index.cgi
ln: `/big/dom/xuser/www/main_section/trasol/index.cgi': File exists


but from cnc i see nothing but my old 2 folders, nothing else

[m3mary]

ahaa Ok it should be

ln -s $PWD/browse.cgi /big/dom/xdom/www/whereIwantmyliststoshowup/browse.cgi

is it finish now

take a look : http://www.m3mary.com/main_section/trasol/browse.cgi

[m3mary]

Ok going to see it and i will returen with any kind of errors i have....
ThanK you Alot Amazing

coming soon...

[sheila]

By gum, I think you've got it.

Your list messages can be accessed from here:
http://www.m3mary.com/main_section/trasol/browse.cgi?list=m3mary

:yeah:

[m3mary]

thank you all for helping specially Bruce for his Profisional Script

have aqustion:

how i do instead of color background in "style.css", do it by image background?
is this program secure ? for hackers ? attacks ? spam emails ?

i removed some line like : subscribtion should be from a page..
there was a link i lost it by mistake : this>>
http://lists.untroubled.org/?list=bgware&cmd=feed

what is that ?? is it important cause i remove it after i lost it ??

[m3mary]

also how to make the texts bold

[Bruce]

how i do instead of color background in "style.css", do it by image background?You should be able to do this by changing the style of the "BODY" element to something like:BODY { background-image: url(marble.gif) }

is this program secure ? for hackers ? attacks ? spam emails ?The program has no code in it to write messages, so it cannot be used to alter your files or upload attacks or spam. There is no mechanism to send mail through it, so it cannot be used to send spam. The values for opening archive files are also protected against opening arbitrary files and revealing content. The default templates should also protect against some forms of XSS contained with the emails themselves, though I am not confident it will protect against everything in HTML emails.

i removed some line like : subscribtion should be from a page..
there was a link i lost it by mistake : this>>
http://lists.untroubled.org/?list=bgware&cmd=feed

what is that ?? is it important cause i remove it after i lost it ??The "feed" command produces a news feed from the mailing list archive, allowing the mailing list to be read in feed reader software such as NewzCrawler, FeedDemon, Google Reader.

also how to make the texts boldThis would be controlled by various sections in the CSS files (or maybe the templates). Which text do you want to make bold?

[m3mary]

Ok ... I did it all and you can see it here:
http://www.m3mary.com/main_section/index7.php

I increased the whole font size so it looks like bold now
I include it in a FRAME in my Site and it looks like no difference

There are errors I notice :
When I send a new message included pictures it some times lose them and some times duplicate them >>>

Most the messages lost in HTML FORMAT and whole become question marks
??????????
??? 100 ???????
?????? 2008 ????????
??? ?????? ?????


http://www.m3mary.com/forvb/error1.jpg
http://www.m3mary.com/forvb/error2.jpg

[Bruce]

Ok ... I did it all and you can see it here:
http://www.m3mary.com/main_section/index7.phpExcellent! :yeah:

There are errors I notice :
When I send a new message included pictures it some times lose them and some times duplicate themEzmlm-browse doesn't handle messages with included pictures directly. It will display HTML with image links, though.

Most the messages lost in HTML FORMAT and whole become question marksI have not observed this behavior myself. Could you post a link to a page on your lists that demonstrates this behavior? I have a couple of ideas what might be wrong, but can't tell without an example. The pictures show visually how it appears, but the HTML source will let me figure out why it broke.

[m3mary]

look at this for example :
http://www.m3mary.com/main_section/trasol/index.cgi/m3mary/30

most attachs not visible also if you download the last 4 attachs from :
http://www.m3mary.com/main_section/trasol/?list=m3mary&cmd=showmsg&msgnum=30

they duplicated

also you can see ?????1.5???? ???? ???? which is text not working

the real message recived Ok

also i want to know how somebody puts reply to single message without annoying all others

[m3mary]

^^^

[m3mary]

^^^

[Bruce]

look at this for example :
http://www.m3mary.com/main_section/trasol/index.cgi/m3mary/30I am unable to see a problem with this one directly, as the only option my browser gives for viewing the raw messages is to download them.

if you download the last 4 attachs from :
http://www.m3mary.com/main_section/trasol/?list=m3mary&cmd=showmsg&msgnum=30

they duplicatedThis I can confirm and it does appear to be a bug in ezmlm-browse. I am trying to replicate this problem on a test list so I can fix it properly. I encountered some unrelated bugs in generating the test list that have slowed down my progress.

also you can see ?????1.5???? ???? ???? which is text not workingThis I don't see. The text on the page containing "1.5" shows up in what appears to be the same character set as the rest of the page. Perhaps there are some font display issues involved?

also i want to know how somebody puts reply to single message without annoying all othersThe standard list set up is that replies to individual messages get sent to the original poster. Group replies or intelligent list replies go back to the list.

[m3mary]

Thanks bruce i like your work very interesting and profisional
and am satisfied without the html code for im going to close it to force visitors to subscribe.