Managed Bundles Overview

Important:

This topic is aimed at solution providers who create managed bundles. For information about installing and using managed bundles, see Using Managed Bundles.

If the Managed Bundles feature is enabled in your account, you can create managed bundles to give you control over when bundles are updated in target accounts. When a managed bundle is installed, the installer agrees to subscribe to future updates at the discretion of the bundle's author. As updates are developed, they can be installed by the bundle author into the target accounts without any action required by the target account administrator. Only customization bundles can be managed bundles.

Note:

If you are a Premier or Select member of the SuiteCloud Developer Network, you can request access to the Managed Bundles feature by filing a support case through the NetSuite Partner Center. Please be sure to provide your deployment account ID.

NetSuite only enables the Managed Bundles feature on SDN trailing accounts. An SDN trailing account is one that is upgraded in the last phase of a phased release. The Managed Bundles feature is not available for SDN leading accounts.

To indicate that a bundle is a managed bundle, check the Managed Bundle box on the Step 1 Bundle Basics page of the Bundle Builder. This box is not displayed if the Managed Bundles feature is not enabled in your account. Also, this option is disabled if you enable the Configuration Bundle option, because only customization bundles can be managed.

Unlike pushing bundles, updating a managed bundle from the source account does not require administrator access to the target account. If, however, a bundle author has administrator access to another NetSuite account, they can install a managed bundle in that account. A managed bundle can be saved and upgraded through a deployment account.

Warning:

You should not remove a bundle from the copy chain while the older version of the bundle is installed by some users and that version is deprecated by a newer version of the bundle. Removing a bundle from the copy chain results into users not being able to install the latest version of the bundle. To understand the chaining of bundle copies, see Ancestry of Copied Bundles.

For more information about managed bundles, see:

Managed Bundles in Target Accounts

When users install a managed bundle in their account, they are presented with a popup message informing them that by installing the bundle, they are giving the bundle author permission to install future updates at any time.

Managed Bundles in Target Accounts section of the Managed Bundles Overview page

If a bundle is installed and later changed to a managed bundle, the next time the installer clicks Update, they are informed of the change and must agree to have the bundle managed by the developer before it can be updated. If the installer no longer wants the managed bundle, they can uninstall it and receive no further upgrades.

In addition, for managed bundles, target account users cannot override bundle object preferences set by bundle authors. If a user-installed bundle later becomes managed, all preferences previously selected in target accounts are ignored during bundle updates. See Bundle Object Preferences.

SuiteBundler sends email notifications of managed bundle upgrades to target account users. Email recipients can be designated on the Bundle Details page. When a managed bundle is successfully upgraded in a target account, an email message containing the bundle name, bundle ID, bundle version, and account ID is sent. No message is sent when an upgrade fails. The recipients for this email message are based on the Email Recipients setting on the Messages subtab of the Bundle Details page in each target account. The default choice is All Bundle Admins, indicating that all administrators and users with the SuiteApp Marketplace permission in the account are recipients. A choice of None opts out of receiving this email. A choice of Custom allows the entry of specific users to receive the email.

The list of installed bundles, at Customization > SuiteBundler > Install Bundle > List, has a Managed column that indicates which bundles are currently managed, for reference purposes.

SuiteBundler Upgrade Install Base Permission

By default, only account administrators can upgrade bundles managed by your company, but you can assign the SuiteBundler Upgrade Install Base permission to custom roles to allow developers and release engineers to perform upgrades.

To grant the SuiteBundler Upgrade Install Base permission:

  1. Edit or customize the role to which you want to give this permission.

  2. On the Permissions subtab, click the Setup subtab.

  3. In the Permission column, select SuiteBundler Upgrade Install Base.

    The access level is set to Full.

  4. Click Add.

  5. Click Save.

This permission gives access to the Managed Bundles page.

Related Topics

SuiteApp Creation and Distribution
Types of Bundles
Creating a Bundle with the Bundle Builder
Bundle Builder Reference
Saved Bundles
Pushing a Bundle to Other Accounts
Managed Bundles - Best Practices
Upgrading Your Managed Bundle Install Base
Phased Upgrade of Managed Bundles

General Notices