grokui.admin 0.3

The Grok administration and development UI (base)

grokui.admin: A basic grok admin UI

The replacement for the former grok.admin package.

The internal name of the admin UI is: Grok Application Interface Application or, for short GAIA.

GAIA is itself a Grok application and a subproject to the core Grok development. Its main goal is making developing of Zope 3 and Grok applications a faster and smarter job with more fun for everybody.

Login - what is my username/password?

Before you can use the admin UI, you first must log in.

The username and password of the manager principal (kind of super user) can be found in the file buildout.cfg in the root of your subversion checkout.

In case you do not know, what ‘subversion checkout’ means, look for a file site.zcml in your installation.

Users of grokproject, might find this file in <installdir>/parts/app/site.zcml.

Using the admin-UI

After login you can visit some of the main management topics, as described below:

On top of the admin-UI you can always find three links to the main management activities currently possible with GAIA:

Applications

• List of all instanciated applications

• You can add new instances of Grok applications

• You can rename instances of Grok applications

• For each installed application you can directly call:

  • the object browser (telling you more about this concrete object)

  • the class browser (telling you more about the class of your app)

• For each available application type you can directly call:

  • the class browser (telling you more about the class of your app)

• You can delete your installed applications.

Server

• Start/Restart the server. Caution! This does not work, if the server was started in ‘foreground mode’ (with ‘zopectl fg’).

• Pack the ZODB. This removes old data from the database, freeing up disk space. In a production environment, you might want to pack the ZODB automatically from cron. This can be done using a command like the following:

  curl -q -s -u admin:admin "http://localhost:8080/server?pack=1&days=1"

  which will remove old data older than one day. If you leave out the days parameter, all old data will be removed.

• Get basic information about the running Zope system.

• Enter a message to be displayed on top. You can, for example, leave a message here for your co-admins. To delete the message, just enter the empty string in the appropriate input box.

Documentation

• From here you get starting points to the more elaborated documentation features of Grok, namely:

  • The object browser:

    helps browsing the ZODB and other objects.

  • The class browser:

    gives documentation to classes, packages and other things, which are not instances.

Bugs, Caveats and Ways to Get Help

The Grok admin UI was developed basically during a Google Summer of Code project.

It is still full of bugs.

For bugreports use:

https://launchpad.net/grok

For discussions subscribe to the grok-dev mailing list, hosted on:

http://lists.zope.org.

The projects’ home is the subversion repository at:

http://svn.zope.org/grokui.admin/

Grok’s cave can be found at

http://grok.zope.org/

Enjoy!

grokui.admin changes

0.3 (2008-12-13)

Feature changes

• Added capability to pack ZODBs (thanks to Jasper Spaans).

0.2 (2008-12-01)

Feature changes

• Added capability to rename apps.

0.1.2 (2008-09-28)

• Made server controls dependent from availability of IServerControl. Otherwise the buttons for restarting or stopping the server process are not rendered.

0.1.1 (2008-08-05)

• Fixed wrong links in docgrok template.

• Fixed ftesting.zcml that did not work with Grok 0.13.

0.1 (2008-07-10)

Feature changes

Initial implementation by factoring out grok.admin from grok.