GsDevKit Scripts

July 10, 2015 ยท View on GitHub

The bin/ directory contains scripts to install, run, and perform various management tatks for GsDevKit.

Server Scripts

Scripts that run on the server machine only.

scriptdescription
backupCreate a GemStone backup for the given stone.
createStoneCreate a new stone with the given stone name. Do not install tODE.
createTodeProjectStoneCreate a new stone with the given stone name. tODE and the given project are installed.
createTodeStoneCreate a new stone with the given stone name. tODE installed.
defStone.envDefine GemStone environment variables in current shell (source $GS_HOME/bin/defStone.env).
installGemStoneDownload and install the given GemStone version. Will make sure that shared memory is correctly configuration on your server. Performs some operations as root using sudo. Only needs to be run once per GemStone version.
installPharoDownload and install a Linux or Mac or Pharo3.0 VM, image and changes file.
installServerInstall GemStone/S, create a stone, start the stone, create a todeClient image. Runs the installGemstone, createTodeImage, createStone, startStone, startNetldi, startStatmonitor, installTodeStone and todeClient scripts.
installTodeProjectStoneInstall tODE and the given project in the given stone.
installTodeStoneInstall tODE in the given stone.
pharoRun headless pharo scripts using the Pharo image.
restoreFromBackupRestore a backup on the given stone.
startNetldiStart the netldi process for the given stone.
startStatmonitorStart statmonitor for the given stone. Two statmonitors are started. One that collects a sample every second and is restarted every hour. One that collects a sample once a minute and is restarted once a day.
startStoneStart the stone process for the given stone.
stoneNewExtentCopy a new extent into the stone's extent directory. Stone should be shutdown before copying.
stoneExtentSee stoneNewExtent
stonesList information about the installed GemStone/S produects, existing stones, running stones and running netldis.
stopStoneStop the named stone. The netldi is left running. Any statmonitor processes associated with the stone will be stopped.
todeRun headless tode scripts using the todeClient image.

Client Scripts

Scripts that can be run on the client machine or the server.

scriptdescription
createTodeImageCreate the tODE client image. Used for running pharo-based tODE scripts and for running the tODE client UI. Using the -f option updates the client image.
installClientCreate a todeClient image on a remote machine. Runs the installGemstone, createTodeImage and todeClient scripts.
installGciCopy the gci libraries for the given GemStone version to the $GS_HOME/pharo directory.
installPharoDownload and install a Linux or Mac Pharo3.0 VM, image and changes file.
performTodeCommandPass tODE command to be executed as command line.
pharoRun headless pharo scripts using the Pharo image.
todeRun headless tode scripts using the todeClient image.
todeClientLaunch todeClient image. Requires X11 client.
updateTodeImageUpdate the todeClient image.

##Utility Scripts Special purpose utility scripts.

scriptdescription
osPrereqsUtility script installing os-specific prerequisites