[lhh: Wiki for the Linux-cluster project]

[lhh: Wiki for the Linux-cluster project]

[Christopher Faylor]

Hi Lon,
I've cc'ed this to the overseers mailing list where the people who
maintain the wiki will hopefully be able to answer this question.

cgf

----- Forwarded message from Lon Hohberger <lhh@redhat.com> -----

From: Lon Hohberger
To: sourcemaster
Subject: Wiki for the Linux-cluster project
Date: Tue, 11 Dec 2007 12:16:10 -0500

Hi,

Currently, we have a html-based site, which is fine, but a bit
cumbersome for us to keep updated and nearly impossible for our
community to create documentation, which was recently brought up on the
linux-cluster mailing list.

We do have an old wiki on gfs.wikidev.net, but no one has been keeping
it up to date.

I was wondering what would be required to get a Wiki running on
sourceware.org for the cluster project?

-- Lon

----- End forwarded message -----

Re: [lhh: Wiki for the Linux-cluster project]

[Jonathan Larmour]

Christopher Faylor wrote:
> Hi Lon,
> I've cc'ed this to the overseers mailing list where the people who
> maintain the wiki will hopefully be able to answer this question.

Here's what I did to make a wiki on sourceware, using the existing moin 
moin wiki. I'm using root's bash history as a guide to remind me how I did 
it :-). Hopefully this recipe will make someone's life easier, assuming 
I've remembered everything. I did mine based on Daniel B's earlier mail, 
but a few things had changed since then so this should work better:

PROJECTNAME=mywiki
mkdir /sourceware/projects/$PROJECTNAME-home/wikidata
cp -a /usr/share/moin/data/   \
   /sourceware/projects/$PROJECTNAME-home/wikidata/
cd /wiki
ln -s /sourceware/projects/$PROJECTNAME-home/wikidata $PROJECTNAME
cd ecos
chown -R apache.apache ecos/.
chmod o-rx ecos/data/
cp systemtap.py $PROJECTNAME.py

[ or instead of systemtap, any other default-ish looking .py file ]

[ Now edit $PROJECTNAME.py and configure your wiki appropriately - at a 
minimum just find every ref to systemtap and change to your project. You 
also need to change 'superuser' and 'acl_rights_before'. There are many 
more things than that which _can_ be set though ]

[ edit farmconfig.py and add your wiki into the 'wikis' array]

cd /etc/httpd/conf
co -l httpd.conf
[ edit httpd.conf. For example for the ecos wiki I added:
   ScriptAlias /wiki       "/wiki/moin.fcg"
in the ecos.sourceware.org virtual host. For other wikis, you probably 
need to edit the sourceware.org virtual host, adding something like:
   ScriptAlias /PROJECTNAME/wiki "/wiki/moin.fcg"
near the end like the others. ]
ci -u httpd.conf
service httpd restart



Now what I don't know anything about is how you could bring stuff on the 
old wiki over, assuming it's even possible.

Jifl
-- 
------["The best things in life aren't things."]------      Opinions==mine

Re: [lhh: Wiki for the Linux-cluster project]

[Jonathan Larmour]

Jonathan Larmour wrote:
> 
> PROJECTNAME=mywiki
> mkdir /sourceware/projects/$PROJECTNAME-home/wikidata
> cp -a /usr/share/moin/data/   \
>   /sourceware/projects/$PROJECTNAME-home/wikidata/
> cd /wiki
> ln -s /sourceware/projects/$PROJECTNAME-home/wikidata $PROJECTNAME
> cd ecos
> chown -R apache.apache ecos/.
> chmod o-rx ecos/data/
> cp systemtap.py $PROJECTNAME.py 

Ahem, these lines should of course be:

PROJECTNAME=mywiki
mkdir /sourceware/projects/$PROJECTNAME-home/wikidata
cp -a /usr/share/moin/data/   \
   /sourceware/projects/$PROJECTNAME-home/wikidata/
cd /wiki
ln -s /sourceware/projects/$PROJECTNAME-home/wikidata $PROJECTNAME
chown -R apache.apache $PROJECTNAME/.
chmod o-rx $PROJECTNAME/data/
cp systemtap.py $PROJECTNAME.py

Jifl
-- 
------["The best things in life aren't things."]------      Opinions==mine

Re: [lhh: Wiki for the Linux-cluster project]

[Lon Hohberger]

On Tue, 2007-12-11 at 23:16 +0000, Jonathan Larmour wrote:

