Squeak
  links to this page:    
View this PageEdit this PageUploads to this PageHistory of this PageTop of the SwikiRecent ChangesSearch the SwikiHelp Guide
Magma Tools
Last updated at 9:26 pm UTC on 26 April 2014

MagmaCompressor

As new objects are added to the repository, the files grow in size. Eventually, the files take up a lot of space due to old objects that are no longer referenced (garbage). To clean these out, see the MagmaCompressor class.

MagmaDataRepair

Data-quality management applies to any persistent model, and is a little more involved than at first it seems, because it's tempting to just spank-out a workspace script which enumerates appropriate objects in your DB and fixes/upgrades them.

But doing only that is loaded with caveats. After running a repair script, can one _really_ feel comfortable the model is "all fixed" and ready for production? Did the script really work? Did it catch all cases or was there possibly a bug in it?

To address these concerns, Magma employs a first-class DataRepair which is used to perform data repairs/migrations on Magma models in a controlled and reliable fashion. It is based on the repair process we used at Florida Power and Light for patching/upgrading the models in its GemStone databases.

The requirements of a data-repair are:

Here is an example of Magma's DataRepair constructor:
(MagmaDataRepair
	at: (MagmaRemoteLocation host: 'prod1' port: 51199)
	enumerate: [ : session : repair | session root accountsDo: [ : eachAccount | repair check: eachAccount ] ]
	check: [ : eachAccount : repair | eachAccount importFilters anySatisfy: [ : each | each class = MaxImportFilter ] ])
	repair: [ : eachAccount : repair | eachAccount importFilters withIndexDo: [ : eachFilter : index | eachAccount importFilters at: index put: eachFilter asKeywordFilter ] ]

To this object, I can send any of the 5 actions: #check, #count, #identify, #improve or #repair. The first three are read-only operations. The 4th will commit the repairs as-it-goes, the last one only commits after a successful pre-verification.

You the user must specify the enumerate:, check: and repair: blocks, because the DataRepair object encapsulates only the _process_ of repairing models in this controlled and reliable fashion.

A Repository Browser

There is a package on SqueakMap called "Magma Buffer Browser" that uses Maui to render the shape of the physical object-model directly from the buffers, without ever instantiating any instances of the actual domain classes.

It also presents meta-information from the commit-log record of each object, if available.

Just for interest, the following is a screenshot from an early version of Maui (circa 2004).

BufferEditor.screenshot1.png

Uploaded Image: MagmaBufferEditor.jpg
Contact me for more information.