Importing a file by using the Import wizard

Import rules and data instances from your file system or repository into your current Pega Platform instance. Use the Import wizard to upload artifacts up to 1 GB in size; for larger files, use File Transfer Protocol (FTP) or another means to place the file into the ServiceExport directory.

  1. For IBM Db2 for z/OS, configure the import properties.

    If you are importing an application with schema changes and a separate DB-Admin-DB-Name and you are using IBM Db2 for z/OS, configure the import parameters before you import the application, or the import will fail. For more information about configuring the import parameters, see IBM Db2 for z/OS: Preparing to import an application with schema changes and a separate DB-Admin-DB-Name. For more information about your application, see your database administrator.

  2. Click Designer Studio > Application > Distribution > Import.
  3. Import a file in one of the following ways:
    • From a local file system:
      1. Browse to the local file.
      2. Click Next.
    • From a repository:
      1. Enter the Repository name.
      2. Select the Artifact type from the list. The listed artifact types depend on the repository definition.
      3. Select the artifact Name.
      4. Click Next.
    • From a file on server:

      This option displays files that are in the service export directory.

      1. Select the file from the Select a file from the server to import list.
      2. Click Next.
  4. Optional: To view the components of the file and select individual instances to load, click Show content details.
  5. Optional: To display a detailed view of the contents of the imported file, select the Enable advanced mode to provide more granular control over the import process check box.
  6. Optional: To limit import time, select Do not set restore point or save metadata. If you do not set a restore point, you cannot roll back to the current state of your system.
  7. Optional: If you are importing a code archive, a default Codeset name and Codeset version are displayed. You can override the default values.
  8. If you have missing or invalid database connections, click the Gear icon to enter valid connection information.
  9. Optional: Click the Gear icon to change the connection information for valid database connections.
  10. Click Next to begin the import. If you selected the check box in step 4, click Next again.
    During the import, the system confirms that each imported ruleset version has the same or a higher ruleset version identified as a prerequisite. For example, you cannot import a product archive exported from a Pega Platform 05-03-01 system into a Pega Platform 04-02-60 system.
  11. If applicable, respond to missing dependency error messages.
    For more information, see Resolving missing dependency error messages during an import.
  12. To close the form, click Done.