Reloading packages

Package loading refers to the process by which the runtime replica loads a package's contents (like services, configurations, and metadata) during startup. A loaded package is not necessarily enabled.

Before you begin

Make sure that the dependencies are resolved before the package is added.

About this task

When you load a package, the runtime replica reads the package directory and loads metadata, services, and configuration files into the memory. Loaded packages are not yet active for execution. Make sure that the dependencies are resolved before the package is added.

A package can be reloaded under several conditions, such as,

  • If you updated any services or configuration files in the on-premises environment and reexported the package, reloading the package makes sure that the recent changes are applied.
  • If the startup services failed, then reloading restarts any defined startup services and reinitializes resources if any.
  • If a dependent package is reloaded, all packages that depend on it are also reloaded automatically to maintain consistency.
  • If memory refresh issues occur, then reloading clears the current package from memory and loads a fresh copy.
Note: Reloading system packages such as wm* in a production environment is not recommended as it might disrupt running services.

Note:

Procedure

  1. Go to Projects > Packages.
  2. See the Load Status column. It has one of the following values.
    • Yes if the package is loaded successfully.
    • Partial if only some components were loaded.
    • No if the loading process failed entirely.
  3. Resolve the issues and save the package.
    For example, you have a custom package CustomerValidationPkg that includes a service validateCustomerData. After fixing a validation bug in your on-premises environment and recompiling the package, you upload it to an external repository. The updated package can then be pulled into your cloud project, where it is loaded into the Cloud Designtime environment for use.
  4. Click Reload.
    A confirmation message appears.
  5. Click Reload.
    The package is reloaded and ready for use in integrations.

Results

You can enable the disabled packages. For more information, see Enabling packages.

Verify Package Status

  1. Go to Project > Packages. The Package information page is displayed.
  2. Confirm that the package is loaded and enabled.
  3. Check for any error messages or warnings.

Validate dependencies

  1. From the Package information page, verify that all dependent packages are also loaded and enabled.
  2. Check for missing services or shared resources.

Inspect connector connections

  1. From the Connections page, recheck JDBC, JMS, or other connector connections.
  2. Make sure that they are active and properly configured.

Review Logs

  1. View logs to identify runtime errors or warnings.
  2. Focus on package-specific logs and system logs.