1.4 Migrating Java Projects

Migration of the Java configuration code between  installations are made possible with the following steps:

  1. Use the mzsh systemexport or vcexport command to export the Java agent workflows and its requisite configurations at the originating installation. Subsequently, you could also use the System Export menu from the Desktop UI.

    Example - Using mzsh systemexport

    $ mzsh systemexport -directory /home/mzadmin/exports/java_workflow.zip
  2. Import the Java agent workflows at the destination installation. You can also use the System Import menu from the Desktop UI.

    Example - Using mzsh systemimport

    $ mzsh systemimport java_workflow.zip
  3. At the destination installation, run the following command to ensure that the new Java development environment has the updated UDRInterface for Java agent. This ensures that all UDR formats utilized by the Java agent are included for the configuration codes.

    Example - Using mzsh udrexport

    $ mzsh udrexport
    Username: mzadmin
    Password:  
    Exported 638 UDRs for external use.
  4. Retrieve the custom agent's mzp from the source directory and install it into the destination installation.

    Example - Installing an mzp using the pcommit command

    $ pwd
    /opt/OLD_mz/codeserver/packages/active
    $ mzsh mzadmin/<password> pcommit helloworld.mzp
    Inserting helloworld, 1.1...done.

    Before pcommit!

    Be sure to be have the environment variables for the destination  already exported in your shell script environment, this is to ensure that the installation is performed to the right platform.

  5. Run the command to regenerate the configuration. This will validate the imported Java agent workflows.

    Example - Regenerating workflows with mzsh regenerateconfigs

    $ mzsh regenerateconfigs
    Username: mzadmin
    Password:  
    Workflow Default.WFL_Java_HelloWorld became valid