Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

  1. Register for Harmony
  2. Set up Environments
  3. Download the new Harmony Studio
  4. Upgrade your Integration Server to Local or Cloud Agents
  5. Convert your existing Jitterbit Projects and Jitterpaks

What's New in Harmony

Jitterbit Harmony (Version 8.x) is the latest release in Jitterbit’s ten-year history to simplify and accelerate enterprise integration. Harmony includes powerful new features for designing, deploying, and managing integrations for the modern enterprise: 

Harmony Cloud

At the core of Harmony is the Jitterbit cloud repository. The repository includes a store, which holds all the projects, and a store, which tracks the activity history and logs.

Harmony Environments

All projects deployed to Jitterbit Harmony are deployed to Environments. Environments represent virtual folders to store and organize integration projects. Administrators can create unlimited Environments to organize their many projects such as traditional development, test, and production environments. Projects and operations can be easily migrated across environments and Harmony ensures operations running in one environment cannot interact with another project, operation or data used in a different environment.

Harmony Local Agents and Agent Groups

The Jitterbit Integration server has been redesigned into a lightweight, independent processing engine called a Jitterbit Local Agent. Local Agents are individual run-time engines that run on an individual server behind your corporate firewall. Local Agents are assigned to an Agent Group, which intelligently clusters and synchronizes all other Local Agents within the Agent Group. An Agent Group allows processes to run concurrently across multiple Local Agents. Each Agent Group is designed to be the synchronized run-time environment for one or more Environments.

Harmony Cloud Agent

Jitterbit Harmony includes a multi-tenant, auto-scaling agent group called Jitterbit Cloud Agent Group. The Jitterbit Cloud Agent Group enables projects to be run 100% in the cloud without the need to install software or hardware. The most common use case is cloud-to-cloud integration. 

Harmony Design Studio

Jitterbit Harmony includes an enhanced visual design studio for connecting to endpoints, data mapping and transformations, and visual and logical process orchestration.

Harmony Web Management Console

With Jitterbit Harmony, administrators can monitor and manage integration projects over the Internet using the Jitterbit Web Management Console (WMC). The WMC is a HTML5-based tool which performs administration tasks such as manage the users in your organization, configure security and access controls, manage the environments, configure and manage agent groups and agents.

Upgrading to Harmony

Register for Harmony

To begin your upgrade, first you will need to register for Harmony at https://login.jitterbit.com/jitterbit-cloud-mgmt-console/login/loginform. Click on the orange button to Register for a 30-day Trial. Simply follow the wizard as it sets up a new Harmony user ID, organization and gives you access to your own Web Management Console (WMC).  From the WMC, you can administer, monitor and manage all integration projects over the Internet from any browser or device. The WMC is a HTML5-based tool which performs administration tasks such as manage the users in your organization, configure security and access controls, manage the environments, configure and manage agent groups and agents.  Send an email to licensing@jitterbit.com including the email address that was used to register your Harmony trial, and request that your Harmony Org be provisioned.  This will transition your Harmony Org from a 30-day trial to a full licensed version.

Create Your First Environment

In order to create integration projects in Harmony you will need to create at least one environment. Go to the top menu screen and click on Environments. Click on “Create Environment” button and give your new Environment a name. You can create as many environments as you need.

  • Add Environment Window in the Environments Screen.

Upgrade Harmony 1

Upgrade to the Harmony Studio

The new Harmony Studio is required for designing integrations in Harmony. It is available for download from the Web Management Console. The Harmony Studio cannot be configured to connect to your existing Jitterbit Integration Server and previous versions of the Jitterbit Studio will not work with the Harmony platform.

  • Download the new Harmony Studio

Upgrade Harmony 9.11

  • Create a new project in Jitterbit Studio

Upgrade your Jitterbit integration Server to Harmony Agents

Upgrading to Local Agents

Existing Jitterbit Integration Servers cannot be upgraded or converted into Harmony Local Agents. A Jitterbit Harmony Local Agent is a separate installation. Local Agents are available for download from the Agents Group page in the WMC. Local Agents cannot be installed on the same physical or virtual machine where the Jitterbit Integration Server is installed. Jitterbit Local Agents includes a PostgreSQL database that is installed by default. You also have the option to install the Local Agent database into an existing PostgreSQL database. You should not however, install the Jitterbit Harmony Agent database into an existing Integration Server database.

  • Download a new Local Agent from the Agents Screen
