You are currently browsing the category archive for the ‘GemTools’ category.
GemTools 1.0-beta.8.6 has been released. With this release the GLASS upgrade process has been improved, yet again.
One-Click 1.0-beta.8.6 GemTools
One-Click GemTools images are available on the GLASS downloads page. GemTools images are available for use with GemStone/S 2.3.x, GemStone/S 2.4.4.x, and GemStone/S 3.0.1.x,
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.
For a complete upgrade script, take a look at the GLASS upgrade script page on the glass db wiki. The GLASS upgrade script page will always have the latest and greatest upgrade script.
Through the ‘Update GLASS’
The upgrade process has been greatly simplified since I first started using Metacello for bootstrapping GLASS 1.0-beta.0, back in November of 2009, but the basic steps have remained the same:
Bootstrap Metacello
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.
Bootstrap Monticello
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.
Upgrade GLASS
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 ]].
—–
[1]http://www.flickr.com/photos/archer10/5228946002 / CC BY-SA 2.0
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.
Upgrades
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.
Speaking of upgrading GLASS… If you are interested in doing a GLASS upgrade from a topaz script take a look at this page on the glassdb wiki has the most up-to-date instructions.
Help
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.
Pharo
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.
—–
http://www.flickr.com/photos/nhankamer/5616046050 / CC BY-NC 2.0
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.
Ramon Leon has found a way to speed up the remote performance of GemTools on LInux:
Photo by http://www.flickr.com/photos/51035610542@N01/4592973010/ / CC BY NC ND 2.0
Thanks to the hard work of Norbert Hartl, GemTools can now be loaded into Pharo 1.1.
If you’d like to build your own GemTools on top of Pharo 1.1, then download Pharo 1.1 image (core or dev) and follow the installation instructions here.
If you are using GemTools 1.0-beta.8.2 on Pharo 1.0 or Squeak 4.1, you can upgrade to 1.0-beta.8.3, but there should be no functional differences.
Photo by http://www.flickr.com/photos/dditt/3958565556/ / CC BY NC ND 2.0
Once the GemTools 1.0-beta.6 configuration was released, James Foster took a Pharo 1.0 one-click image and transformed it into a GemTools 1.0-beta.6 one-click(zip) for OS X, Linux and Windows.
The one-click image is available on the GLASS downloads page.
Photo by http://www.flickr.com/photos/cogdog/2313353249/ / CC BY 2.0
GemTools 1.0-beta.6 is a prerequisite for GLASS 1.0-beta.8.
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
The Terse Guide to the (new) GLASS Tools has been transferred (and updated) to the glassdb wiki see the GemTools Launcher Guide page.
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
Let me know if you run into problems.
—–
http://www.flickr.com/photos/35669523@N04/3310187686 / CC BY-NC-ND 2.0
Well the time has finally come, or nearly come.
It’s been nearly a year since I’ve released a GLASS Beta Update. Last April, when I released the SOAP Preview for GLASS, it was obvious to me that the days were numbered for the GLASS.230-dkh umbrella package and that I would have to find a better solution for making releases in Smalltalk. I just didn’t realize that the number would top 300:)
In my defense, starting in November of last year I did initiate a series of Bootstrap releases (1.0-beta.0, 1.0-beta.4, and 1.0-beta.5), but over the last 10 months I’ve really focussed on getting Metacello up to snuff.
The good news is that I am in the final steps of the year long release cha cha.
Metacello 1.0-beta.25
Metacello is nearly ready for 1.0, but there are a handful of things that have to be done before release. I’ve outlined most of them in The road to 1.0. I will release 1.0-beta.25 later today (fingers crossed) and will spend a day or so writing up additional documentation on some of the new Metacello features.
GemTools 1.0-beta.6
Once Metacello 1.0-beta.25 is out the door, I will polish up GemTools 1.0-beta.6.
The big news with GemTools 1.0-beta.6 is that I have transitioned to using the Help System for documenting the update steps for GemTools and GLASS. I will continue to announce releases on my blog, but the details for doing an update will be included in a Help System browser available via GemTools. This means that you won’t have to try to cross reference the versions of GemTools and GLASS with ancient blog posts to figure out how to upgrade to later versions.
Continuing the process started over a year ago, you will need to update to GemTools 1.0-beta.6 in order to update to GLASS 1.0-beta.8.
BTW, when Pharo releases version 1.0, we’ll release a new one-click for GemTools.
GLASS 1.0-beta.8
I plan to push GemTools 1.0-beta.6 out right before I release GLASS 1.0-beta.8. At this point I’ve got most of the major port and testing load behind me:
- update path from Pier 1.0.17 to Pier 1.2.1.3 tested
- update path from GLASS.230-dkh.164 tested (Appliance 1.0-beta11)
- update path from GLASS.230-dkh.177 tested (GemStone/S 64 Version 2.3.1)
- Seaside 2.8.4.4, Magritte 1.2.1.4 and Pier 1.2.1.3 ported to GemStone
- Seaside 3.0.0-alpha5.5 ported to GemStone/S 64 Version 2.4 (Pier2 and Magritte2 not yet ported to GemStone)
- Gofer and Gofer Project Loader ported to GemStone
There are a few more details that I need to cover and quite a bit of documentation to write about for 1.0-beta.8 before release, but I thought it was worth letting you know that I am in the final approach for releasing 1.0-beta.8
—–
[1]Photo by http://www.flickr.com/photos/experiment33/ / CC BY-NC-ND 2.0
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.
Update GemTools
Execute the following code in a Squeak or Pharo workspace:
ConfigurationOfGemTools loadLatestVersion
Or click on the Update… button in the GemTools Launcher and select Update GemTools Client menu item.
Install GemTools
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)
Until ProfStef is ported to Squeak and Gofer is installed in the trunk, you’ll have to follow these instructions (tested with Squeak3.10.2-Trunk-090912).
—–
[1]http://www.flickr.com/photos/radiorover/ / CC BY-NC-ND 2.0
GemTools 1.0-beta.2 features:
- fix update client logic to use #lastMetacelloVersionLoad
- change annotation pane and make more room for useful info
- inspect undefined and inspect sent but not implemented menu items available only when tests are installed
- clean up preferences problems
- Admin>>Seaside submenu available only when Seaside2.8 installed
- improve session window label (include the session name) when working with multiple stones
Install
To install the GemTools Client in a virgin Squeak or Pharo image jump to the Install instructions.
Update
For version 1.0-beta.0 of the GemTools Client, follow these Update instructions.
For version 1.0-beta.1:
- Logout of your GemStone session(s).
- Click on the Update Client button and select ’1.0-beta.2′.
- Save your client image.
—–
[1]http://www.flickr.com/photos/dystopos/91980377/ / CC BY-NC 2.0
With the 1.0-beta.1 release of the GemTools Client, we’re doing two things:
- Conforming to the new Metacello configuration naming convention.
- Getting ready for the imminent GLASS 1.0-beta.0 release.
GemTools 1.0-beta.1 features:
- Convert to using ConfigurationOfGemTools.
- Nicer info dialog when Undefined symbols and Unsent messages are clean
- Support for GemStone/S 3.0 GciErrSType
- Change restore from backup done message … do not prompt to start Seaside gems if Seaside is not installed
- Replace dialogs that are calling “ifNotEmpty:” with: “isEmptyOrNil” (from Gerhard)
- autoAbort _before_ commands is now optional (off by default)
If you’ve already installed the GemTools Client 1.0-beta.0, then you want to follow the Update instructions. To install the GemTools Client in a virgin Squeak or Pharo image jump to the Install instructions.
Update
With GemTools Client 1.0-beta.0 already installed, we need to update to using ConfigurationOfMetacello as well as ConfigurationOfGemTools:
- Load the latest version of the ConfigurationOfMetacello package from http://seaside.gemstone.com/ss/metacello.
- Load the latest version of the ConfigurationOfGemTools package from http://seaside.gemstone.com/ss/GLASSClient.
- Execute the following expression in a workspace:
ConfigurationOfMetacello loadLatestVersion. ConfigurationOfGemTools loadLatestVersion.
Then continue with Step 3 of the installation instructions.
Installation
If you haven’t already been using the GemTools 2.3.1 Preview for all platforms (which is based on Pharo), then you should download the preview GemTools client and follow the instructions for setting up your session to verify that you can connect to your stone. You’ll need the session information and the gci files from the Preview to get things running with the either Squeak or Pharo.
I’ve tested the installation procedure using Squeak3.10.2-Trunk-090912 and pharo1.0-10492-rc1dev09.11.1.
To load GemTools into a client image:
- Load the latest version of the ConfigurationOfGemTools package from http://seaside.gemstone.com/ss/GLASSClient.
- Execute the following expression in a workspace:
ConfigurationOfGemTools loadLatestVersion. - Execute the following expression to open the GemTools launcher:
OGLauncher open - Copy the session information from your old GemTools Client to the new GemTools Client in your image. Use the Edit session menu item on the Session Menu in the launchers.
- Save the image.
- Copy the gci files (gciForWindows.dll, gciForLinux.so, and gciForMacintosh.so) from GemTools-2.3.1-preview.app/Contents/Resources in the one-click into the directory containing your image and changes files. On the Macintosh, the gciForMacintosh.so needs to be copied to both the image directory and the vm.app/Contents/Resources directory (thanks Mark and Ken).
- Press the Login button on the GemTools Launcher and you should be in business.
—–
[1]http://www.flickr.com/photos/randyweiner/ / CC BY-NC-ND 2.0
