SPDocKit
Try it for FreeContact UsProduct Site
  • SPDocKit by Syskit
  • Release Notes
    • SPDocKit 12
    • SPDocKit 11.1.0
    • SPDocKit 11
    • SPDocKit 10
    • SPDocKit 9.1.0
    • SPDocKit 9
    • SPDocKit 8.0.3
    • SPDocKit 8
  • Requirements
    • SharePoint On-Premises User Permissions Requirements
    • Supported SharePoint Editions
    • System Requirements
    • Server Load Permission Requirements
    • Service Application Permission Requirements
  • Installation
    • Install SPDocKit
    • Upgrade to the Latest Version
    • Uninstall SPDocKit
  • Activation
    • Activate SPDocKit
    • Manage License
    • Activation Privacy Statement
  • Configuration
    • Configure SPDocKit
    • Configure SPDocKit Database
    • Import and Export SPDocKit Settings
  • Create SharePoint Farm Snapshots
    • Snapshots Screen
    • Manual Snapshots
    • Automatic Snapshots
  • Explore Reports & Create Documentation
    • Farm Explorer
      • Farm Explorer Screen
      • Farm Dashboard
      • Farm Explorer Reports
      • Farm Documentation
      • Passwords and Product keys
      • Generate an AutoSPInstaller XML Configuration File
      • Change the Limit on Site Topology Report
    • Site Explorer
      • Site Explorer Screen
    • Permission Reports
      • Permissions Reports screen
    • Analytics and Usage Reports
      • Analytics and Usage Reports Screen
      • Analytics Dashboard
      • Site Collection Analytics
      • Document Extensions Reports
    • Audit Reports
      • Audit Reports Screen
      • Audit Dashboard
      • Audit Log Details
      • Administrative Actions
      • Audit Settings
    • Best Practices
      • Best Practices Screen
      • Best Practices Reports
    • Subscriptions and Alerts
      • Subscriptions and Alerts
      • Create New Subscription
      • Create New Alert
    • Customizing Reports
      • Customize View
      • Add Comments
  • Compare SharePoint Configurations
    • Compare Wizard
    • Compare SharePoint Farms
    • Compare Servers
    • Compare Web Applications
    • Compare Site Collections
    • Compare SharePoint Permissions
    • Compare Web.Config Files
  • Manage SharePoint Permissions
    • Permissions Explorer Screen
    • Manage Permissions Ribbon Actions
    • Users and Groups Actions
      • Manage Groups Wizard
      • Group Memberships Wizard
      • Copy Permissions Wizard
      • Move Permissions Wizard
      • Manage Permissions Wizard
      • Remove Permissions Wizard
    • Securable Objects Actions
      • Break/Restore Permission Inheritance Wizard
      • Restore Permissions
      • Copy Object Permissions Wizard
    • Site Collection Actions
      • Site Collection Administrators Wizard
      • Permission Levels Wizard
      • Clean Site Collections Wizard
    • Add Tags
    • SPDocKit Permission Management Event Log
  • Configure & Extend SPDocKit
    • Backstage Screen
    • Options Wizard
    • License Management
    • Role Based Security
    • Extend SPDocKit
      • Install SPDocKit Extensions
      • Download SPDocKit Extensions
      • Activate SPCAF Extension
  • Query & Change SharePoint Settings
    • Queries and Rules Screen
    • Create SharePoint Governance Policy Rule
    • Create SPDocKit Query
    • Change SPDocKit Query Results Limit
    • Create Audit Queries and Rules
  • FAQ
    • Requirements
    • Installation
    • Activation
    • Configuration
    • Features
    • Security
    • Miscellaneous
    • SPDocKit Insights Removed
    • SPDocKit Insights Migration
  • Known Issues
    • CREATE TABLE permissions denied
    • Custom features missing in reports
    • Data retention not working properly
    • Distributed Cache loading issue
    • Load crashes with NullReference exception
    • Available Windows updates
    • Permissions Wizard issue
    • PowerPivot FileNotFoundException issue
    • SQL Clusters support
    • Storage Metrics report subscription
    • Unaccounted differences in the UPA settings
    • Custom Query issue with URL export
    • Recursive groups issue with export
  • Troubleshooting
    • SharePoint
      • Could not access content database
      • The service application ‘UPA Name’ does not have any proxies that are default in a proxy group
    • Server Load & User Permissions
      • RPC Server is Unavailable
      • Error occurred while loading Web Application
      • Error occurred while trying to load 'Problems and Solutions' and 'Rule Definitions'
      • Error while loading IIS Settings Information
      • Errors while trying to load the SharePoint farm
      • Errors while loading server information
      • Failed at retrieving SQL Accounts from the following servers
      • My permissions loading status is reported as ”Failed”
      • Service was unable to read Active Directory properties
      • SQL Server is unavailable
      • Error adding service account to "spdockit_service_role" database role
    • SQL Server Connection
      • SPDocKit won’t connect to a provided server and database
      • Configure SQL server to listen on a specific port
      • Is SQL Server configured to use a named instance
      • Inbound traffic on TCP Port 1433 needs to be allowed on the SQL
      • Service user does not have rights to connect to the SQL server
      • TCP/IP network traffic not enabled on the SQL Server
