Configure

System > Configure

• This page applies to the following product: On Premises

The Configure page manages the configuration of your KServer and related services.

Note: For the latest instructions on migrating an existing KServer to a new machine see Moving the Kserver section in the the KB article latest Kserver installation and upgrade user guide.

Check for Update

Click Check for Update to determine if your KServer is the latest version available. If an update exists, a message alerts the master role user that an update is currently available and is applied at the next master role user logon. An update is only downloaded if the version currently running is older than the version available. Otherwise, no action is performed.

Version Number

Shows the version number of the system software and the hotfix level of your system.

Warn if the server cannot get updates from http://vsaupdate.kaseya.net

Check this box to display a warning if your VSA cannot connect to http://vsaupdate.kaseya.net to fetch the latest hotfix checker list, the latest PCI ID list used by audit, or the VSA software update notifications. Your VSA attempts to automatically fetch this information from http://vsaupdate.kaseya.net on port 5721. Verify that port 5721 outbound is not blocked by your firewall.

Warn when the license reaches the maximum number of seats

Check this box to display a warning when the number of machine ID accounts reaches the maximum for your VSA.

Hotfixes

Several options affect how hotfixes update your KServer.

Note: You can reference the latest hotfix level in System > License Manager.

• Enable automatic check every day at <TIME> - If checked, your KServer checks http://vsaupdate.kaseya.new for new only hotfixes each day at the specified time of day. If any new hotfixes are available, the KServer automatically downloads and applies the hotfixes without any user interaction.
  • Reload - Displayed if Enable automatic check is checked. Click to reload all hotfixes since the base release of the version of KServer your system is running.
  • Process Hotfix - Displayed if Enable automatic check is blank. Click to install a previously tested list of hotfixes. Typically these hotfixes were installed and tested on a staging KServer and are approved for installing on a production KServer. See Processing Hotfixes Manually.
• Get Latest Hotfix - Click to check if new hotfixes are available immediately and, if they are, download and apply them.
• Manually apply hotfixes - If your system is not connected to the internet or can not reach http://vsaupdate.kaseya.net, then click this link.
  • Check Now - Click to force the system to check for new hotfixes immediately. If any new hotfixes are available, they are downloaded and automatically applied. Only new hotfixes get loaded.
  • Reload - Click to re-download and apply all hotfixes for the version of KServer your system is running.
• Pending Hotfixes - Click to display a list of hotfixes that are available to apply.
• Hotfix History - Click to display a history of applied hotfixes.

Database

• Click Reapply Schema to re-install and validate the last database schema that was downloaded using Check for Update. Reapply schema is a safe operation that users can run in an attempt to resolve a variety of problems. Reapply schema:
  • Sets default values and runs basic consistency checks on the database.
  • Rebuilds all pre-defined Kaseya procedures.
  • Rebuilds all pre-defined Kaseya procedure samples.
  • Reschedules default backend processing procedures for the KServer.

    This is all completed without the risk of losing any agent data. This is a good self healing routine to run if you observe:

  • Procedures failing in the IF condition or in specific steps.
  • Pending alerts not being processed within a two minute interval. You can monitor this using the System > Statistics page. This might indicate a problem with backend processing procedures.
• Click Defrag Database to defragment the physical files on your disk arrays. Fragmented SQL Server data files can slow I/O access.

  Warning: Do not use the Microsoft SQL tuning advisor against the schema. It adds keys that conflict with the smooth operation of the system.

Sample Data

• Reload sample scripts with every update and database maintenance cycle - Check to reload sample agent procedures.
• Reload sample event sets with every update and database maintenance cycle - Check to reload sample event sets.
• Reload sample monitor sets with every update and database maintenance cycle - Check to reload sample monitor sets.

HTTPS

• Automatically redirect to https at logon page (except when accessing via localhost) - If checked, ensures all users logging into the VSA remotely use the secure HTTPS protocol.

API

• Enable VSA API Web Service - Check to enable the VSA API Web Service.

Invalid Patch Location Notification

• Enable Invalid Patch Location Notifications - Microsoft sometimes prepares patches that do not allow the File Source function to download patches successfully. If checked, this option notifies Kaseya that an "invalid patch location" exists for a patch required by any of the managed machines on your system. Notification alerts Kaseya to prepare a valid patch location manually and send it out as an updated patch location override for all customers to use. If blank, no notification is sent to Kaseya. You will still receive updated patch location overrides prepared in response to notifications reported by other customers, regardless of this setting.

  Note: Notification sends no customer-specific or machine-specific information to Kaseya.

Downloading Attachments in Ticket Notifications

• Allow non-authenticated users to download attachments from ticket notifications - If checked, links to attachments embedded in the notes of tickets can be opened in outbound emails without requiring the user to authentic themselves to the VSA. For security reasons, enabling this option is not recommended.

Backups

• Run database backup / maintenance every <N> Days @ <Time> - The KServer automatically backs up and maintains the MS-SQL database and transaction log for you. Click Set Period to set the frequency and time selected. If your KServer is shut down at the scheduled backup time, the backup will occur the next time the KServer goes online. You can enter zero to disable recurring backups.
• Backup folder on KServer - Set the directory path to store database backups in. The default directory path is typically C:\Kaseya\UserProfiles\@dbBackup. Click Change to confirm changes to the directory path. Click Default to reset the directory path to its default.

  Note: Database backups older than three times the backup and maintenance period are discarded automatically to prevent your disk drive from filling up. For example, if the backup occurs every 7 days, any backup older than 21 days is deleted.

