IDA DEPLOYPACKAGE command

The IDA DEPLOYPACKAGE CLPPlus command deploys a package to a target Dynamite environment. Deploying a package uploads and installs the packaged UDXs and libraries in the target Dynamite environment.

This command:
  1. Creates a new project directory on the target system (if it does not already exist).
  2. Uploads the package to the project directory of the target system.
  3. Extracts the contents of the package to the project directory. (Shared object files are stored in the release subdirectory of the project directory.)
  4. Deletes the uploaded package file.
  5. Uses the contents of the registration file to register all the UDXs in the package.

Invocation

You must run this command from the CLPPlus interface.

Authorization

None

Required connection

CLPPlus must be connected to the database.

Command syntax

IDA DEPLOYPACKAGE

Read syntax diagramSkip visual syntax diagramIDA DEPLOYPACKAGESOURCEcompressed_filePROJECTprojectMODENEWMODEMERGEMODEREPLACE

Parameters

SOURCE | SRC
The fully-qualified name of the package that is to be deployed.
PROJECT | PROJ
The name of the project to be created, merged with, or replaced (depending on the value of the MODE parameter). The name can contain only letters, numbers, and underscore characters. The default is the name of the package file, without the extension.
MODE
Whether the specified project is to be created, merged with, or replaced. If a project with the specified name:
  • Already exists:
    NEW
    Cancel the deployment operation and do not change the existing project. This is the default.
    MERGE
    Do not delete the existing project, but merge the new and existing projects. Files that have the same name will be overwritten. Use this setting to merge a shared library into an existing project.
    REPLACE
    Delete the existing project and replace it with the new project. Use this setting to replace a defective or obsolete package.
  • Does not already exist:
    NEW
    Create the new project. This is the default.
    MERGE
    Cancel the operation.
    REPLACE
    Create the new project.

Examples

The following command takes a package that has the name proj1.zip and is in the current directory and deploys it to a project with the name proj5, but only if no project with that name already exists:
SQL> IDA DEPLOYPACKAGE SRC proj1.zip PROJ proj5
The following command merges the contents of a package with the fully-qualified name /home/user1/pkg01a.tar.gz into an existing project with the name proj6:
SQL> IDA DEPLOYPACKAGE SRC /home/user1/pkg01a.tar.gz PROJ proj6 MODE MERGE