Preparing GRAX for a Salesforce Org Decommission
Access your Salesforce data post salesforce org decommission using GRAX
Your company may have Salesforce orgs that you no longer want to maintain after a consolidation, merger, or business reorganization. GRAX makes it easy to protect this data, search, and reuse it without paying Salesforce to keep the org active.
After disconnecting from Salesforce, the backup of your data remains safe with GRAX and accessible through powerful tools including Global Search.
Before you Begin
The following must be in place before proceeding with decommissioning:
GRAX is connected to Salesforce and storage is configured
GRAX Backup is current. Verify by reviewing the Safe Up To date/time on the Backup Dashboard.
At least one local GRAX user has been created (see below)
(Optional) Ensure all desired objects are enabled on Data Lake
Step 1: Create Local Users
Once Backup is up to date, the first step prior to decommissioning your Salesforce Org is to create a local user within your GRAX app. This allows simple login access via email and password, as GRAX will no longer have access to Salesforce OAuth to provide authentication.
Best Practices for Local Users
Create at least two admin users to prevent lockout scenarios
Document local user credentials in a secure password manager
Ensure passwords are set to never expire for long-term disconnected deployments
Optionally, create local users for key stakeholders who may need data access
Once the prerequisites are met and a local user is created, please contact GRAX Support to verify all is set prior to safely decommissioning your Salesforce Org. GRAX Support will help by giving the green light to this transition and enable Decommission Mode for your GRAX app.
Step 2: Contact GRAX Support
Once your backup is current and local users are created, contact GRAX Support before proceeding. Support will:
Verify your backup state and local user configuration
Confirm Data Lake and any other dependencies are in order
Enable Decommission Mode for your GRAX app
Note that any changes to data in the Salesforce org made after disconnecting GRAX will no longer be captured by GRAX Backup. Ensure all desired data has been backed up before proceeding.
Navigating your GRAX app in Decommissioned Mode
Once GRAX is placed in a Decommissioned Mode by GRAX Support, the app operates as a standalone application for accessing historical data. The GRAX app remains largely the same, but features that rely on a live Salesforce connection are disabled.
Supported Features in Disconnected Mode:
Global Search: Search and view historical backed up data
Sandbox Seeding: Seed historical data to a connected Salesforce org (requires additional configuration)
Purge: Manage the permanent deletion of data from the GRAX Data Vault
Features not Supported in Disconnected Mode:
Any features requiring Salesforce API access
Auto Backup
Archive
Restore
Data Lake
Data already delivered to your Data Lake remains intact and accessible there. No new data will be sent after decommissioning.

(Optional) Deactivate Salesforce Integration User
Once you have confirmed Decommission Mode is working as expected and you have successfully logged in with a local user, you may deactivate the GRAX integration user in Salesforce or delete the connected app. This step is not required, but is recommended if you are fully retiring the org.
Last updated
Was this helpful?

