Integrate an appliance or vault with ConnectWise - x360Recover

Written By Tami Sutcliffe (Super Administrator)

Updated at July 15th, 2021

Configure ConnectWise:

Note

You will need access to the System > Members page.

1. Once in the System > Members page, go to the API Members tab and press the ‘+’ icon to add a new API Member.

2. For the Member ID, enter “Axcient”.

You will need to fill out all required fields.

If you will be using x360Recover to update your billing: When you get to the Role ID field, the member will need to be set to a role that has permissions to Add, Update, and Close tickets, as well as update quantities to products that have been added to a customer agreement.

Once the form is filled out, press the save button (Do not save and close).

3. Once you press the Save button, you will have access to the API Keys tab.

Open the API keys tab and press the ‘+’ to create an API key for x360Recover.

4. Type “x360Recover” into the description field then press the Save button.

Important

When you press save, do not press close until you have obtained both the public and private key outside of ConnectWise.

ConnectWise will not allow you to view the private key once you close this screen.

When you press save, the screen should look similar to this:

Make note of both keys and keep them somewhere safe. You will use these in the next section to configure x360Recover ConnectWise Integration.

5. Browse to System > Setup Tables > Service Board
6. Select the service board you wish to use for ticketing
7. Go to the Teams tab and confirm that a team is part of your service board.


Configure your Appliance/Vault:

1. When logged into your x360Recover device, select ConnectWise Settings
2. Fill out the displayed information and select Test Connection.
3. Once the connection is successful, the Billing Integration screen will be shown.

If you do not wish to enable billing integration, continue to step 5.

4. Click the box to the left of Enable Billing Integration and select your Customer, Agreement, and Addition. (The addition is updated with total usage in GB on the vault for the appliance you are configuring.)5. Once you have billing set up, click on Ticketing Settings to continue.
6. Select the Service Ticket Company that you wish this device to open tickets as.

7. Check off any alert type you would like to be notified of and select the Service board, New Ticket Status Mapping, and Closed Ticket Status Mapping.8. Once you have the ticket mappings the way you wish, select Save Configuration and Credentials.

If you wish to use these ticket board settings on other devices, you can download and upload the configuration using the Import and Export Settings buttons.

9. After your settings are saved, you can test them by selecting the type of alert you want to open a test ticket as and press the Create Test Alert button.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Retired Instructions:

  • About the x360Recover ConnectWise Integration
    • x360Recover will generate ConnectWise tickets on the Service Board of your choice. 
    • Types of Alerts
      • Backup Notifications - Success, Failed and Missed Backups
      • Storage Alerts - Backup Storage Pool Utilization greater than 80%, Drive Failures, Block Storage Utilization by Customer (if enabled on the Vault under the Users section)
      • Replication Alerts - Replication Out of Sync
      • Navigate here for a longer list of Alerts: http://support.x360Recover.com/Knowledgebase/Article/View/2/0/x360Recover-timings
    • Boot VM Check
      • When enabled on Protected System(s), the Appliance will boot each Protected System one at a time in Test Mode and take a screenshot after 7 minutes. This occurs once per day and begins at 2:00 AM. The Appliance will then attach the screen-shot(s) to a new ticket in ConnectWise. 
    • Customer Agreement Updates
      • A Configuration will be created for each Protected System. 
      • An Addition in the Company Agreement will be created. The Addition will be updated every 24 hours with current Vault Storage Usage (in gigabytes) for all Protected Systems for the Company. 
  • Initial Setup
    • Integrator Login  Example
      • You'll need a single ConnectWise Integrator Login for your x360RecoverAppliances and Vaults.
      • In ConnectWise, navigate to Setup Tables. Search for and open the Integrator Login table. Now you'll be able to create a new entry.
      • For the Access Level, make sure that you select "All Records".
      • The following API's need to be enabled: Service Ticket API, Managed Services API, Company API, Product API, Reporting API and the Configuration API. 
      • For the Service Ticket API, choose your preferred Service Board for internal alerts.
    • Managed Devices Integration  Example
      • In ConnectWise, navigate to Setup Tables. Search for and open the Managed Devices Integration table. Now you'll be able to create a new entry. 
      • After populating the Name and Solution fields, select the new Integrator Login that you created earlier. Then un-check "Disable Newly discovered Cross-References" and select a Location and Business Unit for "Defaults for New Configurations". You can also choose to select whether you want new Configurations to be set as Billable by using the check box next to "Set Configuration to Bill the Customer". Do note that your Agreements can override this setting. 
    • Product  Example
      • A Product is necessary to create the Addition on Agreements. To create a Product, navigate to the Products section in ConnectWise and click on the New Item icon. When naming this new Product, keep in mind that the Product will indicate the amount of gigabytes stored on your Vault per Customer. After selecting the appropriate Category/Sub Category, Product Type and Product Class, you will need to change the Unit of Measure to "Each". 
  • Appliance / Vault Integration
    • After completing the Initial Setup, its time to integrate your Appliances and Vault(s). Before continuing, make sure to have at least one Protected System on the Appliance/Vault. 
    • On each Appliance and Vault, log into the device and navigate to the ConnectWise Settings section. 
      • Integrator Login Details  Example
        • Input your ConnectWise URL and Company name.
        • For Integrator UserName and Password, use the Username and Password for the Integrator Login that you created in the Integrator Login section of the Initial Setup. Click "Test Connection" to verify credentials. If the "Configuration Details" section automatically expands, your entries were correct. If you receive the message "Please enter valid Integrator login details and perform a test connection", review the Integrator Login section of the Initial Setup.
      • Configuration Details  Example 
        • Select the Service Ticket Company for which the Appliance is assigned to. For Vaults, select your Company (you will need to create an Agreement for your Company if none exist).
        • Select the Agreement Type for the Company's Agreement. Select the Product that you created in the Initial Setup section above. Select the Management Solution Name that you created Managed Devices Integration section of the Initial Setup. Click "Test Configuration" and the "Service Board Settings To Enable Ticketing" should automatically expand. If you receive an error, notate the contents of the error and review the relevant sections of the Initial Setup. 
      •  Service Board Settings To Enable Ticketing  Example 
        • Select the Alerts and Notifications for which you which you want corresponding ConnectWise tickets. Select the Service Board and the Closed and New Ticket Name Mapping for the select Service Board. "Success Backups" ticketing will create a ticket in a Closed status. Therefore, a New Ticket Name Mapping for "Success Backups" is not requested. 
        • After choosing your requested settings, click "Save Configuration and Credentials". You should receive a "Successfully saved" message. All new Alerts on this Appliance or Vault will appear as tickets in ConnectWise on the requested Service Board. 
        • Only one ticket will be created per active Alert. If 10 backups fail on a Protected System, a single ConnectWise ticket will exist. If an Alert is cleared on an Appliance or a Vault, the corresponding ticket in ConnectWise will be updated to the status that you selected under "Closed Ticket Name Mapping".