---
title: "vSphere Replicator Agent Configuration Guide"
canonical: "https://docs.perspectium.com/space/earlierReleases/1442036/vSphere%20Replicator%20Agent%20Configuration%20Guide"
format: markdown
---
Currently the agent supports sharing data from vSphere to a ServiceNow instance, useful for the cases where you want to get virtual machines, host systems, datacenters and other resources from vSphere and save them as configuration items in ServiceNow. In order to use this agent, the   vSphere API and SDK   will need to be running. It generally is running by default on VMware vSphere server systems but please contact your vSphere support for more information including the necessary SDK credentials required below. vSphere Requirements Description Version 4.0+ API/SDK   URL vSphere   API/SDK   URL, generally in the format   https://vsphere_url/sdk API/SDK Username Username to access the vSphere   API/SDK API/SDK Password Password to access the vSphere   API /SDK Like other agents, default agent.xml configurations are required and can be found in   Agent Configuration . Sharer Agent The Perspectium vSphere Replicator Sharer Agent will use the vSphere   API/SDK notably its   vSphere Web Services SDK   to access the vSphere management components and other virtual infrastructure objects (datacenters, datastores, networks, and so on) and share these objects as records that a ServiceNow instance can then subscribe to receive. The agent can access the SDK to share the following vSphere objects: Object Name <vsphere_object> value (see configuration below) Compute Resources compute_resource Datastores datastore Host Systems host_system Virtual Machines vm Current directives available specifically for the vSphere Share Replicator Agent are outlined in the following table: Directive Example Description Default handler <handler>com.perspectium.replicator.vsphere.VSphereSharer</handler> The name of the vSphere handler class Required vsphere_connection <vsphere_connection user="sdk_username" password="sdk_password"> https://vsphere_url/sdk</vsphere_connection > Connection information for accessing the vSphere   API/SDK as mentioned in the above vSphere requirements Required vsphere_objects <vsphere_objects> <vsphere_object>vm</vsphere_object> </vsphere_objects> A list of vSphere objects to share. Only the ones listed above can be shared. Required ServiceNow Update Set To properly subscribe to messages sent by the vSphere Replicator Sharer Agent, an update set is available that will create import set tables to map the records received in these messages to the appropriate cmdb_ci table. The update set will create the following import set tables: VPXV_COMPUTE_RESOURCE VPXV_DATASTORE VPXV_HOSTS VPXV_HOST_DATASTORE VPXV_VMS You can then   subscribe   to the above tables to read in messages from the vSphere Replicator Sharer Agent and have them transformed and imported into a target cmdb_ci table as defined in each import set table. Since these import set tables are available for editing after installing the update set, you can modify them as desired in case the default transform maps do not fully suit your needs. Please contact   support@perspectium.com   to request this update set and for more information.