Update a SQL Server Database

Update an Ape Software SQL Server Database

Use these instructions to update the database structure of a Calibration Control (our Calibration Management Software) database installed on a SQL Server 2012 or higher.

Before Updating

Open SQL Server Management Studio and sign in to a SQL Server as a SYSTEM ADMIN because you'll require enough permissions to create and update databases and their objects.  Otherwise, your IT Group may need to perform the update.

All of the SQL files needed to update the database reside in the SQL Tools folder under the CC program folder located in your computer at C:\Program Files\Ape Software\Calibration Control.

Before attempting to update an apecal database protect your database with a backup . Right-click the database, hover over Tasks, and then select Back Up.

Follow along with our Backup/Restore SQL Server Database help topic for more detailed instructions.

Updating Database

1. Determine the current database structure version by first expanding the database tree and expand the Tables folder. Then, right-click the dbo.tblDBVersion_DO_NOT_EDIT table and Select Top 1000 rows.  There should only be one record.

   

   If you do not have a StructureVersion field in the file name (versions 7.2.5 and older), use the following table as a guide to interpret the dbo.tblDBVersion table and how to choose the appropriate sql_update SQL file to begin with:

   DB Version Interpretation

   Indication	Database Version
   dbo.tblDBVersion_DO_NOT_EDIT table does not exist	1
   Rev = 1.1, 7.0, 7.0.1, etc.	Rev = Version
   Rev = DoNotEdit	Use StructureVersion field
   StructureVersion = 66	66

2. Open each SQL Update file with SQL Server Management Studio. Once again, ensure you backup your database before proceeding.
   Note: If your database name is not the standard "apecal", change the database name before proceeding. The database name may appear in the following lines of the update files:
   
   ALTER DATABASE apecal -- ***
SET OFFLINE WITH ROLLBACK IMMEDIATE
ALTER DATABASE apecal -- ***
SET ONLINE
USE apecal -- ***
GO
ALTER DATABASE apecal SET PAGE_VERIFY CHECKSUM -- ***
GO

3. Apply the sql_update SQL files in their sort order beginning with the database version indicated by the Db Version table (above).
   For example, if the StructureVersion field of your database equals 66, then begin with file sql_update_22 (db ver 66 to 73).sql then click the [Execute] button to apply the changes.
   Note:  Ensure that none of the text in the SQL file is highlighted when the [Execute] button is pressed because this will run only the highlighted text.

4. Once the query is complete (without any red query errors), continue to the next file until you finish with the final SQL file. 
5. If you encounter any query errors, take a screenshot of the error(s) and contact us for assistance.

Get Ape Support

Contact us and we can setup a screen share and update your database together or if you prefer, you can send us a backup of your database and we can update your database for you.

Last Updated:  3 December 2020