01-SapphireOne Client Server Overview

Sapphire and SapphireOne versions.

It has come to our attention that many in the IT industry, in particular do not understand the different operational functionality of the two versions of the SapphireOne software, hence this additional documentation that has now been included at the beginning of this article.

Any person who is providing IT support for a company is strongly advised to read all of this article as the information provided will help the IT person to understand exactly how SapphireOne Software is installed and operates, on both the MacOSX and Windows based platforms.

SapphireOne Software Versions.

For both MacOSX and Windows, SapphireOne software is provided in two versions as follows

  1. Sapphire Single user – This is provided as a stand-alone single user application.
  2. SapphireOne Server – This application operates in Client Server mode which is built into the SapphireOne application.
    • SapphireOne Client – A stand alone application to communicate with the SapphireOne Server application.
Common Source Code.

Sapphire Single User and the SapphireOne Client Server, share identical source code. As a user, you have the ability to hot swap between SapphireOne Client Server and Sapphire Single User.

The beauty of being able to hot swap from a SapphireOne server version to a Sapphire Single User version is that you have the ability to take a copy of your live data file, and run it up in Sapphire Single User, and then use that as a sandbox to try out or test something new.

For example, you might want to test a new function within SapphireOne or you might want to experiment setting up your Job Projects or Assets, or implement a new feature or module. At SapphireOne we always suggest doing it with the Sapphire Single User copy of your data file and then do it in your SapphireOne live data file.


Integration of SapphireOne into the operating Platform.

While this problem does not occur with a Mac, many programs when installed on a Windows based machine, integrate themselves into the system and the registry. They then require the user to execute an uninstall routine of some type to remove them.
This does not occur with the SapphireOne application as it is installed as a stand-alone application.
For this reason, it can simply be moved or deleted as required although any shortcuts, aliases to the application will have to be updated.


Virtual Servers.

Either of the two versions of Sapphire and SapphireOne, must never be installed on a virtual machine. While many applications now operate on virtual servers, both of SapphireOne’s applications do make direct calls to memory and also require unfettered access to the data base.

If you do attempt to run them on a virtual server you will eventually end up with a data file that is completely un-recoverable. For this reason, SapphireOne will not take responsibility for any SapphireOne application operating on a virtual machine.


SapphireOne Software Versions.

SapphireOne has three applications, Sapphire Single User, SapphireOne Client Server and a SapphireOne Client Application used to communicate with the SapphireOne Server. All three of the applications are available for both operating platforms MacOSX and Windows.

Sapphire (Single User).

Sapphire Single User, is provided as a single user application. When the software is updated, even for incremental builds, the entire directory or folder structure is replaced and a new shortcut must be created each time this is done.
Sapphire Single User may be installed on either a Mac or Windows machine. After installation on first boot, it will ask for the location of an active data file. This file is usually named, CompanyName.4DD and may be stored on any drive that is permanently attached to the Mac or Windows based platform.
This file always has the extension of .4DD preceded by the company name or ID as selected by the company.
Other files will be in the folder with the .4DD file but if necessary they may all be re-built from the .4DD file with the exception of the settings folder if it is used.

SapphireOne (Server).

This is different to Sapphire Single User application. When this application is installed on a Mac or Windows machine, provision for it to operate in Client Server mode is included as a part of the application.
It does not have to be installed on a machine that is a server i.e. a Microsoft Server application of some type. (Mac OSX and Windows, currently Windows 11). However, the additional functionality of both Mac and Windows servers is usually required for most businesses, so the SapphireOne Client Server application will more likely end up being installed on a server of some type although it is not a requirement.

SapphireOne (Client).

Again, this application on a work station, is installed as a stand-alone application and is not integrated into the system. Remember for Windows it is not integrated into the registry. It can be deleted or moved although the shortcut used to access it would have to be updated.

When the application is executed it looks for a SapphireOne 4D server on the local network. If the IP address of the SapphireOne server is altered it will continue looking until it finds the SapphireOne 4D server on the local network.
Once it has found and accessed a SapphireOne 4D server, next time it is executed it will look for the SapphireOne 4D server in the same place it found it last time. It remembers where it was successful last time it was executed.


IT Manager Information.

IT system manager access and maintenance.

Wherever the SapphireOne application is installed it will require maintenance from either SapphireOne Support staff, someone in your company or the IT company that provides your IT support.
Access to the Mac or Windows server for good reasons, is usually carefully restricted and the executing of any programs on a server is quite often controlled as well. While the aforementioned items may be circumvented with the appropriate user access and permissions, it can be a problem that should be considered before the installation of any SapphireOne application.

Installing SapphireOne on a separate machine.

For the limitations documented above, a simpler approach could be to not install SapphireOne application on the MacOSX or Windows main server itself.
Considering the actual cost of purchasing a Mac or Windows with a standard operating platform, one without server capabilities, the application could be installed on a new stand-alone machine on your local network.
The machine would require higher operating specifications to a normal workstation and should have a fixed IP address locally although SapphireOne will operate successfully without a fixed IP address.
Specific user access could be granted to this machine separate to access to the main server.


Mac Auto Hide function.

The following applies the Mac operating platform and not Windows, as Windows does not have this auto hide function implemented. On a Mac, any call to any external program (for example print or export of reports) hides SapphireOne. When the focus is shifted from SapphireOne, the system auto hides the SapphireOne toolbar completely. Clicking on the SapphireOne icon on the desktop, or clicking on the SapphireOne Icon in the dock is the only way to un-hide the toolbar.


Excel Link Change.

If you wish to run Excel link on a Mac, you are now required to have Web Server licenses to run it in v14 or later. Also, if you are running 64bit processor you will have to download the 64bit versions of the Excel link application.


Minimum Resource Requirements Mac & Windows.

The minimum requirement for Work station memory is now 8GB and for Server is 16GB.
While the system will install and run with less resources there will be major problems with running the program particularly in relation to speed and SapphireOne do not recommend this. Crashes are one symptom of insufficient memory.


Was this helpful?