Powered by GitBook
On this page
  • General
  • Report Options
  • Service settings
  • Snapshot options
  • Load target
  • Data retention
  • Subscription settings
  • Compare

Was this helpful?

  1. Configure & Extend SPDocKit

Options Wizard

This article explains how to use the Options wizard to adjust and change your SPDocKit settings.

General

Here you can change the startup options:

  • Enable Verbose logging – use this only for diagnostics purposes or when asked by the support team.

  • Adjust proxy settings.

  • Turn on the automatic update check.

Report Options

Allows you to customize how documents are saved. Tags used while constructing the header and footer are: CompanyName, Logo, AppName, Date, Page, TotalPages and Server.

By using the | separator, the location of each tag can be specified i.e. if the header is set to {CompanyName}||{Logo}, the company name will appear in the upper left corner of the page, the upper center will be blank, and the upper right corner of the page will contain the logo (if uploaded).

The default footer is set to Generated by {AppName} on {Date}|Page {Page}/{TotalPages} i.e. the application name and the date the export was made will appear in the lower left corner of the page, the lower center will be blank and the lower right corner of the page will contain the number of the page currently opened along with the total page number.

Here you can also change the report throttling options:

  • Modify how many site collections will be shown in the Site Topology report.

  • Modify the maximum number of principals that will be used to generate data for in throttled reports.

  • Modify the maximum number of site collections that will be used to generate data for in throttled reports.

  • Modify the maximum number of query results per site collection.

  • Modify the maximum number of permissions to use in the Permission Details reports.

  • Modify the maximum number of rows in a report.

  • Modify the maximum number of rows supported in report export.

  • Modify the maximum number of audit logs supported in the Audit Log Details report.

Service settings

The snapshots are by default saved to the SPDocKit database. To back up your snapshots, enable the Save backup of snapshot file to disk option. You can also define a preferred disk location, where the backup files will be saved.

Here you can also define the SPDocKit Service running period. The time you set here determines when the Service will start taking an automatic snapshot to collect the data you specified in the Snapshot Options and Load Target tabs of the Options Wizard. The SPDocKit Service will repeat that task whenever the selected recurrence period runs out. The minimal period is 4 hours, while the default value is 1 day.

Check the Enable collection of site analytics from SharePoint's Usage and Health Data Collection service option if you want SPDocKit to collect data used for generating the Site Collections Analytics and Inactive Sites report. After being enabled for the first time, the Analytics job will immediately start to collect data for the last 7 days. It will further run on a daily basis (between 1AM and 5AM) and collect data for the previous day. You can also define accounts for which the data will not be collected.

Enabling the automatic index reorganization will result in better space usage and performance of the SPDocKit database. This job will always be run outside of regular business hours (around 5 AM by default).

Snapshot options

This section allows you to choose what will be loaded by both the SPDocKit Service when taking an automatic snapshot, and if you select the Default mode in the Take Snapshot wizard.

The options are grouped into 4 categories:

  • SharePoint

    • The Farm Settings checkbox will be selected by default. That means that SPDocKit will load farm settings by default and this option cannot be changed.

    • Content Types - When this option is selected, you’ll need to crawl down to each list on the farm since that is where the content types are defined.

    • SPDocKit also allows you to backup all *.wsp files in use by your farm, but you’ll need to define a location for this backup. This data can also be used later to find out whether there are any problems with the assemblies deployed on your farm.

    • Features and Solutions, Workflows

    • Document Versions, Extensions and Sizes - Enable this option to collect data about the number of documents on a farm and their total size by extension, which is used in Document Extensions Overview and Document Extension Details report.

  • Security

    • Database Permissions - Selecting this will enable you to view the Database Permissions report. This report shows information about all users, across all databases on a SQL Server.

    • Permissions - If you want to know the permissions of each list item on the farm, you can get that information by selecting the Permissions check box and setting the Load Depth to list item. You can also select the Active Directory Group Members check box if you wish to load members of the AD groups.

    • Administrative Actions Log - this option will be visible only for SharePoint 2016 FP1 farms and enables you to browse and analyze administrative actions logs collected from your SharePoint farm.

    • Audit Logs - this option is required to collect data for Audit Reports where a complete history of changes made on site collections is shown. Enable the Include Changes Made by System Account to load actions made by the System Account.

  • Server Settings

    • Installed Programs and available Updates

    • SQL Server and IIS Settings Information

  • Project Server

    • Settings

    • Projects

