Ask the Community
Groups
How to migrate agents to another VSA instance - Connect IT Community | Kaseya
<main> <article class="userContent"> <h3 data-id="question">Question</h3> <p>How can I migrate agents from one VSA server to another?</p> <h3 data-id="answer">Answer</h3> <p>If migrating to a new server which is a <a href="/home/leaving?allowTrusted=1&target=http%3A%2F%2Fhelp.kaseya.com%2Fwebhelp%2FEN%2FVSA%2F9030000%2FInstall%2F%236716.htm" rel="noopener noreferrer nofollow">replica of the original server,</a> agents can be re-directed using <em><strong>Agent > Check-in Control</strong></em> page. On both the new and old VSA servers, set <strong><em>Primary Kserver</em> </strong>to the address of the new server.</p> <p>If migrating to a <em>brand new or separate VSA instance</em>, it is necessary to deploy a <em>new</em> agent using an install package created from the instance you are migrating to. This can be done using an agent procedure from the original VSA instance.</p> <p>Here are the steps to achieve this: -</p> <p>1) On the <em>new</em> VSA instance, go to <em><strong>Agent > Packages > Manage Packages</strong></em></p> <p>2) Create a silent install package which inlcudes /r /w /s switches - <a rel="nofollow" href="/home/leaving?allowTrusted=1&target=http%3A%2F%2Fhelp.kaseya.com%2FWebHelp%2FEN%2FVSA%2F9040000%2F%23493.htm">http://help.kaseya.com/WebHelp/EN/VSA/9040000/#493.htm</a></p> <p>3) Click on the hyper-linked name of the package you just created</p> <p>4) Click on the link to copy download link to your clipboard</p> <p>5) On the <em>old</em> VSA instance, go to <strong><em>Agent Procedures > Manage Procedures > Schedule/Create</em></strong></p> <p>6) Select a folder to create the agent procedure in, then click<strong> <em>Import Folder/Procedure</em></strong> button</p> <p>7) Select the file <strong>"Procedure Deploy agent for new VSA.xml"</strong> which is attached to this KB article - this will create an agent procedure called "Deploy agent for new VSA"</p> <p>8) Edit the agent procedure and replace the web page URL in step 2 with the link you copied to the clipboard in step 4:</p> <p><img src="/attachments/token/MRVlHWs2pMGtcUrs2B5ySwN23/?name=2016-07-06+12_18_21-Edit+Procedure+-+Deploy+agent+for+new+VSA.png" alt="2016-07-06_12_18_21-Edit_Procedure_-_Deploy_agent_for_new_VSA.png" width="846" height="270" class="embedImage-img importedEmbed-img"></img></p> <p>9) Save the procedure and schedule it on agents that need to be migrated. Please note that each agent will download 36 MB from the VSA server. To avoid bandwidth issues, use Distribution window to prevent too many concurrent downloads. You may also consider deploying the installer to a LAN share on larger sites and modifying the procedure to run it from there instead of downloading from VSA.</p> <p>10) Once the agents have checked into the new VSA, the "old" agent can be removed using <strong><em>Agent > Install Agents > Delete</em></strong> page</p> <h4 data-id="maintaining-org-group-structure">Maintaining org/group structure</h4> <p>By default, new agents check into "unnamed" organisation, unless specified when creating the agent install package. If you want to maintain the same org/group structure on the new VSA after migration, the organisations and groups must be re-created manually. Migrated agents can then be assigned to correct groups in one of the following ways: </p> <p>- Create install package for each group, specifying the group to install the agent into</p> <p>- Use <em><strong>System > System Preferences > Naming Policy</strong> </em>function to specify group membership based on connection gateway or IP address range</p> <p> </p> </article> </main>