Skip to main content

Who is this article for?

Code42 for EnterpriseSee product plans and features
CrashPlan for Small Business 

CrashPlan for Small Business, no.

Code42 for Enterprise, yes.

Link: Product plans and features.

This article applies to versions 6 and 7.

Code42 Support

Run the migration assistant to upgrade to the Code42 Cloud

Who is this article for?

Code42 for EnterpriseSee product plans and features
CrashPlan for Small Business 

CrashPlan for Small Business, no.

Code42 for Enterprise, yes.

Link: Product plans and features.

This article applies to versions 6 and 7.

Overview

Upgrading from an on-premises authority server to the Code42 cloud requires migrating your database. This article describes how to run the Code42 migration assistant script to upgrade your authority server to the Code42 cloud.

Upgrading to the Code42 cloud allows you to take advantage of our latest features like Code42 Next-Gen Data Loss Protection.

Considerations

  • Your Professional Services contact provides you with a link to download the migration assistant. Contact your Customer Success Manager (CSM) to learn more.
  • We recommend you run the Migration Assistant on the server where your Code42 authority server is installed.
  • On-premises backup data won’t be migrated (only archives stored in the cloud are migrated). 

Functionality not available during migration
The following functionality is not available during migration: 

  • New users cannot be registered via administration console or Code42 app.
  • New SSO users cannot log in for the first time.
  • Web and push restores cannot happen via the administration console.
  • Users currently on archive key password security cannot change their passwords.
  • The security level of a user cannot be changed.

Note: Back up and restore using the Code42 app is still functional during the migration.

Before you begin

The Code42 Professional Services team will work with you to get a migration code and help validate your database.

This validation step makes sure it is ready to be moved to the Code42 cloud. At a high-level the validation step confirms your Code42 environment meets the following requirements: 

  • Upgrade to the latest version 
    • Authority server 7.0.2 with the latest Code42 app version
  • Open network ports
    • Open ports 443 and 4287 for access to the Code42 cloud.
    • Port 443 is used for the migration. This access can be turned off when the migration is complete.
  • Change usernames to emails
  • Change custom roles to standard: Custom roles are not supported in a cloud. Re-assign users to standard roles.
  • Add Customer Cloud Admin role: An admin must be assigned the role of Customer Cloud Admin in order to administer a cloud deployment.
  • Discontinue on-premises backup: On-premises destinations are not supported. On-premises backups will stop after the authority migration. Web restores via zip file will still be available. 
  • Select identity management methodology: Your identity management methods may need to change in a cloud deployment model. 
  • Assess API usage: API scripts or integration (outside of Splunk) will break during the migration. 

Run the Migration Assistant

  1. Log in to the host server where your authority server is installed. 
  2. Stop your authority server
  3. Download the Migration Assistant to the server: 
    1. Linux: Unpack the TGZ file. 
    2. Windows: Double-click the ZIP file.
  4. Open Terminal (Linux) or Command Prompt (Windows).
  5. Navigate to the MigrationAssistant-x.x.x folder.
  6. Run the Migration Assistant script as an administrator:
    1. Linux:
      sudo./bin/C42MigrationAssistant --migrate-now <migration code>
    2. Windows:
      .\bin\C42MigrationAssistant.bat --migrate-now <migration code>
  7. The migration is successful when you receive the following message: 

    {
    "success" : true

      "errorDescriptions" : { },

      "errors" : { },

      "warningDescriptions" : { },

      "warnings" : { }
    }

  8. Next, follow the steps below to verify your new Code42 cloud administration console. 

Troubleshoot migration errors

Verify your new Code42 cloud administration console

Now that the migration has finished, sign in to your new console to verify that everything is working as expected. 

  1. Sign in to your Code42 cloud administration console with a user with the Customer Cloud Admin role: https://crashplan.com/console.
  2. Verify your Code42 environment is configured correctly:
  3. Start your old on-premises authority server using the CLI command. Code42 professional services will help you update this old administration console to redirect Code42 apps to your new cloud administration console

Next steps