Not long after shipping the SOAP update for GLASS, I started working on Metacello. With the SOAP update, it became obvious that the GLASS ‘umbrella’ package was going to have to be replaced, and soon. Well, 7 months later I am reaching the point were I am finally ready to replace the GLASS package with a Metacello configuration .
I’m going to phase in the use of Metacello with GLASS. With the initial release, we’ll use Metacello for bootstrapping GLASS into a virgin extent. This way folks starting a greenfield project can use Seaside 2.8.4 or Pier 1.2 right away. Other releases that are in the pipeline:
- GemStone/S 64 2.4.x with partial continuations for Seaside3.0.
- Metacello configuration for bootstrapping Seaside 3.0 (ConfigurationOfSeaside30). A Squeak/Pharo version of this configuration is available now.
- final release of GLASS.230 package that will boot Metacello into an existing GLASS installation and allow for upgrading to GLASS 1.0-beta.0 and beyond.
ConfigurationOfGLASS version 1.0-beta.0 is based upon GLASS.230-dkh.231, with the following additions:
- Seaside 2.8.4
- Pier 1.2
- Metacello support
- VB-Regex loaded as part of ‘core’
- Scriptaculous updates from Ken Treis
- GemTools updates from Gerhard Obermann
- optional auto abort performed before commands
- add remove method (without any checks) renamed “remove method …” to “safe remove method …”
- add command “browse class history”
- add class history index to class browser title
- browse changes fixed … reversed comparison direction so that ”Install” will install repository version. the strike-out text is what is in current image.
- supports bootstrapping of code into virgin extent (see Bootstrapping Instructions).
Read the following sections to gain an understanding of the 1.0-beta configuration structure. If you are impatient and just want to load and go, then you can skip to the Bootstrapping Instructions.
With release 1.0-beta.0 there are 9 different loadable configurations defined in ConfigurationOfGLASS. If you read the code in the method ConfigurationOfGlass>>baseline10beta00:, you can see the Metacello specification summarized in the following sections.
Primary GLASS Projects
Any one (or combination) of the following projects and groups may be used as a load configuration for bootstrapping
Each of these projects is managed by it’s own ConfigurationOfxxx class.
- Core project. ConfigurationOfGsCore manages the Core, Base-Bootstrap, Bootstrap, GemStone-Exceptions (2.x only), GemStone-Indexing-Extensions, GsRandom, Sport, Squeak and VB-Regex packages. The Core packages are fundamental to the operation of GLASS and is always loaded.
- FastCGI project. ConfigurationOfGsFastCGI manages the FastCGIPool and FastCGI packages. The FastCGI packages are optional and are used to support FastCGI packages for Seaside2.8 and Seaside3.0.
- Hyper project. ConfigurationOfGsHyper manages the OpenSkills and Hyper packages. The Hyper packages are optional and are used to support the Hyper packages for Seaside2.8 and Seaside3.0.
- Magritte project. ConfigurationOfGsMagritte manages the Magritte-Model, Magritte-Tests and Magritte-Seaside packages. The Magritte packages are optional and represent the GemStone/S port of Magritte. By default only Magritte-Model and Magritte-Tests packages are loaded. To load Magritte-Seaside, it must be explicitly referenced.
- Metacello project. ConfigurationOfMetacello manages the Metacello packages and is imported from the Metacello project. By default the Metacello-Core, Metacello-MC and Metacello-Platform packages are loaded. The Metacello packages are fundamental to the operation of GLASS.
- Misc project. ConfigurationOfGsMisc manages the MockGemStone, SMTPMail, Utf8Encoding, Announcements, XML-Parser, SIXX, SmaCC, System-Digital-Signatures, and GemStone-Release-Support packages. The Misc packages are represent useful pieces of functionality that are contained in a single package and depend only upon the Core project. The Misc project is rarely loaded in it’s entirety. Typically individual packages are loaded from the project.
- Monticello project. ConfigurationOfGsMonticello manages the Change-Notification, PackageInfo-Base, and Monticello packages. The Monticello packages are fundamental to the operation of GLASS.
- OB project. ConfigurationOfGsOB manages the OmniBrower, OB-GemStone-Platfrom, OB-Monticello, OB-SUnitIntegration, OB-SUnitGUI, OB-Stanadard, OB-Tools and JadeServer packages. The OB packages are optional and provide the implementation for the GemTools.
- Pier project. ConfigurationOfGSPier manages the Pier-Model, Pier-Blog, Pier-DesignChooser, Pier-Design, Pier-Documents, Pier-EditorEnh, Pier-Google, Pier-Links, Pier-Randomizer, Pier-Slideshow, Pier-TagCloud, and Pier-Twitter packages. The Pier packages are optional and represent the GemStone/S port of Pier.
- Scaffolding project. ConfigurationOfGsScaffolding manages the GemStone-Scaffolding package. The Scaffolding packages are optional and representing the implementation of Scaffolding for GemStone. Even though this project consists of a single primary package, the fact that it depends upon Magritte and Scriptaculous warrants the creation of separate Metacello configuration.
- Seaside2.8 project. ConfigurationOfGsSeaside28 manages the Seaside2.8, SeasideAsync, Scriptaculous, RSRSS2, CallDemo, CheckboxExample, CSSDock, ErrorHandler, HelloWorld, ImageDemo, LogoutDemo, MarqueeDemo, menuDemo, ScreenResolution, Store, GemStone-Store, GemStone-Examples, FastCGISeaside and HyperSeaside packages. The Seaside2.8 packages are optional and represent the GemStone/S port of Seaside. By default only the Seaside2.8 pacakge is loaded. All of the other packages must be explicitly referenced.
- Seaside2.8 Testing project. ConfigurationOfGsSeasideTesting28 manages the SeasideTesting and PierTesting packages.
- SOAP project. ConfigurationOfGsSoap manages the SoXML, SOAP-CORE, SOAP-Client SOAP-Server, SOAP-Example and SOAP-TestCases packages. The SOAP packages are optional and represent the GemStone/S port of SoapCore.
Convenience GLASS Projects
- FastCGISeaside is a project based on a specialization of ConfigurationOfGsSeaside28 and references the FastCGISeaside package.
- HyperSeaside is a project based on a specialization of ConfigurationOfGsSeaside28 and references the HyperSeaside package.
- Metacello Tools is a project based on a specialization of ConfigurationOfMetacello and references the OB-Metacello package.
- Release Support is a project based on a specialization of ConfigurationOfGsMisc and references the GemStone-Release-Support package.
- Pier Testing is a project based on a specialization of ConfigurationOfGsPier and references the PierTesting package.
The following groups have been defined for the common load configurations.
- Dev group is made up of the Core, Monticello, Metacello, Release Support, OB and Metacello Tools projects.
- Magritte Dev group is made up of the Dev and Magritte projects.
- SOAP Dev group is made up of the Dev and SOAP projects.
- Seaside Dev group is made up of the Dev, Seaside2.8, FastCGISeaside and HyperSeaside projects.
- Seaside Testing Dev group is made up of the Seaside Dev, Seaside2.8 Testing projects.
- Scaffolding Dev group is made up of the Dev, Scaffolding, FastCGISeaside and HyperSeaside projects.
- Pier Dev group is made up of the Dev, Pier, FastCGISeaside and HyperSeaside projects.
- Pier Testing Dev group is made up of the Pier Dev and Pier Testing projects.
- ALL group is made up of all of the projects defined in ConfigurationOfGLASS.
Please comment to this post or send mail to the GLASS Beta Mailing List if you have trouble or the instrcutions are not clear. The bootstrap should work for the appliance or any version of GemStone/S 2.3 or greater.
- Start a stone using a virgin extent copied from $GEMSTONE/bin/extent0.dbf into $GEMSTONE/seaside/data. Don’t forget to shut the stone down before copying extents around and don’t forget to make the extent writable using ‘chmod +w extent0.dbf’.
- Download and unzip bootstrap_1.0-beta.0.zip.
- cd to the bootstrap_1.0-beta.0 directory
- Edit the .topazini file to match your stone.
- Launch topaz: ‘topaz -l -T50000’
- ‘login’ and ‘input installMaster.topaz’
- Exit topaz. The ‘installMaster.topaz’ script installs the Dev Group which includes the GemTools.
- Launch a GemTools Client 1.0-beta.1 image and login.
- [Updated: later that day] Due to some bugs discovered in 1.0-beta.0, it is recommended that you update to 1.0-beta.1 by executing the following expression:
ConfigurationOfGLASS project updateProject. (ConfigurationOfGLASS project version: '1.0-beta.1') load: 'Dev'. System commitTransaction.
- Choose a configuration to load by executing one of the following expressions:
(ConfigurationOfGLASS project version: '1.0-beta.1') load: 'Magritte Dev'. (ConfigurationOfGLASS project version: '1.0-beta.1') load: 'SOAP Dev'. (ConfigurationOfGLASS project version: '1.0-beta.1') load: 'Seaside Dev'. (ConfigurationOfGLASS project version: '1.0-beta.1') load: 'Seaside Testing Dev'. (ConfigurationOfGLASS project version: '1.0-beta.1') load: 'Scaffolding Dev'. (ConfigurationOfGLASS project version: '1.0-beta.1') load: 'Pier Dev'. (ConfigurationOfGLASS project version: '1.0-beta.1') load: 'Pier Testing Dev'. (ConfigurationOfGLASS project version: '1.0-beta.1') load: 'ALL'.
- Make a backup and have fun!