Skip to content

Historic ProjectSetup documenting the original datatracker conversion

Jump to bottom
Robert Sparks edited this page May 1, 2023 · 1 revision

The information on this page is from 2007, and is now badly out-of-date.

Project Setup

Access Control

During development, this Trac installation and the source code repository is under access control. Of course, if you read this, you probably already have gotten yourself a login and password for the tools servers by using the [/newlogin Password Manager] ,;-)

Checking out the Source Code

We assume you've installed Django.

The source is stored in a SVN (Subversion) repository on merlot.tools.ietf.org.

You check out the code the first time by going to the directory where you want to place your project source directory, and do

 svn co http://svn.tools.ietf.org/svn/tools/ietfdb/trunk/ ietfdb

You should be asked to provide username and password if this is the first checkout from svn.tools.ietf.org. Use the same username and password you use to access this Trac wiki and issue-tracker.

That should give you a new directory 'ietfdb' with a subdirectory 'ietf' that holds the django project code.

Then cd into the directory that holds the code. Further svn operations (updating your checkout with new stuff from the repository, or checking in your code) is done from within the directories created by the checkout operation:

svn update
svn add FILENAME
svn commit OPTIONAL-FILENAMES

You can browse the code in the repository, checkins, diffs etc. by following the Browse_Source link in the menu above.

Running django from the source tree

  • Make sure you have Python 2.4, the default 2.3 that ships with RHEL/CentOS and OS X will give you errors.
  • Check out source
  • cd to the ietf directory
  • Create settings_local.py - it needs at least a SECRET_KEY= setting (run "django-admin.py startproject foo" and take it from foo/settings.py if you don't have another way)
  • run "python manage.py runserver"; it will default to binding to localhost only, if you want to bind to a public address try "python manage.py runserver 0.0.0.0:9876"
    • alternately, configure a real server to talk to fastcgi, etc. or use mod_python

Work Status

Each cgi script which needs to be converted has been added as a task to the ticket system of this Trac instance, and each group of scripts which together make up an application has been collected into a Milestone. You can see an overview of the status of all milestones by going to the [/tools/ietfdb/roadmap Roadmap] (see the Roadmap link in the menu above) or by looking at a report: {6} (see the View_Tickets link in the menu above).

To start working on a rewrite, pick a task from one of the milestones which has status new, and assign it to yourself. That will prevent two people from working on the same thing.

Use email and jabber liberally to communicate with the other people in the project. Jabber addresses:

Bill: [email protected]

Henrik: [email protected] or [email protected]

Michael: [email protected]

Vid: [email protected]

Clone this wiki locally