Versions Compared

Key

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

Table of Contents

App Considerations


English

If you are looking into migrating all the apps, please look at Backup, Restore and Disaster Recovery.

In order to migrate a single Joget app from one server to another, we will need to assess the current footprint of the app to determine the best way to migrate.

  1. App Form Data
  2. Shared App Form Data
  3. App Process Data
  4. Plugins
  5. Integration with External Systems

App Form Data

This section is applicable to you if you intend to migrate the form data stored in the server, otherwise, you can move on to the next section.

...

  1. How are we making use of the shared tables? As a lookup or we write into them too?
  2. Can we continue to provide access from the original server?
  3. At which layer should the access be created? Joget app server or DB server level?
  4. If DB level, we can consider making use of JDBC related plugins(i.e. JDBC Database SQL Query Options Binder / JDBC Form Binder / JDBC Datalist Binder/ Database SQL Query/ Database SQL Query List Data Store).
  5. If Joget app level, we can consider making use of JSON API or provision new ones using API Builder where we can exert more controls in API management.

...

Make a list of all external touch points that your app is using.

Image RemovedImage Added

Figure 3: Service Calls in App's Performance

...

Bear in mind that if you intend to upgrade your Joget platform, do it first at the environment where the staging server is, or upgrade the staging server where the said apps have been confirmed working before by following the Upgrade Guide For DX 8. This way, the only change made is to upgrade the Joget platform version. It would be easier to find out cause of any problems as there are not many variables changed.

...

  1. Install this app in the current server. Publish the app.
  2. Go to setup menu to key in parameters required of the target server.

    Figure 7: Utility App Setup Screen

  3. At the target server, login as admin, navigate to System Settings > General Settings > API Domain / IP Whitelist and key in the domain / IP of the current / old server. This is so that the target server can accept JSON API calls from current server. We have set up the app.
  4. Go to List of Running Process to see the list of running process instances. Select and click Migrate to start migration.
    IMPORTANT NOTE: If your app has User Notification Plugin or similar notification plugin enabled, or other process tool that will immediately run after process starts, it may be a good idea not to have them enabled while migration is taking place.
  5. Observe current server log files and target server's Running Processes to verify its execution status / result.
    An entry will be added to Logs menu if it is successful.

    Figure 8: Utility App Logs

    In the List of Running Process menu, the status will change to "Migrated" with process instance ID furnished based on the data from logs.

    Figure 9: Utility App List of Running Process with New Process Instance Information

View file
nameAPP_migrateProcess-2-20210518184056.jwa
height250


Download

App Version 1

Note: This migration utility app is tested on Joget v6 Enterprise 6.0.31 and Joget DX Enterprise 7.0.16 and with process migrated into a Joget server runing running on Joget DX 7.0.16.

View file
nameAPP_migrateProcess-2-20210518184056.jwa
height250

App Version 2

Note: Added button to abort process instances. Tested on Joget DX 8.0.9.

View file
nameAPP_migrateProcess-1-20231229174344.jwa
height250