• Change DB - Connect your KServer to a database on a different machine.
  1. Backup your existing ksubscribers database by clicking Backup Now in the System > Configure page.
  2. Copy the database backup file to the database server you wish to connect to.
  3. Use SQL Server Management Studio (SSMS) on the new database server to restore the ksubscribers database. Right click Databases > Restore Databases...
  4. Verify the restored ksubscribers database is set to mixed mode authentication.
     • In SQL Server Management Studio (SSMS) right click the restored ksubscribers database and select Properties.
     • Click the Security tab.
     • Under authentication, select SQL Server and Windows.
     • Click OK.
  5. Verify CLR is enabled in the new database server.
  6. Verify your KServer is on the same LAN as your new database server and port 1433 is open on the database server.
  7. Click the Change DB button.
  8. Enter the database location using one of the following formats:
     • computer name
     • computer name\instance name
     • IP address
  9. Enter a database logon name. The default logon name is sa.

     Note: This logon is only used to configure the database. The system creates its own database logon to use going forward.

  10. Enter the password associated with this logon name.
  11. Click Apply. The system then connects to the remote database and configures it.
• Backup Now - Initiate a full database backup now. Use this function before you shut down or move your KServer, to ensure you have the latest KServer data saved to a backup. The backup will be scheduled to run within the next 2 minutes.
• Restore - Click to restore the KServer's database from a backup file. A file browser displays a list of KServer database backup files you can restore from.

  Note: After a restore of a 5.1 database, the SSRS URL will be invalid and need to be reset. After a restore of a 6.x database the SSRS URL may be invalid and need to be reset.

Archive

Archiving of agent logs are enabled, by log and machine ID, using Agent > Log History.

• Archive and purge logs every day at <time> - Specifies the time of day log files are archived and purged.
• Set Period - Click to confirm changing the time log files are purged and archived.
• Log file archive path - The file location where the archive files are stored.

  Note: Monitoring data log archives are stored in the <KaseyaRoot>\UserProfiles\@dbBackup directory. This is to improve performance on systems where the database is on a different server. All other agent log archives are stored in the directory specified by the System > Configure > Log file archive path field.

• Change - Click to the confirm changing the archive file location. A procedure runs to move any existing archive files in the old file location to the new file location.
• Default - Resets the log file archive path to the default location on the KServer. A procedure runs to move any existing archive files in the old file location to the new file location.

Service Status

• KServer Log - Displays the last 300 kbytes of the KServer's log file. The entire log file is up to 5 Mbytes in size and is located at xx\KServer\KServer.log where xx is the parent directory of the VSA web directory.
• Live Connect KServer - An agent is automatically installed on the Kserver. You can click the check-in icon for this agent to initiate a Live Connect session with the Kserver.
• Stop KServer - Shows the current status of the KServer: running or stopped. The KServer can be stopped by clicking Stop Service.
• Clear the Enable alarm generation box to prevent generating unnecessary alarms. This can occur if you stop the KServer, disconnect from the internet, or maintain the system. Otherwise leave this box checked.
• Restart MsgSys - Restarts the MessageSys service. This service is the application server that manages requests from VSA application users.
• Enable logging of procedure errors marked "Continue procedure if step fail" - If checked, failed steps in procedures are logged. If blank, failed steps in procedures are not logged.
• Restart Network Discovery - Restarts the Network Discovery service if the service has stopped.

Select time format

Click the appropriate radio button to select how time data is displayed. The default is AM/PM format. Both these display formats are compatible with Microsoft Excel.

• AM/PM format - 9:55:50 pm 9-Apr-07
• 24-hour format - 21:55:50 9-Apr-07

  Note: Time offset is set in System > Preferences.

Change external name / IP address of Server

Shows the current external name or IP address of the KServer. This is the address the agents of managed machines access for check-in purposes. The address can be changed by entering a new address or host name in the field and pressing Change Name/IP.

Note: Do not use a computer name for your KServer. The agent uses standard WinSock calls to resolve a IP address from a fully qualified host name. Resolving an IP address from a computer name requires NETBIOS, which may or may not be enabled on each computer. NETBIOS is an optional last choice that the Windows will attempt to use to resolve a name. Therefore, only fully qualified names or IP addresses are supported.

Set URL to MS-SQL Reporting Services Engine

Click the Change URL... button to specify the URL used by the VSA to connect to Reporting Services. You can also specify the credential used to access Reporting Services and customize the URL displayed in the header of all VSA reports.

Change System Server Port

Specify port Agents check into Server with - Entering a different port and clicking Change Port switches the port the KServer uses immediately.  

Warning: Before you change the KServer port ensure that all agents are set to use the new port with their primary or secondary KServer. Agent check-ins are configured using Agent > Check-in Control.

KServer ID

ID used to bind agents to the Kserver - The unique identifier for this Kserver. Bound agents cannot check-in successfully unless the unique Kserver ID they are bound to using the Agent > Check-in Control page matches the unique ID assigned to the KServer using the System > Configure page. Only change the KServer ID if you are installing a fresh VSA and wish to duplicate the ID of an existing KServer with agents already bound to it.

Version Information

Displays the following information about your VSA configuration.

• OS Version
• IIS Version
• KServer Version
• SQL Version
• Database Location
• Agent On KServer

Release Notes

Click Release Notes to display a list of all changes and enhancements made to the VSA, for all versions of the software.

Show License

Click Show License to display the current license agreement to use the VSA.

Topic 248: Send Feedback. Download a PDF of this online book from the first topic in the table of contents. Print this topic.