ID: 2909

Print Friendly, PDF & Email

Zoom server checkpointing on restart

Configuring checkpointing only when scheduled and forced checkpointing

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.

For versions before 5.2, checkpointing is enabled by default upon Zoom server startup.

 

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.

In case there is no scheduled restart, i.e. auto-restart is disabled, the behaviour is a bit different. Administrators can still override and force the server to start in a non-checkpointing mode. However, on successful start-up, the server will revert to performing checkpointing on subsequent restarts. This is necessary because, otherwise, checkpointing would never occur.

Forced 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)
    1. Open a Terminal or Command-Prompt.
    2. javaZoom is a utility available in the Zoom server installation bin directory
    3. Navigate to the Zoom install bin directory.
    4. To restart the Zoom server with checkpointing, run the command:
      ./javaZoom checkpoint on
    5. To enable checkpointing for the next server restart, but without immediately restarting the server, run the command:
      ./javaZoom checkpoint on -nr
    6. 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)
    1. Open in a text editor, the server configuration file, server.xml, from the installation conf directory.
    2. The property value in server.xml > autoRestartSpec > doCheckpoint, governs if checkpointing will be performed on the next server start.
    3. Navigate to this property (by searching for “doCheckpoint“) and set its value to “true” instead of “false“.
    4. Save the file.
    5. Restart the Zoom server.
    6. 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.