Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

After you've downloaded the Export.zip export zip (required EDI solution package based on your industry type) file containing the EDI Transactions, you can import them the package by using the Import Package option under Solution Promotion feature at the target environment . A successful import completes the migration process, and you'll be able to access all the objects in your new environment. 

...

titleYou may want to configure the following solution promotion properties described in the Solution Promotion Configuration section on the Microservice Settings - Webrunner page before you begin the import operation.

...

Property name

...

Description

...

migration.job.memory.limit

...

Maximum memory a migration pod can use.

...

migration.job.memory.request

...

Minimum memory allocated to a migration pod.

...

migration.job.cpu.limit

...

Number of maximum CPU cores a migration pod can use.

...

migration.job.cpu.request

...

Number of minimum CPU cores allocated to a migration pod in the deployment.

...

exportzip.path

...

Path of the export.zip file created while generating the export package.

Default value: migration/export/export-$TIMESTAMP$.zip

...

migration.job.pendingStatus.checkInterval

...

The frequency (time interval in seconds) at which the system checks for the status of the migration job.

...

migration.job.pendingStatus.waitingPeriod

...

The time period (in seconds) for which the system checks for the migration job to get up and running.

...

migration.job.jvmParameters

...

Value for JVM parameters required for migration.

Prerequisites

Before you perform the Solution Promotion steps for import, you need to make sure that you have met the prerequisites discussed in this section.

  • You need to make sure that you have:

    1. The access to the source Kubernetes environment where the application is installed.

    2. Installed the followings:

      1. Helm

      2. kubectl client

    3. The Export ZIP file ready.

    4. The Retain XML file ready if you want to retain any activity.

Info

If you want to retain the activities while importing the objects, you need to configure the parameters in the retain.xml that you want to retain. The objects can be retained at service and field level. You will find retain.xml in the <shared>/migration/template folder.

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#FFEBE6

Important
If you ever make any changes to the resources in the migration values.yaml file, you need to change the JVM parameters accordingly through the environment variable JAVA_OPTS – It can be up to 70% of the allocated resources.

  • Make sure that you have the required permissions to view and use the Solution Promotion feature. To have this permission, the role that you have been assigned must have the required permissions on the Solution Import entity.

...

Entity

...

Permissions

...

VIEW TAB\LINK

...

LIST & READ

...

 CREATE

...

EDIT

...

EXECUTE

...

Solution Import

...

View the tabs/links on the Import Package manage page

...

View

...

Create the Import Package

...

Edit the Import Package

...

  • Import Package

  • Rollback Package

Importing the package

You can import the package by following the steps given belowto deploy the solution.

Deploying the package

Follow the steps given below to import and thus deploy the package.  

  1. Click Account > Tools > Solution Promotion.

  2. On the left panel, select Import Packages.

  3. Click CREATE Import Package.

  4. On the Create Import Package screen, 

    Click Save & Exit. This creates the import package that gets listed in the Import Packages mange page
    1. Provide a name for the import package.

    2. Provide a description for the import package.

    3. In the Select Project field, select the project where you want to keep the import package.

    4. In the Override User field, select the user to whom you want to provide ownership of the activitiesTransactions.

    5. In the Override Modified By User field, select the user who will be reflected in the Modified By field of every activity Transaction after the deployment.

    6. Select the Retain Activities checkbox if you want to retain the services at the target environment, and then click Browse to select the required Retain XML file.

    7. Select the Solution Database checkbox if you want to import data to the solution database to be specified in the next screen.

    8. If you have selected Solution Database checkbox, continue following the steps from step 6, else perform step 5.

    9. If you have not selected any of the checkboxes (Retain Activities or Solution Database), or selected only the Retain Activities checkbox, perform step 5, else perform the steps from step 6.

  5. Click Save & Exit.

  6. Click Continue.

    Image Removed
  7. In the Database Info section, provide the following details of the solution database to which you want to import data.
    Type - Enter the type of database. For example MySQL, SQL, etc.
    Server - Enter the hostname of the database server.
    Port - Enter the port number of the database server.
    Name - Enter the name of the database.
    Username - Enter the username to access the database.
    Password - Enter the password to access the database.

    1. Note: Ensure that you select a user in this field.

  8. Click Save & Exit.

  9. Click More under ACTION against the package, and then click Import Package.

    Image RemovedImage Added
  10. On the Import Package screen, click Browse to select the Export ZIP export zip file.

  11. Click Import.
    This imports deploys the objects EDI solution to the target environment and also creates a corresponding Rollback ZIP rollback zip that can be used to rollback the import operation. You can visit the Dashboard to view the details of the import operation. 

    You can also perform the following actions rollback operation on the package from its More menu under ACTION:

  12. Perform the rollback operation.

  13. Edit, delete, or view the import package

    .

Post deployment steps

After you have deployed the package, you need to grant permission to the partner on its respective EDI solution project. To grant permissions, follow the steps given below.

  1. Go to Configure > Projects.

  2. Click the More option under the Action column to view the action menu of the EDI Project.

  3. Click Grant Access.

    Image Added
  4. On the Grant Access screen, in the Partner tile, click Grant Access.

    Image Added
  5. On the Confirm dialog box, click Yes, grant it to provide access to the Partner.

Anchor
Rollingback
Rollingback
Rolling back the import operation

If you decide upon rolling back the import operation, you need to follow the instructions given below.

  1. Download the Rollback ZIP rollback zip file corresponding to the import package from the Dashboard by navigating as follows:
    Dashboard > Solution Promotion > More > Rollback ZIProllback zip

    Image RemovedImage Added
  2. Go to the Import Packages manage page by navigating as follows:
    Account > Tools > Solution Promotion > Import Packages

  3. Click More under ACTION against the import package, and then click Rollback.

  4. On the Rollback screen, click Browse to select the Rollback ZIP rollback zip you have downloaded in step 1.

  5. Click Rollback.
    This rolls back the import operation. You can go to Dashboard > Solution Promotion to see the details of the rollback operation.