Migrate from Aconcagua and Later

This topic applies to

Applies to

SuiteCommerce Advanced

The Aconcagua release of SCA and later all support themes and extensions and the Extension Framework (also referred to as the Extensibility API). Follow the instructions in this section if you are currently implementing the Aconcagua release of SCA or higher.

Important

If you have modified any core SCA files in your existing implementation, you should recreate these changes as extensions instead of migrating your customizations manually. If your existing customizations modify objects not accessible through the Extensibility API, you must migrate this custom code manually to the new version. See Extensibility API for more information.


Important

Before migrating to a new release, review the SuiteCommerce Release Notes for important notifications and details regarding changes included in the release. Each major release might include bug fixes and changes in the form of periodic minor releases. Make sure you implement the latest minor release of the active version.


To migrate to the latest release:

  1. Install the new bundle.

    1. Go to Customization > SuiteBundler > Search & Install Bundles.

    2. Enter the bundle ID for the latest version of SCA you want to install. Bundle IDs are listed in the SuiteCommerce Release Notes.

    3. Select the bundle in the results list and then click Install. Follow any on-screen prompts to continue the install.

      The bundle installation may take a while. A pending message displays in the status column of the Installed Bundles page. Refresh the screen during the process to see when the installation is complete.

      Note

      Minor releases to the current SCA release do not receive new Bundle IDs.


  2. Download the new source code from the file cabinet to your local environment.

    The source zip file is located at Web Site Hosting Files > Live Hosting Files > SSP Applications > NetSuite Inc. — SCA [version] > Source > _Sources. After downloading is complete, unzip the file into a new working directory.

  3. All customizations should be implemented using themes and extensions. However, if your existing implementation includes customizations not accessible using the Extensibility API, migrate these customizations to your new source code directory.

    1. Create a duplicate of your custom module folder in the new source code directory.

      Note

      This applies to custom modules that are not standard SCA source modules. Any source SCA modules that have been customized may require comparison against the new version plus any required manual edits to the code.


    2. Copy your existing custom modules into the new custom module folder.

    3. Update the new distro.json file to include references to any custom modules and to define any custom application dependencies.

      Important

      Do not copy the existing distro.json file contents directly into the new distro.json file. Doing this causes overwrites to changes made in the distro.json file to support the new release. For example, a new module may be referenced. NetSuite recommends evaluating the DIFF between files to ensure that you migrate all changes from your local distro.json file into the new distro.json file.


    4. Any module that changed in the new release bears a higher version number from its previous release. Compare module version numbers to assess which modules have been updated and migrate the changes to any existing customizations as necessary. Refer to the SuiteCommerce Release Notes for details on which modules were changed and why.

      Important

      Migrating to a new release requires testing to ensure any existing customizations remain viable. Evaluate differences in code against your existing customizations and test thoroughly before deploying to your live site. See Best Practices for Customizing SuiteCommerce Advanced.


  4. Link your site record and domain to an SSP application as required. This can be the SSP Application for the latest version of SCA or one specifically intended for development.

    1. Go to Setup > SuiteCommerce Advanced > SSP Applications and click View next to the SuiteCommerce Advanced Dev <version> application.

    2. Click Link to Domain.

    3. Select the development domain for this SSP Application.

  5. Examine all customizations to your existing source code of the previous implementation. If all customizations of your previous implementation were accomplished using themes and extensions, then reactivate them using the Extension Manager in NetSuite. See Manage Themes and Extensions for details.

  6. If your previous implementation included customizations of SCA source code that were not part of the Extensibility API (implemented without extensions), then complete the following:

    1. Create a duplicate of your custom module folder in the new source code directory.

      Note

      This applies to custom modules that are not standard SCA source modules. Any source SCA modules that have been customized may require comparison against the new version plus any required manual edits to the code.


    2. Copy your existing custom modules into the new custom module folder.

    3. Update the new distro.json file to include references to any custom modules and to define any custom application dependencies.

      Important

      Do not copy the existing distro.json file contents directly into the new distro.json file. Doing this causes overwrites to changes made in the distro.json file to support the new release. For example, a new module may be referenced. NetSuite recommends evaluating the DIFF between files to ensure that you migrate all changes from your local distro.json file into the new distro.json file.


    4. Any module that changed in the new release bears a higher version number from its previous release. Compare module version numbers to assess which modules have been updated and migrate the changes to any existing customizations as necessary. Refer to the SuiteCommerce Release Notes for details on which modules were changed and why.

      Important

      Migrating to a new release requires testing to ensure any existing customizations remain viable. Evaluate differences in code against your existing customizations and test thoroughly before deploying to your live site. See Best Practices for Customizing SuiteCommerce Advanced.


    5. Deploy your local files and test appropriately.

      Testing may consist of various scenarios depending on your setup. You can deploy your local files to any of the following locations:

      • Core source code customizations require the core SCA developer tools. This requires setting up the appropriate developer environment. See Core SuiteCommerce Advanced Developer Tools for details. Core SCA customizations can be deployed to:

        For example, you can deploy your customizations to a local server or to a Netsuite sandbox account for testing. If you do not have a Sandbox account, you can deploy to an SSP Application linked to a development domain in NetSuite. After testing, deploy your files to the SSP Application linked to the primary domain.