From 5.2 and above, Zoom server can be configured to perform or not perform database checkpointing on the next server restart. Previously, every time the Zoom server started, checkpointing would be done, which would take stock of the data operations performed on the Zoom server since the previous checkpoint, compacting the database in the process. However, this was inconvenient as the server became unavailable until checkpointing completed, especially at times when say, administrative setting changes require server restarts.
With, Zoom 5.2 and above, if the Zoom server has been scheduled to restart automatically, at a particular time and frequency, say daily at 1 AM, then checkpointing is performed only on those scheduled server restarts. On all other occasions, the server will not perform checkpointing.
An administrator can force a server restart with (or without) checkpointing, in the following manner.
- Using the javaZoom tool: (recommended for Zoom 5.3 and above)
- Open a Terminal or Command-Prompt.
- javaZoom is a utility available in the Zoom server installation bin directory
- Navigate to the Zoom install bin directory.
- To restart the Zoom server with checkpointing, run the command:
./javaZoom checkpoint on
- To enable checkpointing for the next server restart, but without immediately restarting the server, run the command:
./javaZoom checkpoint on -nr
- To see the javaZoom checkpoint utility’s usage help, run the command:
./javaZoom checkpoint help
Restart Zoom Server With Checkpointing The following commands are supported: help: Print this help message. on : Enable checkpointing before restarting server. off : Disable checkpointing before restarting server. The following options are supported for all commands above: -v : Print verbose output messages. -nr : Do not restart server; only change the checkpoint setting. -c v: Zoom Server restart command; for non-standard Zoom installations. Use quotes to preserve spaces and special characters. <nbsp;> Examples: checkpoint on (Enable checkpointing and restart server) checkpoint off (Disable checkpointing and restart server) checkpoint on -nr (Enable checkpointing, but do not restart server) checkpoint on -c "service evolZoom restart" (Enable checkpointing, and restart server with a custom command)
- Manual edit and restart: (not recommended)
- Open in a text editor, the server configuration file, server.xml, from the installation conf directory.
- The property value in
server.xml > autoRestartSpec > doCheckpoint, governs if checkpointing will be performed on the next server start.
- Navigate to this property (by searching for “
doCheckpoint“) and set its value to “
true” instead of “
- Save the file.
- Restart the Zoom server.
- Ensure that checkpointing has been completed by viewing the server_log.0 file under <ZoomInstallDir>/logs directory and confirming the following log record with the time-stamp AFTER restart:
INFO: Sun, 22 Nov 2015 20:06:55.527 PST [TransactionRedoLogManager.redoSecondPass Zoom Main Thread-1] Redo log checkpointing estimate: 450 kb in 0.00 s (at 15 mb/s).
INFO: Sun, 22 Nov 2015 20:06:56.060 PST [TransactionRedoLogManager.setup Zoom Main Thread-1] Redo log checkpointing ended.