From version 7 and onwards, you can document Project Server settings, list of projects and their permissions.

You can also specify the load depth, which means how deep you want to crawl your SharePoint with SPDocKit. Possible choices are: site collection. subsites, list, and list items. Be aware that there are some dependencies related to the load depth selection and the available SharePoint information SPDocKit can retrieve. For example, if you want to load content types and workflows, lists are the minimum required load depth. SPDocKit will warn you if your current selection is not possible and provide instruction messages for enabling certain load options.

Finally, you can customize the snapshots name template. Under Snapshot Configuration, note the Snapshot Name Template field. We have prepared the Farm Name, Snapshot Mode (which can be either Automatic or Manual), and Date (which you can customize any way you like), keywords that can be included in the name template. The default date format is: “Date:yyyyMMdd_HH_mm_ss”. You can change the format by rearranging the item order and delimiter type. You can observe this name if you go to the Snapshots tab and include the File Name column using the View ribbon button called __Choose Columns.

To reduce the farm load time we recommend unchecking Personal Sites. You can use the load performance slider to switch between low resource usage and a high-performance load.

Load target

This section allows you to customize how SPDocKit crawls your SharePoint farm. If you know exactly what data you are interested in and want to reduce the loading time, you can narrow down your loading scope to a specific Web application, site collection or even subsite. If you want to be sure you’ve loaded the whole farm's content, farm is the recommended scope.

The selection you make here applies both for the SPDocKit Service taking an automatic snapshot and when using the Default mode in the Take Snapshot Wizard.

Data retention

In this section, the user can set how long data will be kept in the database.

Data retention settings for audit logs and administrative actions can be defined separately to better suit your recordkeeping requirements.

Data records from the SPDocKit database and on the disk older than the configured time value will be deleted. By default, data records are stored for 6 months before the data retention job removes them. SPDocKit service will execute this job every day at a random time between 4:00AM and 5:00AM.

Set the preferred database size and SPDocKit will warn you when the database size passes that threshold.

If your SPDocKit database becomes too big, you can force a manual data retention using the Execute button.

Please note! This action will also try to execute the SHRINKDATABASE command on your SPDocKit database, which will fail unless you have the necessary permissions – being member of the sysadmin server role or db_owner database role. Without those permissions, data will still be deleted, but the database size will not decrease. You can still attempt to manually decrease the size of SPDocKit's databases by executing the SHRINKDATABASE command manually after the data retention job has run.

Subscription settings

If you wish to use the Subscriptions and Alerts feature, check the Subscriptions Enabled box. Configure the job execution time and the day on which the weekly reports are sent. The time of day to send subscriptions option determines at which time the daily, weekly, monthly, and quarterly subscription are sent, while the Send weekly subscriptions option only dictates the day on which weekly subscriptions are sent.

To enable email as the preferred delivery method, configure outgoing email server settings. After the outgoing email server settings are provided, you can test if these are valid by clicking the Test Email Settings button. There is also an option to customize the email footer and email body text.

Compare

From SPDocKit 7.4.0. onwards you can define with which snapshot the current one is compared when detecting configuration changes.

  1. Previous snapshot - the current snapshot is compared with the last snapshot taken.

  2. Last good configuration - with this option selected, the current snapshot is compared with the latest snapshot that is marked as good.

  3. Selected snapshots - when this option is selected, you can choose between all your snapshots taken beforehand.

Please note! If you choose option 2. and there are no snapshots marked as good, SPDocKit will compare the current snapshot to the last snapshot taken. The same rule applies if you choose option 3. and the selected snapshot gets deleted.

This section also allows you to define which farm settings should be compared in the Compare Wizard. The selection you make here will be used as a default template when comparing two farms, but you can modify it directly in the Compare Wizard each time you use it.

PreviousBackstage ScreenNextLicense Management

Last updated 2 years ago

Was this helpful?

Please note! There is an option to “Mark Configuration as Good”. Marking a snapshot this way will exclude it from the data retention. For more information on this go .

here
Read more about scheduling subscriptions and alerts.