12-Installing SapphireOne’s Builds

This is a very short Step-by-Step list for Installing SapphireOne’s Builds

Before proceeding with the updating and Installing SapphireOne’s builds, by replacing the Server Database folder, it is recommended to read other articles in the Client Server area of the knowledge base. These articles provide additional details and information that may be useful throughout the process. If needed, refer back to those articles for further guidance.

Here is a short checklist to follow when updating and installing SapphireOne’s builds by replacing the Server Database folder:

The folder inside the extracted zip file for SapphireOne’s builds is consistently named Server Database. It is therefore crucial to adhere to the naming convention of the Server Database folder since the 4D application specifically looks for a folder with this exact name. While this convention can make it challenging to determine the version number once the folder is unpacked, it is recommended to promptly rename the folder to mitigate any potential confusion or errors.

Checking the Data File

  1. Sapphire Version or Build Number – While the required update file is downloading, use the Client application and check the current Version you are running.
    • Version Number – It is the last group of numbers in the Version number after the last dot. It will be from 0 to 100 or more.
  2. Verifying Data File – Also while the files are downloading, use the server application and select the Maintenance Tab.
    • Then run the Verify Records and Indexes procedure by selecting the appropriate button.
    • If any errors are reported, call SapphireOne support staff before proceeding any further.

Download the new Build

  1. Download Files – Download the required files from the SapphireOne file server into a specific folder created so that all files may be extracted into.
    • Folder Location –The Server Database folder may not be the top folder in the unzipped archive. Drill in and find it if required.
    • Rename Server Database Folder – If it has not already been done rename the new Server Database folder immediately by adding SapphireOne’s build number to the end.
      • Examples – Server Database01, Server Database02, through to Server Database100
  2. Installing new build – Move the Server Database folder with the number on it into the correct location. It will be immediately above or below the existing Server Database folder currently being used by the server. Your operating platform will allow it as it currently has a different name with a number being added at the end.

Shut Server Down

  1. Server Shutdown- It is crucial that the server is down as of now.
    • Backup – Next perform a manual backup to a zip file.
    • Move Archive File – Don’t forget to move the backup archive file to a permanent storage location.
  2. Server Database Folder – go to the folder that has the two Server Database folders in it.
    • Old Server Database folder – Delete this folder immediately.
    • New Server Database folder – Rename this folder by removing the number at the end of the name so that it is now Server Database.

Restart The Server

  1. Restart The Server– Next restart the server and immediately connect to the server with a Client Application.
    • Connect to Server – Use any workstation to connect to the server. If the Client application is on the server it may be used to connect to the server.
    • Verify Build No – Verify that the SapphireOne build or version number is as expected. If this is correct, you may now allow users back in.
  2. Incorrect Version or Build – If the version or build number is incorrect, it just means that the 4D server has picked up the wrong Server Database folder.
    • Verify – Verify that the correct build has been downloaded and that it has not been lost in the process documented above. If necessary repeat the process and check again.
  3. Cleaning Up – One of the main reasons that mistakes are made is that no one has cleaned up after doing an upgrade of some type, and the wrong Server Database folder is selected and installed.

Live Data file Folder

It is crucial to understand that all files, with the exception of the CompanyID.4DD file, can be replaced during the installation or upgrade process of SapphireOne. The CompanyID.4DD file is the Data File, which contains your company’s critical information. When this file is installed and accessed, SapphireOne will rebuild all other necessary files.

The CompanyID.4DD file is of utmost importance as it holds the lifeblood of your company’s data. It is vital to regularly back up this file to ensure data security and maintain the integrity of your company’s information. Backing up and safeguarding the CompanyID.4DD file should be a top priority to prevent any loss or compromise of valuable data.

You can review our Blog and YouTube channel for additional information and resources on SapphireOne ERP, CRM and Business Accounting software.

Was this helpful?