Database Preferences Page

<< Click to Display Table of Contents >>

Database Preferences Page

The Database settings allow you to manage the PDQ Deploy database.

To access the Database settings page, click File > Preferences (or press Ctrl+Comma) and select Database in the Preferences window.

Options

Description

Database

Shows the path to the PDQ Deploy SQLite Database (Database.db). The default location is %PROGRAMDATA%\Admin Arsenal\PDQ Deploy\. Click the Open Directory Location button to view the location of the database.

NOTE: If there is an issue with the database, the Check Database button will appear. This will run Pragma integrity_check in SQLite to ensure the database is not corrupt. Additionally, from an elevated command prompt (cmd.exe run as Administrator), you can run this check with the PDQDeploy CheckDatabase command. To fully restore a database, you can also run the PDQDeploy RestoreDatabase command.

Size

Shows the size of the database.

SQLite Console

Opens an SQLite console in which you can perform database management operations on the PDQ Deploy database using SQLite commands. Additionally, from an elevated command prompt (cmd.exe run as Administrator), you can open the console with the PDQDeploy Database command.

IMPORTANT: Use this option with care. The PDQ Deploy database is essential to PDQ Deploy operations. It stores all packages, schedules, credentials, and deployment lists. In general, it is recommended that you use this option only under the direction of Admin Arsenal support staff or an official Admin Arsenal Knowledge Base article.

For more information on the SQL language, visit SQLite documentation at http://www.sqlite.org/lang.html.

Optimize Database

Rebuilds the database by reorganizing the data and indexes.

Over time, databases become fragmented. It is recommended that you periodically run an optimization to keep the PDQ Deploy database running at top performance. It is best practice to run this operation once per month. PDQ database optimization is automatically performed when the application is upgraded.

IMPORTANT: Optimizing the databases stops the PDQDeploy service and closes the PDQ Deploy console. Do not optimize when there are current deployments. It is recommended that you run the optimization when no other programs are accessing the database. Otherwise, the other programs may time out waiting for the optimization process to complete.

NOTE: From an elevated command prompt (cmd.exe run as Administrator), you can rebuild the database with the PDQDeploy OptimizeDatabase command. To fully restore a database, you can also run the PDQDeploy RestoreDatabase command.

Automatic Backup Schedule

 

 

Enable automatic backups

Enables the PDQ Deploy automatic backups feature. (Pro or Enterprise mode required) This is enabled by default.

NOTE: For assistance with restoring from a backup, see Restore Database Backup Files.

Schedule

Displays the current schedule for the automatic backup. Clicking the Edit Schedule button will open the Select Trigger window to edit the schedule. Additionally, you can click the Delete Schedule button to clear the schedule selection. The default schedule is every week on Saturday at 10:00 PM.

 

Once

Schedule once in the future.

Trigger Enabled: Enables the schedule trigger for use (selected by default).

Trigger On: Select one time backup date.

At: Time

Description: (Optional) Description of the schedule.

Interval

Backs up (and repeats) at a set time interval.

Trigger Enabled: Enables the schedule trigger for use (selected by default).

Every: Select backup interval by day, hour, and minute.

Starting: Select first schedule date.

At: Time

Ending: Date that the schedule ends.

At: Time

Description: (Optional) Description of the schedule.

Daily

Backs up every day at the same time.

Trigger Enabled: Enables the schedule trigger for use (selected by default).

Every Day

At: Time

Starting: Date that the schedule starts.

Ending: (Optional) Date that the schedule ends. Select to enable the end date.

Description: (Optional) Description of the schedule.

Weekly

Backs up every week at the same time on selected days of the week.

Trigger Enabled: Enables the schedule trigger for use (selected by default).

Every Week

On: Day or Days that the back ups occur.

At: Time

Starting: Date that the schedule starts.

Ending: (Optional) Date that the schedule ends. Select to enable the end date.

Description: (Optional) Description of the schedule.

Monthly

Backs up every month at the same time on selected days.

Trigger Enabled: Enables the schedule trigger for use (selected by default).

Every Month

On Day: The day (or multiple days) of the month (for example, 1st, 12th, 23rd, etc.)

Or

On The: The nth (for example, 1st, 2nd, Last, etc.) day of the month (for example, All, Weekend Days, Sunday, Monday, etc.)

TIP: Days of Month: If you select the 29th, 30th, or 31st of the month, the backup won't occur in months without those days. Use Last to always deploy on the last day of the month. Can be mixed with Weeks of the Month.

TIP: Weeks of Month: Different combinations of weeks and days require separate schedules (for example, the 1st Monday and the 2nd Friday.) Selecting the 5th week won't deploy in a month without a fifth week. Use Last to always deploy on the last week of the month. Can be mixed with Days of the Month.

At: Time

Starting: Date that the schedule starts.

Ending: (Optional) Date that the schedule ends. Select to enable the end date.

Description: (Optional) Description of the schedule.

Backup Location

Displays the path where backup files are stored. The default location is C:\ProgramData\Admin Arsenal\PDQ Deploy\Backups. Click the Open Directory Location button to view the location of the backup.

NOTE: The backup file is named after the version of the database with the date and time the backup was performed. For example a backup of version 9 performed on March 23, 2016 at 2:32 PM will be titled PDQDeploy-9.1.0.0-16-03-23 1432.db

Backups to Keep

Specifies the number of most recent backup files to keep. Setting this to 0 will save all backups. The default setting is 10.

NOTE: For assistance with restoring from a backup, see Restore Database Backup Files.

 

Compress backups

Automatically compresses each backup to save space. This is enabled by default.

Backup Now

Backs up immediately instead of waiting for the next scheduled backup.

Last Backup

Shows the date and time, with a continuous counter, since the last backup.

Next Backup

Shows the date and time, including a countdown, until the next backup.

Send Database to Admin Arsenal

Allows for the ability to send your database to Admin Arsenal for troubleshooting over a secure SSL connection.

IMPORTANT: This should only be used as directed by Admin Arsenal Support after they have supplied you with a Support Code.

NOTE: From an elevated command prompt (cmd.exe run as Administrator), you can send your database with the PDQDeploy SendDatabase command.

 

 

 

© 2016 Admin Arsenal, Inc. All rights reserved.

Admin Arsenal is a trademark of Admin Arsenal, Inc. All other product and company names are the property of their respective owners.

Help Version: 12.1.0.0