En KserverInstall61
En KserverInstall61
About Kaseya
Kaseya is a global provider of IT automation software for IT Solution Providers and Public and Private Sector IT organizations. Kaseya's IT Automation Framework allows IT Professionals to proactively monitor, manage and maintain distributed IT infrastructure remotely, easily and efficiently with one integrated Web based platform. Kaseya's technology is licensed on over three million machines worldwide.
Contents
Introduction Pre-Installation 3 4
Pre-Install Checklist ....................................................................................................................................... 4 System Requirements ................................................................................................................................... 5 Unsupported Kaseya Server Platforms ......................................................................................................... 5 Using Microsoft SQL 2005 64 Bit .................................................................................................................. 5 Disk Sizing Requirements ............................................................................................................................. 5 Memory (RAM) Requirements ....................................................................................................................... 6
Prerequisite Installs
Installing Microsoft NET Framework ............................................................................................................. 6 Installing Internet Information Service (IIS) ................................................................................................... 6 Installing ASP.NET State Service ................................................................................................................. 8 Installing Message Queuing Service (MSMQ) .............................................................................................. 9 Apply Latest OS Patches............................................................................................................................... 9 Bypass Proxy Server ................................................................................................................................... 10 Kaseya Server Domain Name or IP Address .............................................................................................. 10 Port Configuration ........................................................................................................................................ 11 Installing SQL Server................................................................................................................................... 11 Configuring SQL Server Reporting Services ............................................................................................... 14
14
Anti-Virus Software ...................................................................................................................................... 14 K2 Installation Steps .................................................................................................................................... 15 Create a New Master User .......................................................................................................................... 22 Installing Add-on Modules to a New K2 Installation .................................................................................... 23 Reporting Installer Problems ....................................................................................................................... 24
25
Updating the Kaseya Server on the Same Machine ................................................................................... 25 Pre-Update Checklist ........................................................................................................................ 25 Backup the Kaseya Server ................................................................................................................ 26 Scheduling the Update ...................................................................................................................... 26 Anti-Virus Software............................................................................................................................ 26 Updating from 5.1 to 6.1 .................................................................................................................... 27 Updating from 6.x to 6.1 .................................................................................................................... 32 Updating Add-on Modules ................................................................................................................. 35 Reporting Installer Problems ............................................................................................................. 36 Updating the Kaseya Server while Moving to New Hardware..................................................................... 37 Pre-Update Checklist ........................................................................................................................ 37 Backup the Kaseya Server ................................................................................................................ 37 Scheduling the Update ...................................................................................................................... 37 Anti-Virus Software............................................................................................................................ 37
Moving the Kaseya Server ................................................................................................................ 38 Archiving the Kaseya Server ............................................................................................................. 39 Reporting Installer Problems ............................................................................................................. 41
42
Testing Browser Access .............................................................................................................................. 42 Testing Outbound Email .............................................................................................................................. 43 Testing Report Generation .......................................................................................................................... 43
44 45 45
ii
Introduction
Introduction
The following instructions describe how to: Install a new Kaseya 2 (K2) Server, or Upgrade to K2 from an existing Kaseya Server running Kaseya v4.x or later.
About Kaseya
The Kaseya Server allows administrators to manage their entire computing infrastructure with one integrated web-based information technology application. The Kaseya Server is the central component of the Kaseya IT Framework, issuing schedule-based instructions to Kaseya agents. All communication to the Kaseya Server is initiated from a Kaseya agent, making it virtually impossible for a third-party application to attack the agent from the network. Administrators access the Virtual System Administrator (VSA) console through a web interface, allowing them to perform and schedule system management activities to remote systems.
Pre-Installation
Pre-Installation
Pre-Install Checklist
Before installing the Kaseya Server software, use the checklist below to verify that all the necessary prerequisites have been met.
Note: Installing Kaseya on a domain controller is NOT supported. Note: Installing Kaseya on a server running Microsoft Exchange is NOT supported. Note: Installing Kaseya on a server running MS Small Business Server is NOT supported. Note: Installing Kaseya on a server running other server products other than SQL Server is NOT supported. If you are running a 3rd party product that integrates with Kaseyafor example, Autotask, ConnectWise, or Tigerpawcheck with the 3rd party vendor to ensure their integration is compatible with the version of Kaseya you are upgrading to. Verify the system requirements (http://help.kaseya.com/WebHelp/EN/VSA/6010000/InstallationPrerequisites.asp ) for the number of agents that you plan to support.
Windows version and service pack level SQL Server version and service pack level. See Using Microsoft SQL 2005 64 Bit (page 5).
Install Microsoft .NET Framework 2.0 (page 6). Install Microsoft .NET Framework 3.5 (page 6). Install Microsoft Internet Information Services (IIS) (page 6). Install Microsoft ASP.NET State Service (page 8). Install Microsoft Message Queue (MSMQ) (page 9). Install SQL Server (page 11), including Reporting Services. Make a note of the SQL Server system administrator (sa) password for future reference. Configure SQL Server Reporting Services (page 14). Apply the latest patches (page 9) for the operating system. Ensure any proxy servers are bypassed (page 10). Determine the Kaseya domain name or IP address (page 10) the Kaseya Server will use. Open the appropriate ports in the internet firewall. See Port Configuration (page 11). Open the appropriate ports in the Windows firewall on the server hosting the KServer. See Port Configuration (page 11). Disable real-time anti-virus security protection (page 14) just before beginning the install.
Pre-Installation
System Requirements
Kaseya recommended system requirements (http://help.kaseya.com/WebHelp/EN/VSA/6010000/InstallationPrerequisites.asp ) are a guide to help the user plan for a Kaseya implementation, based on the number of agents to be deployed.
Important: The Kaseya Service software must be installed on a server dedicated to the Kaseya application to qualify for server-related support.
Prerequisite Installs
Prerequisite Installs
The following prerequisites apply to both new K2 installs of Kaseya and updates to K2 from previous versions of Kaseya. IIS for your operating system Microsoft NET Framework 3.5 Service Pack 1 or later Message Queuing Service (MSMQ) SQL Server SQL Server Reporting Services
Prerequisite Installs
Vista Pro
Open the Control Panel and select Programs Select Programs and Features Select Turn Windows Features On or Off Check the box to select Internet Information Services Expand World Wide Web Services Expand Common HTTP Features and check all boxes to select all features Expand Application Development Features and check all boxes to select all features Click the OK button.
Windows 7 Pro
Open the Control Panel and select Programs Select Programs and Features Select Turn Windows Features On or Off Check the box to select Internet Information Services Expand World Wide Web Services Expand Common HTTP Features and check all boxes to select all features Expand Application Development Features and check all boxes to select all features Expand Security and click authentication Methods Basic, Digest, and Windows Click the OK button.
Prerequisite Installs
Prerequisite Installs
Windows XP Pro
Open Add/Remove Programs in control panel. Click Add/Remove Windows Components. If checked, uncheck Message Queuing. Click Next to remove Queuing completely. Return to Add/Remove Windows Components. Check Message Queuing and then click Details. Uncheck Active Directory Integration.
Prerequisite Installs
Agents
Kaseya agents may be configured to connect to the Kaseya Server through a proxy server. See the following KB articles. WinHTTPProxy - A Windows feature that allows Windows services to use a proxy server. This is required for patch management to work on agents that are behind a proxy. See Kaseya KB article 274832 (http://help.kaseya.com/WebHelp/KB-Article.asp?274832). cURL - Kaseya uses a small program on both the agent and Kserver to fetch URLs. By default cURL does not use a proxy server. A page within the Kaseya interface allows you to specify proxy details for cURL. From that point onwards, any requests cURL makes to the internet will go through the proxy. See Kaseya KB article 280006 (http://help.kaseya.com/WebHelp/KB-Article.asp?280006). Kaseya proprietry protocol - The protocol the agent uses to speak to the Kserver. This is a proprietary, encrypted protocol that does not support the use of proxy servers. It requires the agent connect directly to the Kserver. See Kaseya KB article 291728 (http://help.kaseya.com/WebHelp/KB-Article.asp?291728).
10
Prerequisite Installs
Port Configuration
The following ports need to be open on two separate firewalls: Internet Firewall Windows Firewall on the Server Hosting the KServer and/or Database Server Ensure other systems or services are not using these ports.
Internet Firewall
TCP and UDP 5721 - inbound and outbound - A single port number specification5721 by defaultsets the ports used for the following: Kaseya agents use inbound TCP port 5721 to communicate with the Kaseya Server. The Kaseya Server uses outbound TCP port 5721 to communicate with Kaseyas Corporate Headquarters. UDP 5721 - inbound and outbound - required to use Live Connect. The default 5721 port number may be changed to any other free and available port during or after Kaseya Server installation. TCP 25 - Used to send email alert notifications. TCP 80 (HTTP) or TCP 443 (HTTPS) - Enables system administrators to connect to Kaseya web pages for remote management.
Changing the Port Used by the VSA from Port 80 - Consult the KB article HOWTO: Change the port that the Kaseya VSA web console runs on from port 80 (http://help.kaseya.com/WebHelp/KB-Article.asp?286163).
Windows Firewall on the Server Hosting the KServer and Database Server
TCP and UDP 5721 - inbound and outbound - A single port number specification5721 by defaultsets the ports used for the following: Kaseya agents use inbound TCP port 5721 to communicate with the Kaseya Server. The Kaseya Server uses outbound TCP port 5721 to communicate with Kaseyas Corporate Headquarters. UDP 5721 - inbound and outbound - required to use Live Connect. The default 5721 port number may be changed to any other free and available port during or after Kaseya Server installation. TCP 25 - Used to send email alert notifications. TCP 80 (HTTP) or TCP 443 (HTTPS) - Enables system administrators to connect to Kaseya web pages for remote management. TCP 1433 and UDP 1434 - If your SQL Server is on a separate system, you may have to open TCP port 1433 and UDP port 1434 on the KServer and SQL Server machines. Other ports may be required for non-default SQL Server instances.
Prerequisite Installs sp_dbcmptlevel 'ksubscribers' - Running this stored procedure displays the compatibility level. sp_dbcmptlevel 'ksubscribers', 90 - Running this stored procedure sets the compatibility level to SQL 2005. If you are using SQL Server 2008, do not run this stored procedure. If your SQL Server is on a separate system, you may have to open TCP Port 1433 and UDP Port 1434. Other ports may be required for non-default instances of SQL Server. If your SQL Server is on a separate system, ensure the following services use Network Service logons. SQL Server Service SQL Server Browser Set collation to SQL_Latin1_General_CP1_CI_AS. Earlier versions of Kaseya allowed different collations to be used. If you are updating to 6.0 from an earlier version of Kaseya and using a collation other than SQL_Latin1_General_CP1_CI_AS : Install SQL Server using the SQL_Latin1_General_CP1_CI_AS collation. You cannot select the collation for SQL Server after it is installed. If necessary, uninstall SQL Server entirely, then reinstall SQL Server using this collation. Restore the ksubscribers database into SQL Server and set the ksubscribers collation to SQL_Latin1_General_CP1_CI_AS. When SQL Server is on a separate system, ensure the SQL Server system and Kserver system are synchronized to within a couple of minutes of each other. A time service is recommended.
12
Prerequisite Installs
13
Anti-Virus Software
On both the Kserver and on the SQL Server: Disable real time scanning for all anti-virus software Disable Data Execution Prevention (DEP), if necessary, using the System dialog box in Control Panel. Remember to enable these features after the installation is complete. 14
K2 Installation Steps
The Kaseya installation package automates most setup actions. However, some basic user interaction is required. Follow the steps below. 1. Logon to the install machine as an administrator. 2. Disable anti-virus software (page 14) protection. 3. Download the update file KaseyaVSA.exe (http://www.kaseya.com/forms/welcomek2v61.aspx). 4. Start the install. For Windows 2008 Servers only - You must start the install by right clicking KaseyaVSA.exe and selecting the Run as Administrator option to install KaseyaVSA.exe. 5. The first page of the install wizard displays. Confirm your agreement with the changes that will be made to your system, as specified in this dialog.
15
The complete contents of this dialog follow: Prerequisites: Kaseya provides a document of minimum hardware needed to run K2 VSA based on the number of agents to be deployed. Before you proceed, you should review this document to confirm that your system meets these requirements. The System Requirements are available via the following link: http://help.kaseya.com/WebHelp/EN/VSA/6010000/InstallationPreRequisites.asp If you proceed with this installation the following changes will be made to your system by the installer. Default web site will host Kaseya IIS Security settings will be altered IIS virtual directories will be added SQL Server: CLR will be enabled ksubscribers database will be added Memory settings will be changed Logins will be added. The installer is also going to check for the following software components: Microsoft .NET Framework 3.5 installed Microsoft .NET Framework 2.0 installed Microsoft Message Queuing (MSMQ) enabled Microsoft SQL Server installed on this or a remote server. Microsoft SQL Server Reporting Services installed and operational. Compatible Microsoft SQL Server Versions: SQL Server 2005 - SP3, or SQL Server 2005 Express with Advanced Services - SP3, or SQL Server 2008 - SP1, or SQL Server 2008 Express with Advanced Services - SP1 If any of these software components are not available, please exit and make the necessary adjustments to your system before you proceed with the installation. When upgrading from a previous version, you must review and follow the documented Upgrade Guide. This includes making a full backup of your production system. For a fresh installation, an Installation Guide is provided. You should review the guide before you proceed. The Upgrade Guide and the Installation Guide are available via the following link: http://help.kaseya.com/WebHelp/EN/VSA/6010000/installationGuide.asp You will also find an informative installation video at the following link: http://help.kaseya.com/WebHelp/EN/VSA/6010000/installationVideo.asp If your system meets all of these requirements, press Next; otherwise, press Cancel and make the necessary adjustments before you proceed.
16
Installing a New K2 Kaseya Server 7. Select the location of the SQL Server and the instance name to use for the Kaseya database. Select the first option SQL Server is the default instance on this local computer you are using the default SQL Instance on the local machine Select the second option SQL Server is a named instance and/or on a remote computer if you are using a remote machine, or a named instance on the local computer. Enter the computer namenot "." or "localhost" or "127.0.0.1"and the instance name.
8. If the install is unable to connect to the SQL Server Reporting Services engine for some reason, the following wizard page displays. Specify the URL of your SQL Server Reporting Services engine. See Configuring SQL Server Reporting Services (page 14) for details.
17
Installing a New K2 Kaseya Server 9. The installation application prompts you to select the location for Kaseya Server files to be installed. The installation path may not contain any spaces.
10. Enter the license. If you do not have a license key, contact your Kaseya sales representative.
Note: The Next button will remain grey until a valid 26-character code has been entered.
11. Once the license code has been accepted, the database configuration dialog is displayed. SQL Server requires SA user rights to install the database. Enter the SQL system administrator user name (sa) and password. Kaseya recommends accepting the default SQL Memory Size.
18
Installing a New K2 Kaseya Server 12. The system prompts you to enter a Kaseya VSA User and Password. This creates a user with a Master role and a Master scope. Both the user name and password are case sensitive.
Note: This is the Kaseya user name, not a database user name.
13. Enter the host name or IP address of the Kaseya Server. The host name should be resolvable by all systems on the local network and across the internet. Kaseya agents will use this name or IP address to communicate with the KServer. The user has the option of changing the default port number that Kaseya agents use to connect to the Kaseya Service. The port number can also be changed after installation.
Note: Do not set the Port Number to 80. Port 80 is already used by IIS and will result in conflict. Best Practices: Although a public IP address may be used, Kaseya recommends using a domain name server (DNS) name for the KServer. This practice is recommended as a precaution should the IP address need to change. It is easier to modify the DNS entry than redirecting orphaned agents.
19
Installing a New K2 Kaseya Server 14. Specify outbound email server information. Enter a valid email address. This address is used as the 'reply to' address for messages sent from the Kaseya Server. Kaseya recommends using the address for the ticketing system or a group distribution address. Do not use a personal email address. A common choice is [email protected].
Enter the 'From' email address for emails sent from this VSA server: - Enter the default 'From' address displayed by outbound email. Mail Server Hostname or IP Address - The name of the host email server. Example: smtp.gmail.com. Port - Typically 25, but the host email server may require a different port number. Anonymous access - No authentication required. Basic Authentication - Authentication required. User Name - Enter the username of an account authorized to use the host email server. Password - Enter the password of the account. Password Confirmation - Re-enter the password of the account. 15. The Install Shield portion of the install runs to completion without further user input. This usually takes about 10 to 20 minutes depending on the speed of your machine. After the Install Shield portion of the installation completes, a browser opens and downloads any hotfixes that have been made to the system since the release of this version of Kaseya. Then Reapply-Schema runs, which upgrades and installs the new database schema.
20
Installing a New K2 Kaseya Server 16. Upon completion of the installation, a web browser window displays the logon page. Logon using the username and password you entered in step 12 (page 20) above.
Note: See Create a New Master User (page 22) if you are unable to logon successfully.
Note: For assistance with any installation errors, contact Kaseya support using https://portal.kaseya.net (https://portal.kaseya.net) and include a full description of the issue and attach the Kaseya installation log found at %WINDIR%\kaseya.html.
17. Re-enable anti-virus software (page 14) protection. 18. Finalize and test your new installation (page 42).
21
To create a new master user account: 1. Log in to the machine running the KServer. 2. Access the following web page: http://localhost/LocalAuth/setAccount.asp 3. Enter a new account name in the Master User Name field. 4. Enter a password in the Enter Password field and confirm it by re-typing it in the Confirm Password field. 5. Click Create. You will now be logged in to the system as a new master user.
22
23
24
Pre-Update Checklist
Note: Do not proceed with the Kaseya update unless the Pre-Install Checklist (page 4) and Pre-Update Checklist (page 25) have been completed. Identify the license code of your existing Kaseya Server. Make a full backup your Kaseya server (page 26) (and database servers if SQL is running on a separate machine) Ensure you are prepared to revert back to your full backup to avoid disruption to your production system, if you encounter issues as a result of the upgrade. Separately backup the ksubscribers database and your Kaseya Server User directories. See Backup Kaseya VSA Server (page 26) for more information. If migrating from 5.x to 6.x, decide how you want organizations to be created when updating from an earlier version of Kaseya. You should carefully review this configuration option before beginning the update. It is described in detail in step 9 of K2 Update Steps (page 30). If migrating from 5.x to 6.x, block agents from checking into the server until you are satisfied the data conversion is correct. If migrating from 5.x to 6.x, identify the settings used to define any Monitor 95th Percentile reports in your 5.x VSA. These reports will have to be recreated in 6.0.1.change Schedule the update (page 26). Disable anti-virus security protection (page 26) just before beginning the update.
25
Anti-Virus Software
On both the Kserver and on the SQL Server: Disable real time scanning for all anti-virus software Disable Data Execution Prevention (DEP), if necessary, using the System dialog box in Control Panel. Remember to enable these features after the installation is complete.
26
4. Start the update. For Windows 2008 Servers only - You must start the update by right clicking KaseyaVSA.exe and selecting the Run as Administrator option. 5. The first page of the update wizard displays. Confirm your agreement with the changes that will be made to your system, as specified in this dialog.
27
The complete contents of this dialog follow: Prerequisites: Kaseya provides a document of minimum hardware needed to run K2 VSA based on the number of agents to be deployed. Before you proceed, you should review this document to confirm that your system meets these requirements. The System Requirements are available via the following link: http://help.kaseya.com/WebHelp/EN/VSA/6010000/InstallationPreRequisites.asp If you proceed with this installation the following changes will be made to your system by the installer. Default web site will host Kaseya IIS Security settings will be altered IIS virtual directories will be added SQL Server: CLR will be enabled ksubscribers database will be added Memory settings will be changed Logins will be added. The installer is also going to check for the following software components: Microsoft .NET Framework 3.5 installed Microsoft .NET Framework 2.0 installed Microsoft Message Queuing (MSMQ) enabled Microsoft SQL Server installed on this or a remote server. Microsoft SQL Server Reporting Services installed and operational. Compatible Microsoft SQL Server Versions: SQL Server 2005 - SP3, or SQL Server 2005 Express with Advanced Services - SP3, or SQL Server 2008 - SP1, or SQL Server 2008 Express with Advanced Services - SP1 If any of these software components are not available, please exit and make the necessary adjustments to your system before you proceed with the installation. When upgrading from a previous version, you must review and follow the documented Upgrade Guide. This includes making a full backup of your production system. For a fresh installation, an Installation Guide is provided. You should review the guide before you proceed. The Upgrade Guide and the Installation Guide are available via the following link: http://help.kaseya.com/WebHelp/EN/VSA/6010000/installationGuide.asp You will also find an informative installation video at the following link: http://help.kaseya.com/WebHelp/EN/VSA/6010000/installationVideo.asp If your system meets all of these requirements, press Next; otherwise, press Cancel and make the necessary adjustments before you proceed.
28
Updating an Existing KServer to K2 7. If the install is unable to connect to the SQL Server Reporting Services engine for some reason, the following wizard page displays. Specify the URL of your SQL Server Reporting Services engine. See Configuring SQL Server Reporting Services (page 14) for details.
8. Specify outbound email server information. This information will be filled in for you if you have already specified outbound email in your previous version of Kaseya.
Note: This wizard page does not display if you are performing an update of an existing K2 environment and outbound email is already defined.
If these outbound email fields are blank, enter in the following information, if available.
Note: If you want to specify outbound email settings after the update you can set them from within the VSA using System > Outbound Email.
Enter the 'From' email address for emails sent from this VSA server: - Enter the default 'From' address displayed by outbound email.
29
Updating an Existing KServer to K2 Mail Server Hostname or IP Address - The name of the host email server. Example: smtp.gmail.com. Port - Typically 25, but the host email server may require a different port number. Anonymous access - No authentication required. Basic Authentication - Authentication required. User Name - Enter the username of an account authorized to use the host email server. Password - Enter the password of the account. Password Confirmation - Re-enter the password of the account. 9. If you are upgrading from v5.x you will have to decide how organizations will be created for existing machine groups. User security for K2 requires all machine groups belong to an organization. The K2 update creates organizations for machine groups automatically. Create Multiple Organizations, One for Each Top-Level Machine Group Use this option if most of your existing machine groups represent external customers. Each top-level machine group is converted into its own organization. Machine group listings appear similar to the way they looked in earlier versions of the VSA. A special root machine group is created to take the place of a top-level machine group converted into an organization The root machine group contains any agents that belonged to the top-level machine group that is now being converted into an organization. Second-level machine groups now become top-level machine groups in the new organization.
Create a Single Organization Use this option if most of your existing machine groups belong to the same organization. All machine groups are added to a single myOrg organization, representing your own organization. The myOrg organization can be renamed after the update.
30
Updating an Existing KServer to K2 10. The Install Shield portion of the install runs to completion without further user input. This usually takes about 10 to 20 minutes depending on the speed of your machine. After the Install Shield portion of the install completes, the install begins downloading hotfixes and reapplying the database schema, which occurs in three passes. This will take some time.
11. Upon completion of the installation, a web browser window displays the logon page. Logon using any username and password the existed in your previous version of Kaseya.
Note: For assistance with any installation errors, contact Kaseya support using https://portal.kaseya.net (https://portal.kaseya.net) and include a full description of the issue and attach the Kaseya installation log found at %WINDIR%\kaseya.html.
12. Re-enable anti-virus software (page 26) protection. 13. Finalize and test your new installation (page 42).
31
4. Start the update. For Windows 2008 Servers only - You must start the update by right clicking KaseyaVSA.exe and selecting the Run as Administrator option. 5. The first page of the update wizard displays. Confirm your agreement with the changes that will be made to your system, as specified in this dialog.
Note: See K2 Installation Steps - Step 5 (page 16) for all the text displayed on this wizard page. You can also print all the text using this wizard page.
32
Updating an Existing KServer to K2 7. A Mail Server Configuration wizard page does not display if you are performing an update of an existing K2 environment and outbound email is already defined.
Note: See K2 Installation Steps - Step 13 (page 20) if the Mail Server Configuration wizard page displays and you want further information on how to configure outbound email immediately. You can also configure outbound email after the update within the VSA using System > Outbound Email.
8. The Install Shield portion of the install runs to completion without further user input. This usually takes about 10 to 20 minutes depending on the speed of your machine. After the Install Shield portion of the install completes, the install begins downloading hotfixes and reapplying the database schema, which occurs in three passes. This will take some time.
33
Updating an Existing KServer to K2 9. Upon completion of the installation, a web browser window displays the logon page. Logon using any username and password the existed in your previous version of Kaseya.
Note: For assistance with any installation errors, contact Kaseya support using https://portal.kaseya.net (https://portal.kaseya.net) and include a full description of the issue and attach the Kaseya installation log found at %WINDIR%\kaseya.html.
10. Re-enable anti-virus software (page 26) protection. 11. Finalize and test your new installation (page 42).
34
User State Management (KUSM) - This module has been renamed. If you are licensed for KUSM and already have it installed, version 3.0 of Desktop Policy and Migration (KDPM) will be installed as part of the K2 update. Kaseya Service Desk (KSD) - This module was made available to beta users of K2.
Installing Add-on Modules For the First Time with this Release
If you are installing any add-on modules for the first time with this release, you can download the add-on modules from the following locations. Backup http://download.kaseya.com/components/kbu/KBUinstall.exe Desktop Policy and Migration, previously called Kaseya User State Management http://download.kaseya.com/components/kdpm/KDPM.exe Endpoint Security http://download.kaseya.com/components/kes/KES.exe Service Desk http://download.kaseya.com/components/sd/SDinstall.exe Network Discovery http://download.kaseya.com/components/knd/KNDinstall.exe Antivirus http://download.kaseya.com/components/kav/KAVinstall.exe Anti-Malware http://download.kaseya.com/components/kam/KAMinstall.exe Service Billing (Release Candidate) http://download.kaseya.com/components/ksb/KSBinstall.exe Enterprise Management (to be released) http://download.kaseya.com/components/kem/KEMinstall.exe Policy Management (to be released) http://download.kaseya.com/components/kpm/KPMinstall.exe Directory Services (to be released) http://download.kaseya.com/components/kds/KDSinstall.exe Online Backup (to be released) http://download.kaseya.com/components/kob/KOBinstall.exe
35
36
Pre-Update Checklist
Warning: Do not proceed with the Kaseya update unless the Pre-Install Checklist (page 4) and Pre-Update Checklist have been completed. Identify the license code of your existing Kaseya Server. Make a full backup your Kaseya server (page 37) (and database servers if SQL is running on a separate machine) Ensure you are prepared to revert back to your full backup to avoid disruption to your production system, if you encounter issues as a result of the upgrade. Separately backup the ksubscribers database and your Kaseya Server User directories. See Archiving the Kaseya Server (page 39) for more information. Schedule the update (page 37). Disable anti-virus security protection (page 37) just before beginning the update.
Anti-Virus Software
On both the Kserver and on the SQL Server: Disable real time scanning for all anti-virus software Disable Data Execution Prevention (DEP), if necessary, using the System dialog box in Control Panel. Remember to enable these features after the installation is complete. 37
If your existing Kaseya Server is 5.1 or earlier, disable SMTP on the localhost. If your existing Kaseya Server is 5.2 or later, change the port number using the System > Configure page.
If you specify a SQL Server instance on a remote machine and it has a ksubscribers database, you will get a prompt asking you to confirm that you want to update, if necessary, that database and redirect it to the new Kaseya Server. Clicking Yes to this prompt will take the database away from the existing Kaseya Server using it and redirect it to the new Kaseya Server you are installing.
Updating an Existing KServer to K2 Change the IP address of the network adaptor used by your new Kaseya Server to use the original IP address of your existing Kaseya Server. Agents will now start to check into your new Kaseya Server.
Note: If you elected to run your existing/old Kaseya Server while you set up the new Kaseya Server with a new name and IP address, then you must change all the agent accounts on the new Kaseya Server to use the new Kaseya Server name and IP address. After the new Kaseya Server agent accounts are properly set, change all the agent accounts on the existing/old Kaseya Server to use the new Kaseya Server name and IP address. Use the Agent > Check-in Control page in the VSA to redirect the agents to the new Kaseya Server and IP address. You will need to leave your existing/old Kaseya Server active long enough for all of your agents to check-in and be redirected to the new Kaseya Server.
SQL Server logon - The system administrator logon (sa) and password for the SQL Server hosting your ksubscribers database. VSA master user logon - The VSA logon username and password of a master administrator. Kaseya install directory - The fully qualified pathname of the <Kaseya Install directory>. Outbound Email Host - The VSA outbound email host name and port. Inbound Email Server - The email server, port, and if necessary, the credential for inbound email defined in the Ticketing > Email Reader page.
39
<Kaseya_Installation_Directory>\UserProfiles (excluding the @backup folder) This directory contains the files associated with your managed machines. <Kaseya_Installation_Directory>\WebPages\ManagedFiles (excluding VSAHiddenFiles) - This directory contains the scripts and managed files belonging to each administrator, as well as KES profiles.
Warning: Do not copy VSAHiddenFiles, found inside the WebPages\Managed files directory, from an old system to a new system. This directory contains many system helper files. Your new system install contains the latest versions of these files.
<Kaseya_Installation_Directory>\WebPages\DataReports - This directory contains scheduled reports. These following directories only need to be archived if customization of the VSA has created them: <Kaseya_Installation_Directory>\Kserver\ignoresubject.txt - This file only exists if inbound email is being filtered using the Reject inbound emails containing the following in the subject line edit box in Ticketing > Email Reader. See Kaseya KB article 306441 (http://help.kaseya.com/WebHelp/KB-Article.asp?306441) for further information. <Kaseya_Installation_Directory>\WebPages\themes\banner\images\new - This directory, if it exists, contains customized icons for reports and the agent when using the banner theme. <Kaseya_Installation_Directory>\WebPages\themes\classic\images\new - This directory, if it exists, contains customized icons for reports and the agent when using the classic theme. <Kaseya_Installation_Directory>\WebPages\themes\compact\images\new - This directory, if it exists, contains customized icons for reports and the agent when using the compact theme. <Kaseya_Installation_Directory>\WebPages\themes\default\images\new - This directory, if it exists, contains customized icons for reports and the agent when using the default theme.
40
Updating an Existing KServer to K2 <Kaseya_Installation_Directory>\WebPages\access> - This directory contains two files, DefaultHeader.htm and LeftHeader.htm that may be customized.
41
42
44
Learning More
Learning More
PDFs are available to help you quickstart your implementation of Virtual System Administrator. They can be downloaded from the first topic in online help (http://help.kaseya.com/WebHelp/EN/VSA/6010000/index.htm?toc.htm?6939.htm). If you're new to Virtual System Administrator we recommend the following quickstart guides: 1. Getting Started 2. User Administration 3. Agent Configuration and Deployment 4. Live Connect and Portal Access 5. Monitoring Configuration The following resources are also available.
Training
You can view VSA training videos at the Kaseya Portal (http://portal.kaseya.net). Click the Kaseya LMS link under the Education folder.
Conclusion
Following the instructions presented in this document enables the user to install the KServer software properly. Contact a Kaseya Support Representative for any questions regarding the installation or use of the KServer software. Kaseya Support may be contacted using the Kaseya Portal (https://portal.kaseya.net).
45