The Maintenance & Security Centre (MSC) is a feature of the Genie Server application. Among other functions, the MSC can assess the integrity of the Genie data file and applications, repair data corruption, compact the data file, or restore a backup.
Before you begin
- The following guide is intended as a technical reference only. If you have been experiencing issues during your day-to-day use of Genie, or your Verify returns any issues please contact Genie Support.
- Generally the MSC should be opened via the Genie Solo application if you are planning to perform data maintenance. However if you only intend to verify the data file, you should open the MSC via Genie Server. For this reason, you will need access to your server machine.
- Most importantly, you must take a backup of your data file before performing any maintenance or restorative functions on your Genie data file. This is essential to ensuring that you have an up to date datafile to go back to, should any problems occur in the maintenance process.
Accessing the Maintenance & Security Centre
On your server machine hold down the Alt/Option key on your keyboard while launching either the Genie Solo or Genie Server application on the server computer (i.e. launch the application and then hold Alt/Option).
In the prompt window that appears, select Open the Maintenance and Security Centre, then click Continue.
Verifying/Repairing the Application
Verifying the Application
- From the MSC, select the Verify tab on the left-hand side of the window.
- Click on the Verify the Application button at the bottom of the screen.
Repairing the Application
If an error is detected within the application, you can manually locate and delete the 4D preference folders from the server computer.
Macintosh:
- Quit out of Genie.
- Open a Finder window.
- Select Go > Go to Folder.
- In the pop up box, type in exactly ~\Library\ and click Go to open the Library folder.
- From the Library folder you will need to browse to each of the folders specified below. From each folder, you must find and delete any folders named 4D.
- Library:Application Support:
- Library:Caches:
- Library:Preferences:
Once all 4D folders have been deleted from the locations above, you can relaunch Genie.
Windows:
- Quit out of Genie.
- Open the Start menu and type in exactly: %appdata%
- Press Enter to open the \AppData\Roaming\ folder.
- Click on the word AppData in the address bar at the top of the screen to access the AppData folder.
- From the AppData folder you will need to browse to each of the folders specified below. From each folder you must delete any folders named 4D. Note that XXX represents the server computer’s IP address.
- AppData\Roaming\4D\Genie.4DC_XXX\
- AppData\Local\4D\Genie.4D_XXX\
- AppData\Local\Temp\
Once all 4D folders have been deleted from the locations above, you can relaunch Genie.
If the application is still failing verification after performing the above steps, it must be reinstalled. Please contact Genie Support for assistance with reinstalling the Genie application(s).
Verifying and Repairing the Data File
Verifying the Data File
- Launch Genie to the MSC.
- Click on the Verify tab on the left-hand side.
- Click the Verify the records and indexes button at the top of the screen.
The verification can take some time depending on the size of the data file.
If an Error is Detected
Once the verification is complete, if Genie has detected any issues, you will be presented with one or more red crosses next to each of the buttons in the Verify tab. When errors are detected during verification, this usually indicates corruption is present within the data file. Running any maintenance or repair functions on a corrupt data file can result in data loss. Therefore, if errors are detected during the verification, it is imperative that you capture the verification logs and forward them to support@geniesolutions.com.au before proceeding.
If you have not already contacted Genie Support regarding this issue, please provide some further information about the issue(s) you are experiencing such as frequency, the date of first occurrence, and any changes made to your Genie environment around that time.
Capturing the Verification Logs
- Click the Open Log File button at the bottom of the window.
- Genie will launch your default Internet browser (e.g. Chrome, Safari) displaying the log file.
- From your Internet browser, select File > Save As and save the Genie_Verify_Log.HTML (or .XML, depending on your Genie version) file somewhere easily accessible, such as the computer’s Desktop.
- If you are unable to select File > Save As, try right-clicking in a blank part of the webpage and selecting Save Page As.
Manually Locating Verification Logs
If you are unable to access or save the Genie_Verify_Log.HTML file from the MSC window, it can be manually located using the instructions below:
Macintosh:
- Open a Finder window to the Genie folder (default location: Macintosh HD\Applications\Genie\).
- Right click the Genie application and select Show Package Contents.
- Open the \Database\Logs\ folder to find the Genie_Verify_Log.HTML file.
Windows:
- Open the Start menu and select Computer.
- Browse to the Genie folder (default location: C:\Genie\).
- From the Genie folder, browse to \Solo Application\Database\Logs\ to find the Genie_Verify_Log.HTML file.
Running a Standard Repair
If errors are detected during the verification, it is imperative that you capture the verification logs and forward them to our Support Team as outlined above. Please note: Depending on the type of error(s) identified, there is a possibility of data loss upon running a standard repair.
Run a Standard Repair:
- Click on the Repair tab to the left-hand side of the Maintenance & Security Centre window.
- Next to ‘Repair Data file’ options make sure that the Standard repair radio button is selected.
- Click on the Repair button in the bottom right corner of the ‘Repair the data file’ section and allow this process to run through to completion.
- Verify the Genie data file to confirm issue is resolved using the directions above.
If problems are again detected in the data base after performing a Standard Repair, further Standard Repairs may be required. Contact Genie Support for clarification before proceeding.
You would normally run a compact on the data file to recover the empty space after performing a rebuild, archive or cull on your data file.
- Open the Maintenance & Security Centre via the Genie Solo application on the server machine
- Click on the Compact tab to the left-hand side of the Maintenance & Security Centre window
- Click on the Compact records and indexes button and allow the process to complete. A copy of the current data file will be placed in the ‘Replaced Files (Compacting)’ folder. The compacted data file will become the new active file.
Note: The ‘Compact Structure File’ button will compact the C:\Genie\Solo Application\Database\Genie.4DC file. This is not required when compacting to recover empty space.