Starting with Serenji 2.6, released in July 2016, it is possible to run Serenji on Wine which is available for Linux and OS X.
1. You will need Wine 1.8 or later. As at July 2016 the version of Wine packaged with most Linux distributions is too old. Instead, use the instructions at https://wiki.winehq.org/Ubuntu or https://wiki.winehq.org/Debian or https://wiki.winehq.org/Fedora as appropriate. To install Wine on OS X the instructions are at https://wiki.winehq.org/MacOSX
2. Your Wine installation will require wine-mono and wine-gecko. A simple way to achieve this is to run the following command at a shell prompt (shown as $ below):
$ wine notepad.exe
If this detects that mono or gecko are not installed it will add them automatically. This is also a good test that Wine has been installed correctly and is working properly.
3. Next, install Serenji. Download the installer from http://georgejames.com/SnjRegForm and then run it using Wine, e.g.
$ wine ~/Downloads/s26.exe
This installs Serenji and concludes by launching the README file in Wine's notepad application.
4. Normal operation of Serenji requires a component called Serenji Sentry to be running on your desktop. Using your desktop application launcher, search for Serenji Sentry (SerenjiSentry.exe) and run it using Wine. This will place a Serenji Sentry icon (blue GJ logo) on your taskbar. Right-click on the Serenji Sentry icon and select 'New Serenji Task' from the pop-up menu. This will start Serenji and present you with the Task Guide.
5. The Caché or GT.M environments you want to use Serenji in will need the Serenji server-side components present. For a GT.M instance on your local Linux workstation, follow the instructions in the next paragraph. For all other cases, use the Task Guide option titled 'Loading the Server-side Components'.
If you have a local copy of GT.M for Linux installed in its default configuration, and you installed Serenji in its default configuration then the following commands will be sufficient to install the server-side components for your GT.M instance:
$ cp ~/.wine/drive_c/Program\ Files\ \(x86\)/George\ James\ Software/Serenji/GT.M/* ~/.fis-gtm/r/.
$ dos2unix ~/.fis-gtm/r/_Serenj*.m
6. To get started with Serenji, launch a terminal session and log in to your Caché or GT.M instance. Then run the Serenji Shell by issuing the following command:
> do SHELL^%Serenji()
This will establish a connection from your Caché or GT.M process to the Serenji Sentry in your taskbar, which will in turn establish a connection with Serenji.
7. Start debugging, for example by using the db command at the Serenji Shell prompt to run a routine:
s> db ^someRoutine
Serenji will display the source code for the routine and stop execution at the very first command. You can now use F8 or the toolbar buttons to step though your code.
For more information about using Serenji, use the Help menu.
- By default Serenji will be installed in ~/.wine/drive_c/Program Files (x86)/George James Software/Serenji/
- You can invoke the Serenji executables directly from a Linux shell prompt by prefixing them with wine, e.g. $ wine SerenjiSentry.exe
- If you installed Wine on OS X from the .pkg file the installer will have associated the .exe extension with Wine, so you can run a Serenji executable by double-clicking on in.
- Unlike on Windows the SerenjiSentry does not auto-start when you restart your Linux or OS X system. There are ways of making this happen.
- Wine is not perfect and there are occasional black rectangles when a rendering refresh is not properly emulated. There are also occasional glitches with focus and panel resizing. In most cases switching away from Serenji to another application and then back to Serenji will cure these artifacts.
- Owing to a limitation in Wine, Serenji does not preserve settings between sessions in the way that it does when running on Windows.