Changes between Version 1 and Version 2 of WikiStart


Ignore:
Timestamp:
26/10/10 18:35:31 (9 years ago)
Author:
dlove
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiStart

    v1 v2  
    1 = Welcome to Trac 0.12.1 =
     1= Welcome to the Son of Grid Engine project (SGE) =
    22
    3 Trac is a '''minimalistic''' approach to '''web-based''' management of
    4 '''software projects'''. Its goal is to simplify effective tracking and handling of software issues, enhancements and overall progress.
     3This is a community project to continue the old
     4[http://gridengine.sunsource.net Sun Grid Engine]
     5[http://www.gnu.org/philosophy/free-sw.html free software] project,
     6now that Oracle have taken it over and are not contributing to it and
     7may well close down the Sunsource web site.
    58
    6 All aspects of Trac have been designed with the single goal to
    7 '''help developers write great software''' while '''staying out of the way'''
    8 and imposing as little as possible on a team's established process and
    9 culture.
     9The idea is to encourage sharing, on the basis of long experience of
     10free software projects and scientific computing support.  Please
     11contribute!
    1012
    11 As all Wiki pages, this page is editable, this means that you can
    12 modify the contents of this page simply by using your
    13 web-browser. Simply click on the "Edit this page" link at the bottom
    14 of the page. WikiFormatting will give you a detailed description of
    15 available Wiki formatting commands.
     13As long as it's there, look at the
     14[http://gridengine.sunsource.net old gridengine site]
     15for extra documentation etc.  Currently anything
     16for the gridengine v6.2u5 release will apply to this effort.  (The
     17[http://wikis.sun.com/display/gridengine62u5/Home v6.2u5 wiki documentation]
     18isn't too easily findable from there.)
    1619
    17 "[wiki:TracAdmin trac-admin] ''yourenvdir'' initenv" created
    18 a new Trac environment, containing a default set of wiki pages and some sample
    19 data. This newly created environment also contains
    20 [wiki:TracGuide documentation] to help you get started with your project.
     20== Repositories ==
    2121
    22 You can use [wiki:TracAdmin trac-admin] to configure
    23 [http://trac.edgewall.org/ Trac] to better fit your project, especially in
    24 regard to ''components'', ''versions'' and ''milestones''.
     22There are several distinct source [source:/ repositories] converted
     23from the last Sunsource CVS versions of the same name.  The `sge` one
     24actually only goes back to the `V60` tag—i.e. not including
     25version 5.3—and also has some re-buildable files removed, to keep it a bit more
     26manageable.
    2527
     28These are currently just available via [http://darcs.net/ darcs], but
     29should be mirrored, at least to Mercurial, eventually.  Darcs is a
     30nice distributed version control system, but doesn't currently scale
     31too well with a repository of this size and age.  It's fine for
     32looking at the change history and recording new changes, but currently
     33slow at producing diffs for previous changes, for instance.
    2634
    27 TracGuide is a good place to start.
     35To clone the sge repo, get
     36a [http://wiki.darcs.net/Binaries recent version of darcs]—at least
     37version 2 and preferably 2.4—and then run
     38{{{
     39darcs get --lazy --set-scripts-executable http://arc.liv.ac.uk/repos/darcs/sge
     40}}}
     41which will create a directory `sge` of the current
     42source.  You can send changes recorded there with
     43`darcs send` for pushing by hand if they look reasonable until arrangements
     44can be made for direct contributions.
     45You could also just mail (see [#contact Contact]) normal
     46patches, maybe even
     47against the 6.2u5 source, if you have any already.
    2848
    29 Enjoy! [[BR]]
    30 ''The Trac Team''
     49The head of the
     50source tree is actually available directly via the `Repository URL` links
     51for each repository.  If you
     52really need to download the source without darcs, this should do the trick:
     53{{{
     54wget -e robots=off -r -X /repos/darcs/sge/_darcs -np http://arc.liv.ac.uk/repos/darcs/sge
     55find arc.liv.ac.uk/repos/darcs/ -name index.html\\?\* | xargs rm
     56}}}
    3157
    32 == Starting Points ==
     58The files omitted from those in the head of the sunsource `sge` repo are
     59the following;  any others missing  are probably a mistake unless they're noted in
     60the change history:
     61* `www` top-level directory:  Not really relevant for a distribution, although some of it can probably be converted into useful documentation for distribution later;
     62* `review` top-level directory:  Just a set of tick sheets for Sun internal use;
     63* `gep` top-level directory:  The portal, which may not actually be functional now, and is anyway based on a proprietary server;
     64* HTML documentation: This is either rebuild-able (like Javadocs) and/or probably not useful outside the gridengine web site (like HTML-ized man pages).
    3365
    34  * TracGuide --  Built-in Documentation
    35  * [http://trac.edgewall.org/ The Trac project] -- Trac Open Source Project
    36  * [http://trac.edgewall.org/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions
    37  * TracSupport --  Trac Support
     66=== History ===
    3867
    39 For a complete list of local wiki pages, see TitleIndex.
     68The original CVS repo is currently still
     69available if you need more history, and has been backed up in case it
     70disappears, along with copies of items in the issue-tracker, though
     71only as HTML dumps of the pages.  The active ones have been transferred
     72to the [ticket: issue tracker] here, but have somewhat suffered in the
     73process.  If the Sunsource mailing list archive disappears, you can still use
     74at least [http://gridengine.markmail.org MarkMail] and
     75[http://dir.gmane.org/gmane.comp.clustering.gridengine.users Gmane],
     76but it would be good if we could arrange a dump of them.
     77
     78== Building ==
     79
     80Building the source is currently a pain,
     81which is something to improve urgently.  With appropriate development
     82packages installed—they need documenting—it should build on GNU/Linux
     83with something like
     84{{{
     85cd source
     86./aimk -only-depend && scripts/zerodepend && ./aimk depend &&
     87./aimk -system-libs -no-gui-inst
     88}}}
     89
     90== Bug tracking and mail lists ==
     91
     92There aren't currently any accessible mail lists associated with the
     93project, but should be soon.  You can create an account to put tickets
     94in the [ticket: issue tracker], or use the `tourist` account with `sge` as the
     95password.
     96
     97== Related ==
     98
     99There's another project,
     100[http://sourceforge.net/projects/gridscheduler/ Open Grid Scheduler],
     101which is also continuing work on gridengine but seems to
     102have different aims.  Unlike this one, it doesn't use a distributed
     103revision control system, and doesn't include repository history from
     104before the gridengine v6.2u5 release, or the documentation.  It would
     105be better if there was only one, but I want those things missing from
     106gridscheduler (and more, like a bug-tracker that doesn't involve
     107creating accounts);  I assume others will too, for ease of
     108contributing.
     109
     110The `sge` source here is currently basically a considerable superset of
     111gridscheduler.  It includes the changes from it, or close
     112equivalents, plus some important fixes for persistent or immediate crashes
     113in some circumstances and other less important ones, as well as documentation.
     114It's currently more likely to be broken than gridscheduler, though.
     115
     116== [=#contact Contact] ==
     117
     118In the current absence of mail lists,
     119please send queries, contributions, &c to: Dave Love,
     120`d.love(SGE)@liverpool.ac.uk`.  In case our spam-blocking
     121appears to defeat you, I'm also `fx(SGE)@gnu.org`.
     122
     123— [http://www.gnu.org/ Happy hacking]