Ask the Community
Groups
Migrating Agents from SaaS to On-Premise. - Connect IT Community | Kaseya
<main> <article class="userContent"> <p><strong>Problem:</strong> I am moving away from your Cloud solution to an On-Premise solution/server, but I don't see the <strong>Agent > Check-in Control</strong> page in SaaS. How can I migrate my agents from one platform to the other?</p> <p><strong>Cause: </strong>The <strong>Agent > Check-in Control</strong> page is not visible for SaaS Customers per design.</p> <p><strong>Resolution: </strong>Since <a href="/home/leaving?allowTrusted=1&target=http%3A%2F%2Fhelp.kaseya.com%2FWebHelp%2Fen%2FVSA-Online-Help.asp%3F4798.htm" rel="noopener nofollow">two agents can coexist in the same machine</a>, as long as these agents are pointing to different KServers, you can deploy a new <strong>Kaseya Agent</strong> from the On-Premise server, through the means of an agent procedure. Please see steps below:</p> <ul><li>On your new On-Prem VSA, navigate to <strong>Agent > Manage Packages</strong> </li> <li>Click on the <strong>+Create</strong> button to create a new agent package, or simply use a current one (if applicable), in order to get a copy of the installer.</li> </ul><p><img src="https://us.v-cdn.net/6032361/uploads/migrated/7WKWFOIUX272/1.png" alt="1.png" class="embedImage-img importedEmbed-img"></img></p> <ul><li>Save the <strong>KcsSetup.exe</strong> file locally on your machine to then use it with an agent procedure (this agent is specific to your On-Prem server):</li> </ul><p><img src="https://us.v-cdn.net/6032361/uploads/migrated/GNWLEHR524ZX/2.png" alt="2.png" class="embedImage-img importedEmbed-img"></img></p> <ul><li>On your SaaS VSA, navigate to <strong>Agent Procedures > Application Deploy</strong> </li> <li>Select the first option for Step 1, and click on the <strong>here </strong>link, for the following window to pop-up allowing you to upload the agent package:</li> </ul><p><img src="https://us.v-cdn.net/6032361/uploads/migrated/3SQOF4ZD3INZ/3.png" alt="3.png" class="embedImage-img importedEmbed-img"></img></p> <ul><li>Select the <strong>Shared files </strong>folder, or a folder of your choice.</li> <li>Click on <strong>Upload a file</strong> to upload the executable you had previously saved on your local machine - you will then see it listed on there (highlighted section in this screenshot):</li> <li>Click the <strong>Next >> </strong>button in the <strong>Application Deploy</strong> page to proceed to Step 2.</li> <li>In Step 2, select the "KcsSetup.exe"<strong> </strong>file from the drop-down menu.</li> <li>In Step 3, select <strong>Other</strong>.</li> <li>For the last text-box, where you specify the command line, please leave this blank and click on <strong>Next >></strong>:</li> </ul><p><img src="https://us.v-cdn.net/6032361/uploads/migrated/PLW45KINUQHN/4.png" alt="4.png" class="embedImage-img importedEmbed-img"></img></p> <ul><li>In Step 4, specify a name for this agent procedure, i.e., "Deploy On-Prem Agent", etc.</li> <li>Lastly, in Step 5, since no reboots will be required, make sure this option is <strong>not</strong> selected, and click <strong>Create</strong>:</li> </ul><p><img src="https://us.v-cdn.net/6032361/uploads/migrated/PAHVWEVVOCHX/5.png" alt="5.png" class="embedImage-img importedEmbed-img"></img></p> <ul><li>After clicking the <strong>Create </strong>button, the VSA screen will take you back to <strong>Agent Procedures > Schedule / Create</strong>.</li> <li>On here, you will search for the procedure you just named.</li> <li>You will select it, and on the right panel, you will select "xyz" agents to run this on, deploying the On-Prem agent package you built early on (note that you can either <strong>Run Now</strong>, or schedule this agent procedure via <strong>Schedule Agent Procedure</strong> button:</li> </ul><p><img src="https://us.v-cdn.net/6032361/uploads/migrated/P8YTPEEXNL8O/6.png" alt="6.png" class="embedImage-img importedEmbed-img"></img></p> <ul><li>If you will deploy this to a large number of endpoints, we recommend scheduling the execution of the procedure a couple of minutes, so you do not overload the server. Otherwise, simply click on the <strong>Run Now</strong> option to immediately run the procedure.</li> <li>Also, ensure that the <strong>Skip if offline (if 'Power up if offline' is also checked, then skip script execution if power up failed) </strong>option is not checked, as you'd want the installer to run as soon as the computers come back online:</li> </ul><p><img src="https://us.v-cdn.net/6032361/uploads/migrated/PGCQF1X3OPHH/7.png" alt="7.png" class="embedImage-img importedEmbed-img"></img></p> <ul><li>Lastly, you will verify that the agents are coming over from your SaaS server on to your On-Prem VSA. </li> </ul><p><strong>Note:</strong> Be aware that your machines will have two agents, one checking into SaaS, and the other agent checking into your new On-Prem server. You will need to remove the old agent via SaaS: <strong>Agent > Manage Agents > Manage button > Delete Agents </strong>option:</p> <p><img src="https://us.v-cdn.net/6032361/uploads/migrated/SNBM92REHDYB/8.png" alt="8.png" class="embedImage-img importedEmbed-img"></img></p> <p><strong>Applies to</strong>: VSA 9.4, 9.5 (SaaS).</p> </article> </main>