You are currently browsing the category archive for the ‘GemTools’ category.
GemStone/S 64 3.1.0 was released July 5, 2012.GemStone/S 64 Bit 3.1.0 is a major new version, including many new features as well as enhancements to existing features and bug fixes. A quick highlight of features is as follows:
- IPv6 support
- multi-threaded, highly performant backup and restore
- increased security for remote logins using SRP and SSL
- a new hot standby interface, providing continuous automatic synchronization
- powerful locale-specific collation using the ICU libraries
- full support for upgrade of Seaside applications
- API for secure SSL sockets from Smalltalk
Release notes, Install Guide and manuals are available here. Be sure to carefully read the GemStone 3.1.0 release notes, if this is the first time you have used GemStone/S 3.x as there are significant differences between GemStone3.x and GemStone 2.x.
Before attempting an upgrade you will want to make sure that your application loads into a virgin 3.1 repository (extent0.seaside.dbf) and passes unit tests before attempting the upgrade.
GemStone 3.1.0 ships with GLASS 1.0-beta.8.7.2 pre-installed in
You can download the binaries from ftp://ftp.gemstone.com/pub/GemStone64/3.1.0, use the installGemStone3.1.0.sh script to download and install GemStone 3.1.0 on your machine(highly recommended), or visit seaside.gemstone.com downloads page.
Once you’ve installed Gemstone in
/opt/gemstone/product, follow these steps to start and stop the stone:
- Define GEMSTONE environment variables ($GEMSTONE/bin and $GEMSTONE/seaside/bin added to your $PATH environment variable):
It is recommended that you add this step to your
- Copy the
extent0.dbffiles to data directory:
cp $GEMSTONE/seaside/system.conf \ $GEMSTONE/seaside/data chmod +w $GEMSTONE/seaside/data/system.conf cp $GEMSTONE/bin/extent0.seaside.dbf \ $GEMSTONE/seaside/data/extent0.dbf chmod +w $GEMSTONE/seaside/data/extent0.dbf
This step is performed as part of the installGemStone3.1.0.sh script.
stoneprocess is running:
A One-Click GemTools 1.0-beta.8.7 for GemStone 3.1.0 can be obtained from the seaside.gemstone.com downloads page or you can download GemTools 1.0-beta.8.7 for Gemstone/S 3.1.0 all platforms directly.
You can build a custom GemTools image by following these steps on the glass db wiki.
One-Click 1.0-beta.8.6 GemTools
GLASS Upgrade Cha Cha
I suppose it is a little known fact that the GemTools code base includes code that is used to drive the GLASS upgrade process, although my constant entreaties to “upgrade GemTools to the latest version before upgrading GLASS” may have given you a clue or two.
I thought I’d take this opportunity to describe what goes on behind the scenes when you select the Update > Update GLASS menu item in GemTools. This section should be especially useful if you prefer to upgrade your system without running GemTools.
Through the ‘Update GLASS’
Currently Metacello 1.0-beta.31.1 is the version that is needed for a smooth upgrade process:
ConfigurationOfMetacello project currentVersion versionNumber < '1.0-beta.31.1' asMetacelloVersionNumber ifTrue: [ (Gofer new) gemsource: 'metacello'; version: 'Gofer-Core.gemstone-dkh.135'; version: 'Metacello-Base-DaleHenrichs.19'; version: 'Metacello-Core-dkh.468'; version: 'Metacello-MC-dkh.531'; version: 'Metacello-Platform.gemstone-dkh.23'; load ].
It turns out that the best formula for bootstrapping Metacello is to directly load the key packages. I would have liked to use Metacello to bootstrap itself, but for GLASS we need to upgrade a wide range of Metacello releases dating back to over a year ago and there are several bugs that make it impractical to do anything but load the packages directly.
To bootstrap Monticello, we use the GLASS configuration and load the ‘Core’ and ‘Monticello’ projects:
MCPlatformSupport commitOnAlmostOutOfMemoryDuring: [[[ (ConfigurationOfGLASS project version: '1.0-beta.8.7.1') load: #( 'Core' 'Monticello' ) ] on: MetacelloSkipDirtyPackageLoad do: [:ex | ex resume: false ]] on: Warning do: [:ex | Transcript cr; show: ex description. ex resume ]].
We wrap the load with an out-of-memory handler.
The MetacelloSkipDirtyPackageLoad handler is there to compensate for a bug in the Monticello package loader that occasionally resulted in a package being marked dirty after a successful load.
The Warning handler is also there to ensure that packages needed for the upgrade are loaded whether or not they are marked dirty.
The GLASS upgrade is completed by doing a simple load:
MCPlatformSupport commitOnAlmostOutOfMemoryDuring: [[[ (ConfigurationOfGLASS project version: '1.0-beta.8.7.1') load ] on: MetacelloSkipDirtyPackageLoad do: [:ex | ex resume: false ]] on: Warning do: [:ex | Transcript cr; show: ex description. ex resume ]].
GemTools 1.0-beta.8.5 has been released. With this release there have been several bugfixes:
- Issue 132 : Use System class>>#”cacheName:” to make session recognizable in vsd
- Issue 250 : order and size of args asociated with #halt changed in Gci3xErrStype64 (GemStone 3.0)
- Issue 280: GemTools login error: ”Network error – text follows”, does not follow with error message…
- Issue 291: Maintenance Gem Topaz Exit 3.0 / GemStone 3.0
as well as some tweaks to the GLASS upgrade process.
I always recommend that you update GemTools before upgrading GLASS, because the GLASS upgrade process is driven by code included in GemTools. When you select the Update GLASS menu item, the class OGUpgradeJadeServer (included in the GemTools distribution) is compiled on the server and is then used to control the upgrade process.
Don’t forget that when you load GemTools into Pharo and Squeak, a set of Help Browser pages are created to provide the most up-to-date information on getting started with GemStone and the GemTools image.
Before releasing 1.0-beta.8.5, I tried loading GemTools into some of the more recent Pharo releases, like Pharo 1.3 and Pharo 1.2, but unfortunately the OmniBrowser implementation in those images is incompatible with the OmniBrowser required for GemTools. The latest version of Pharo that I found that works with GemTools is Pharo1.1.2-11422.
Squeak VM versions
While we’re on the subject, you should also be aware that in order to connect to GemStone, you must use an older version of the Squeak vms (4.2.2 or older) to avoid an FFI bug. For more details, see Issue 258.
I have written in the past about my attempt to increase the responsiveness of GemTools when used over the WAN, but there are still more roundtrips than I would like.
The one-click image is available on the GLASS downloads page.
GemTools 1.0-beta.6 features:
- fixed highlighting for class definition/creation template
- enabled syntax highlighting in workspaces
- double click includes leading $_. In package GemTools-Overrides that is not loaded by default, because it stomps on a method in Character.
- GsOBColumnPanel>>currentNode sends #currentNode to server-side, fixing a couple of ancient bugs
- reset GLASS version after doing a Server update
- exclude #baseline versions from update glass client version list
- add proportional splitters to inspectors (resize panes vertically)
- Use Help System instead of ProfStef
- fix Issue 54 “Typos and unclear instructions in GemTools ProfStef tutorial”
- add ”Admin>>Doit…>>Version Report” menu item (included in bug report template) that shows versions of all installed configs
- add toggle ”Admin>>Commit on Almost Out of Memory” command
- upgrade path from 0.231, 0.232.2 and 1.0-beta.0 through 1.0-beta.7 to 1.0-beta.8
For GemTools installation instructions see the Getting started with GLASS page (steps 3 through 6).
For GemTools update instructions see the Update GemTools Launcher page.
GemTools Client 1.0-beta.6 has been tested with:
- Pharo 1.0
- Squeak 4.1
GemTools 1.0-beta.3 features:
- improve ”Show Object log” output format
- add ”List backup files” command
- add some missing icon definitions for Squeak
- load OB/Shout if not present
- ProfStef tutorials (Pharo only for the moment)
The major change with this version is that the installation instructions are included as part of GemTools release. The last statement in install expression opens an interactive tutorial (created with ProfStef) in the Smalltalk image to guide you through the necessary steps to finish the GemTools install. The tutorial provides guidance for several different tasks from installing GemStone/S to opening the GemTools Launcher. A How To… button has been added to the GemTools Launcher with step by step tutorials for the following topics (so far):
- How to finish the GemTools installation
- How to define a GemTools session to log into your GemStone server
- How to update your GemStone server code (GLASS.230-dkh.164 through GLASS.230-dkh.231)
- How to open GemTools Launcher
- How to install and start a GemStone Server
- How to build a custom extent (GLASS 1.0-beta.4 and later)
- How to update your GLASS software after building a custom extent (GLASS 1.0-beta.4 and later)
- How to update your GemTools client software
Here’s a sample screen from the ‘How to finish the GemTools installation’:
What this means for you is that the installation instructions will match the version of GemTools that you are installing and you won’t have to guess which blog post has the right instructions for your situation. I will be updating the tutorials to cover more subjects and I welcome the contributions of tutorials from others (just let me know and I’ll add you as a developer to GemTools repository).
Wiki and Bug Reports
In the last week or so, I created a Google Code project for GLASS called glassdb. The project provides a public wiki and a public issue reporting system. I encourage you to submit a bug if you run into issues using GemTools or GLASS.
With a public bug reporting system it is now possible for you to contribute bugfixes as well as bug reports. If you want to contribute let me know and I’ll you to the glassdb project and add you to the GLASS DEVS group on GemSource.
Or click on the Update… button in the GemTools Launcher and select Update GemTools Client menu item.
Execute the following code in a Pharo workspace after downloading a recent version of Pharo (tested with Pharo1.0-10508-rc2dev10.01.2 and PharoCore-1.0-10508rc2 images):
Gofer new squeaksource: 'MetacelloRepository'; package: 'ConfigurationOfGemTools'; load. (Smalltalk at: #ConfigurationOfGemTools) perform: #loadLatestVersion. (Smalltalk at: #ProfStef) perform: #goOn: with: (Smalltalk at: #OGFinishGemToolsInstall)