Enterprise migration to SaaS

This guide is intended to help customers using OneSite Patch Enterprise on-premises to move to a OneSite Patch - SaaS deployment.

Follow these steps to create a new cloud tenant, migrate any settings from your on-premises server, and redirect clients to your new cloud tenant.

We recommend you engage Adaptiva Customer Support for any large or complex migrations.

Step 1 (Optional): Upgrade your Adaptiva server

If you want to continue to see historical data in your patching dashboards from your on-premises environment, you will need to upgrade your Adaptiva server and set some Client Settings Policies.

a. Upgrade your server to the latest build (at least 9.3.969), see Server Upgrade in the Platform Installation Guide.

• You are not required to update your clients

b. Use this guide to configure the following settings on the Adaptiva Server - How-To: Change the Default Number of Days Before the Adaptiva Server Removes an Inactive Client:

Configuration	Description	Value	Required
client_data_manager.inactive_client_duration	Number of days before the client becomes inactive.	315,360,000,000 (10 years in milliseconds)	Required
client_data_manager.inactive_client_detector_recurrence_interval	Number of hours (in milliseconds) before the client is detected.	31,536,000,000 (1 year in milliseconds)	Optional
client_data_manager.ignore_client_uninstall_msg	Set to ignore client uninstall messages.	true	Required

Step 2. Create your new OneSite Patch SaaS instance

You can create a new OneSite Patch instance in our Cloud Portal.

a. Navigate to https://console.adaptiva.cloud to register for a new account.

b. Create a new Company - ensure that your contact info and company details are accurate before proceeding.

c. Create a new Tenant - you may need to create multiple Tenants depending on your environment.

d. Add your license - your current license and key will work for OneSite Patch SaaS.

Step 3. (Optional) Migrate custom workflows used for patching

a. Identify any custom workflows that you are using in your patching implementation.

• Under Workflows, search both the Workflow Designer page and the Workflow Activities page by using the search filter Built Ins = False.

  

b. Export custom workflows.

• For each workflow, click the ellipsis (...) and click Export.

c. Submit a ticket to Adaptiva Support to review and sign each custom workflow.

d. Import Workflows into your tenant

Once you have received your signed workflows from Adaptiva, follow these steps to import your workflows into your Patch tenant - Import a Workflow.

Step 4. Manually Replicate Configuration Settings

In the OneSite Cloud Portal, recreate all relevant settings from your on-premises environment:

Identify custom actions and sensors to be recreated using the following search filters:

• Under Actions, create a search filter for Built Ins = False.

• Under Sensors, create a search filter for Built Ins = False.

• Set User interaction settings

• Customize Schedules

• Create Maintenance windows

• Define Custom actions and Custom sensors

• Create notification and approval Chains

• Create deployment and notification Bots

• Create Custom products

• Create custom Patch deployment or Rollout process for your imported workflows

• Configure optional integrations:

  • Integrate Falcon Spotlight

  • Integrate Defender

  • Integrate SentinelOne with OneSite Patch

• Create Business units

• Configure Deployment waves

• Create your Patch strategy

Step 5. Migrate your clients to SaaS

You will need to perform a clean installation of the OneSite Patch SaaS client on all devices. You may want to roll out client deployments in phases, especially in production environments. Testing in a pilot group before a full rollout can reduce disruption.

Ensure you maintain a rollback plan in case SaaS onboarding uncovers blocking issues.

Log in to the Cloud Portal and perform the following steps:

a. Install the SaaS client as a clean install

• Install the Adaptiva client for OneSite Patch SaaS by following the steps in the SaaS Client Installation.

• Ensure you are using the CLEANINSTALL=1 installer option (Refer to the Unattended Installation MSI Command Line Parameters). This will uninstall the existing client and reinstall the client configured for your SaaS tenant.

c. Audit the client migration in dashboard

1. Import the Migration Dashboard and use this to confirm your on-premises clients migration to your OneSite Patch SaaS tenant.

2. Check that each client reports into the new SaaS instance.

3. Confirm patch compliance reporting and policy assignments match expectations.

Post‑Migration Checks

• Confirm all devices are actively reporting in the OneSite Patch dashboard.

• Validate patching cycles are triggered and completed successfully.

• Ensure alerting and reporting functions are operational.

• Decommission on‑premises infrastructure once SaaS functionality is confirmed stable.