Upgrade Harmony 4 - Download Agent
  • Windows Agent Installation Guide
  • Linux Agent Installation Guide

Upgrading to Cloud Agents

Cloud-to-Cloud integrations can now be run on the new Jitterbit Cloud Agent Group. To run projects in the Cloud, simply select the Jitterbit Cloud Agent Group as the agent group servicing your environment. By doing this, all operations deployed in the environment will be run on the Jitterbit Cloud Agent Group.

  • Associating Cloud Agent Group to your environment

Upgrade to Harmony 5 - Associate to Cloud Agent Group

You cannot use the Cloud Agent to run your projects if you use any of the following:

  • Source or target as Local File or File Share
  • Re-using the PostgreSQL database bundled with the Integration Server

  • Have custom Plug-ins installed on the Integration Server

  • Have Hosted Web Services in any of the projects

  • Use any Plug-ins other than the following:

    • Prepend Data

    • OASIS Web Service Security

Private Cloud Agents

You can install Local Agents on Private Cloud Services such as Amazon Web Services. Note however, that Jitterbit Harmony agents cannot be installed on the same physical machine or virtual machine where Jitterbit Integration Server is installed.

Upgrading and Deploying Existing Projects to Jitterbit Harmony

Converting Projects

The new Jitterbit Harmony Studio automatically converts older Jitterbit projects created in Jitterbit Version 5.x into a format required for Jitterbit Harmony. This conversion is done when a Version 5.x project is opened in the new Jitterbit Harmony Studio. With Harmony, all projects are deployed to an Environment. To deploy a converted project to an environment, simply select the environment to which the project needs to be deployed. You must create an environment before older projects can be converted.

Upgrade Harmony 6 - Upgrade Old Projects

NOTE: Additional conversion steps are required for projects created in Versions 4.x, 3.x or 2.x. Projects created in Version 2.x must first be converted to Version 3.6, then converted to 5.x, and then they may be upgraded to Jitterbit Harmony (Version 8.x). Projects created in Version 3.x or Version 4.x must be converted to Version 5.x prior to upgrading them to Jitterbit Harmony (Version 8.x).

Importing Jitterpaks

The new Harmony Studio supports the ability to import Jitterpaks created from Version 5.x of Jitterbit. Choose the Import Jitterpak option when the Harmony Studio is launched. You must create an environment before a project in a Jitterpak can be converted and deployed. Contact Customer Support for assistance if your projects were created in Version 2.x, 3.x or 4.x.

Upgrade Harmony 7 - Import Old Jitterpaks

NOTE: Additional conversion steps are required for Jitterpaks created in Versions 4.x, 3.x or 2.x. Jitterpaks created in Version 2.x must first be converted to Version 3.6, then converted to 5.x, and then they may be imported/upgraded to Jitterbit Harmony (Version 8.x). Jitterpaks created in Version 3.x or Version 4.x must be converted to Version 5.x prior to importing/upgrading them to Jitterbit Harmony (Version 8.x). Contact Customer Support for assistance if your Jitterpaks were created in Version 2.x, 3.x, or 4.x.
 
Considerations when using the PGP Plug-in

The PGP plug-in has been re-designed with Harmony. With 5.3 or older versions of Jitterbit, the PGP plug-in requires the keys to be stored as files on the local disk (on the Integration Server). The path to the key file is then passed as input to the plug-in. With Harmony, the PGP plug-in has been redesigned to take the key directly as input. As a result, you may have to modify the project accordingly. One option is to put the key file on a separate location accessible in a secure manner such as Secure FTP or HTTPS, configure a corresponding Jitterbit Source in the project, and call the ReadFile function to get the key and pass it to the plug-in.

NOTE: The PGP plug-in will still work with the local key files.  You will only have to modify your project if you are moving from a local server to the Jitterbit Cloud Agent Group.

On This Page

Last updated:  Jun 06, 2017

  • No labels