> Now what I don't know anything about is how you could bring stuff on the 
> old wiki over, assuming it's even possible.

I wouldn't worry about data conversion, I think that will become "my
problem".  I expect to have to manually move stuff, which is fine since
our current external Wiki is pretty sparse.

The motive for the request was to ensure that we have the Wiki in the
right place /before/ it gets too big to become a burden to do a transfer
of information.

I'll probably be the one moving data off the old wiki to the one on
sourceware.org (assuming we get it), as well as porting things like the
cluster FAQ:

   http://sources.redhat.com/cluster/faq.html

(There's more information in the FAQ than in our external Wiki right
now)

-- Lon

Re: [lhh: Wiki for the Linux-cluster project]

[Jonathan Larmour]

[-- Attachment #1: Type: text/plain, Size: 578 bytes --]

Lon Hohberger wrote:
> On Tue, 2007-12-11 at 23:16 +0000, Jonathan Larmour wrote:
> 
>> Now what I don't know anything about is how you could bring stuff on the 
>> old wiki over, assuming it's even possible.
> 
> I wouldn't worry about data conversion,

Ok. I can set this up for you. I've attached a default cluster.py with some
simple changes, with "LonH" as the admin. Send it back with whatever
changes you want according to how you want it configured, or I can just go
with it as it is.

Jifl
-- 
--["No sense being pessimistic, it wouldn't work anyway"]-- Opinions==mine

[-- Attachment #2: cluster.py --]
[-- Type: text/x-python, Size: 5350 bytes --]

# -*- coding: iso-8859-1 -*-
# IMPORTANT! This encoding (charset) setting MUST be correct! If you live in a
# western country and you don't know that you use utf-8, you probably want to
# use iso-8859-1 (or some other iso charset). If you use utf-8 (a Unicode
# encoding) you MUST use: coding: utf-8
# That setting must match the encoding your editor uses when you modify the
# settings below. If it does not, special non-ASCII chars will be wrong.

"""
This is a sample config for a wiki that is part of a wiki farm and uses
farmconfig for common stuff. Here we define what has to be different from
the farm's common settings.
"""

# we import the FarmConfig class for common defaults of our wikis:
from farmconfig import FarmConfig

# now we subclass that config (inherit from it) and change what's different:
class Config(FarmConfig):

    # Wiki identity ----------------------------------------------------

    # Site name, used by default for wiki name-logo [Unicode]
    sitename = u'Cluster Wiki'

    # Wiki logo. You can use an image, text or both. [Unicode]
    # Example: u'<img src="/wiki/mywiki.png" alt="My Wiki">My Wiki'
    # For no logo or text, use ''
    logo_string = u''

    # The interwiki name used in interwiki links
    interwikiname = None
    #GCCWiki


    # Critical setup  ---------------------------------------------------

    # Misconfiguration here will render your wiki unusable. Check that
    # all directories are accessible by the web server or moin server.

    # If you encounter problems, try to set data_dir and data_underlay_dir
    # to absolute paths.

    # Where your mutable wiki pages are. You want to make regular
    # backups of this directory.
    data_dir = '/wiki/cluster/data'

    # Where read-only system and help page are. You might want to share
    # this directory between several wikis. When you update MoinMoin,
    # you can safely replace the underlay directory with a new one. This
    # directory is part of MoinMoin distribution, you don't have to
    # backup it.
    #data_underlay_dir = '/var/www/html/wiki/underlay/'

    # This must be '/wiki' for twisted and standalone. For CGI, it should
    # match your Apache Alias setting.
    # url_prefix = '/cluster/wiki'
    

    # Security ----------------------------------------------------------

    # Security critical actions (disabled by default)
    # Uncomment to enable options you like.
    superuser = [u"LonH"]
    allowed_actions = ['DeletePage', 'AttachFile', 'RenamePage']
    
    # Enable acl (0 to disable)
    acl_enabled = 1
    # IMPORTANT: grant yourself admin rights! replace YourName with
    # your user name. See HelpOnAccessControlLists for more help.
    # All acl_right_xxx must use unicode [Unicode]
    acl_rights_before = u"LonH:read,write,delete,revert,admin"
    bang_meta = 1
#    lupy_search = True
    
    acl_rights_default = u"Trusted:read,write,delete,revert Known:read,write,delete,revert All:read"
    # Link spam protection for public wikis (Uncomment to enable)
    # Needs a reliable internet connection.
    from MoinMoin.util.antispam import SecurityPolicy


    # Mail --------------------------------------------------------------
    
    # Configure to enable subscribing to pages (disabled by default)
    # or sending forgotten passwords.

    # SMTP server, e.g. "mail.provider.com" (empty or None to disable mail)
    mail_sendmail = "/usr/sbin/sendmail -t -i"
    # mail_smarthost = "localhost"

    # The return address, e.g "My Wiki <noreply@mywiki.org>"
    mail_from = "Cluster Wiki <noreply@sourceware.org>"

    # "user pwd" if you need to use SMTP AUTH
    mail_login = ""


    # User interface ----------------------------------------------------
    
    # Add your wikis important pages at the end. It is not recommended to
    # remove the default links.  Leave room for user links - don't use
    # more than 6 short items.
    # You MUST use Unicode strings here, but you need not use localized
    # page names for system and help pages, those will be used automatically
    # according to the user selected language. [Unicode]
    navi_bar = [
        # Will use page_front_page, (default FrontPage)
        u'%(page_front_page)s',
        u'RecentChanges',
        u'FindPage',
        u'HelpContents',
    ]

    # The default theme anonymous or new users get
    theme_default = 'modern'
    

    # Language options --------------------------------------------------

    # See http://moinmoin.wikiwikiweb.de/ConfigMarket for configuration in 
    # YOUR language that other people contributed.

    # The main wiki language, set the direction of the wiki pages
    default_lang = 'en'

    # You must use Unicode strings here [Unicode]
    page_category_regex = u'^Category[A-Z]'
    page_dict_regex = u'[a-z]Dict$'
    page_form_regex = u'[a-z]Form$'
    page_group_regex = u'[a-z]Group$'
    page_template_regex = u'[a-z]Template$'
    page_front_page = u'HomePage'

    # Content options ---------------------------------------------------

    # Show users hostnames in RecentChanges
    show_hosts = 1                  

    # Enumerate headlines?
    show_section_numbers = 0

    # Charts size, require gdchart (Set to None to disable).
    chart_options = {'width': 600, 'height': 300}   
    allow_xslt = 1

    edit_locking = 'lock 10'

Re: [lhh: Wiki for the Linux-cluster project]

[Lon Hohberger]

On Wed, 2007-12-12 at 19:48 +0000, Jonathan Larmour wrote:
> Lon Hohberger wrote:
> > On Tue, 2007-12-11 at 23:16 +0000, Jonathan Larmour wrote:
> > 
> >> Now what I don't know anything about is how you could bring stuff on the 
> >> old wiki over, assuming it's even possible.
> > 
> > I wouldn't worry about data conversion,
> 
> Ok. I can set this up for you. I've attached a default cluster.py with some
> simple changes, with "LonH" as the admin. Send it back with whatever
> changes you want according to how you want it configured, or I can just go
> with it as it is.

It looks fine, but I'm not intimately familiar with the setting up
MoinMoin.  I've asked around for a logo and such, but none exists at
this point.

When we have one, I may try to hit one of you guys up again, but for
now, I think the defaults look okay.

-- Lon

Re: [lhh: Wiki for the Linux-cluster project]

[Jonathan Larmour]

Lon Hohberger wrote:
> On Wed, 2007-12-12 at 19:48 +0000, Jonathan Larmour wrote:
>> Ok. I can set [the wiki] up for you. I've attached a default cluster.py 
>> with some simple changes, with "LonH" as the admin. Send it back with
>> whatever changes you want according to how you want it configured, or I
>> can just go with it as it is.
> 
> It looks fine, but I'm not intimately familiar with the setting up
> MoinMoin.  I've asked around for a logo and such, but none exists at
> this point.
> 
> When we have one, I may try to hit one of you guys up again, but for
> now, I think the defaults look okay.

All done. You should have been sent a password, and your wiki name is
instead LonHohberger in line with wikiname style. I can change it if you
want. Otherwise good luck!

Jifl
-- 
--["No sense being pessimistic, it wouldn't work anyway"]-- Opinions==mine

Re: [lhh: Wiki for the Linux-cluster project]

[Lon Hohberger]

On Wed, 2007-12-12 at 22:02 +0000, Jonathan Larmour wrote:

> All done. You should have been sent a password, and your wiki name is
> instead LonHohberger in line with wikiname style. I can change it if you
> want. Otherwise good luck!

Thanks a ton, Jonathan!

Now to create some stuff ... :)

-- Lon