Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
  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)

Introduction

Warning
WARNING: Jitterbit version 5.x is the legacy Jitterbit product. Jitterbit strongly recommends that all customers upgrade to Jitterbit Harmony. For more information, see Getting Started.
Note

CAUTION: This process is for upgrading Jitterbit version 5.x to Jitterbit Harmony up to version 9.x. Jitterbit Harmony Design Studio includes tools to help you convert your 5.x projects to Harmony projects.

Jitterbit Harmony 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 1Image Removed

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

.

This page covers all necessary tasks for upgrading your version 5.x projects to Jitterbit Harmony. For an overview of all the components of Harmony, see the Jitterbit Security and Architecture White Paper.

Upgrading to Harmony

For instructions on getting started with Harmony, refer to the Jitterbit Quick Start Tutorial. This guide includes information on registering for Harmony and inviting team members, as well as a walkthrough to set up your first environment and Agent Group.

The Harmony Design Studio includes tools to help you convert your 5.x projects to Harmony projects.

Warning
WARNING: The Harmony Design 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.11Image Removed

  • Create a new project in Jitterbit Studio

Image Removed

Upgrade your Jitterbit integration
 For more information, see the next section, Upgrading the Jitterbit Integration Server to Harmony Agents.

Harmony Design Studio is available for download from the Harmony portal:

  1. Log in to the Harmony portal and choose Management Console. Then click the orange block in the top left and from the menu select Downloads.
  2. Download and install Design Studio. Refer to System Requirements for additional information.
  3. Open the Design Studio application and create a new project. See Jitterbit Quick Start Tutorial for more detailed instructions and walkthrough.Image Added

Anchor
upgrade-jitterbit-server
upgrade-jitterbit-server
Upgrading the Jitterbit Integration Server to Harmony Agents

Upgrading to

Local

Private Agents

Existing Jitterbit Integration Servers cannot be upgraded or converted into Harmony Local Private Agents. A Jitterbit Harmony Local Private Agent is a separate installation. Local Private Agents are available for download from the Agents Group page in the WMC. Local the Harmony portal via the Management Console.

Private Agents cannot be installed on the same physical or virtual machine where the Jitterbit Integration Server is installed. Jitterbit Local Private Agents includes a PostgreSQL database that is installed by default. You also have the option to install the Local Private 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 AgentImage Removed
  • Windows Agent Installation Guide
Linux Agent Installation Guide
  1. Log in to the Harmony portal and choose Management Console. Then click the orange block in the top left and from the menu select Agents > Agent Groups or Downloads.
  2. Download and install the Private Agent. Refer to System Requirements for additional information, including installation instructions.

Upgrading to Cloud Agents

Cloud-to-Cloud cloud integrations can now be run on the new Jitterbit Cloud Agent Group. To run projects in the Cloudcloud, 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 GroupImage Removed

Upgrade to Harmony 5 - Associate to Cloud Agent GroupImage Added

Warning

WARNING: You cannot use the Cloud Agent Group to run your projects if you

use any of the following

:

  • Source or target as Local File or File Share
Re-using the PostgreSQL 
  • Have any local file or file share sources or targets
  • Reuse the PostgreSQL database bundled with the Integration Server

  • Have custom

Plug
  • plug-

ins installed
  • ins installed on the Integration Server

  • Have

Hosted Web Services
  • hosted web services in any of the projects

  • Use any

Plug
  • plug-ins other than

the following
  • these:

    • Prepend Data

    • OASIS Web Service Security

Private Cloud Agents

You can install Local Private Agents on Private Cloud Services 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 the Jitterbit Integration Server is installed.

Upgrading and Deploying Existing Projects to Jitterbit Harmony

Converting Projects

The new Jitterbit Harmony Design Studio (up to version 9.x) 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 version 5.x project is opened in the new Jitterbit Harmony Design Studio.

With Harmony, all projects are deployed to an Environmentenvironment. 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
Warning
WARNINGAdditional conversion steps are required for projects created in
Versions
versions 4.x, 3.x, or 2.x. Projects created in
Version
versions 2.x must first be converted to
Version
version 3.6, then converted to 5.x, and then they may be upgraded to
Jitterbit
Harmony
(Version 8
Design Studio (up to version 9.x). Projects created in
Version
versions 3.x or
Version
4.x must be converted to
Version
version 5.x prior to upgrading them to
Jitterbit Harmony (Version 8
Design Studio (up to version 9.x).

Importing Jitterpaks

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

Upgrade Harmony 7 - Import Old Jitterpaks

Warning
NOTE
WARNINGAdditional conversion steps are required for Jitterpaks created in
Versions
versions 4.x, 3.x, or 2.x. Jitterpaks created in
Version
versions 2.x must first be converted to
Version
version 3.6, then converted to 5.x, and then they may be imported/upgraded to
Jitterbit
Harmony
(Version 8
Design Studio (up to version 9.x). Jitterpaks created in
Version
versions 3.x or
Version
4.x must be converted to
Version
version 5.x prior to importing/upgrading them to
Jitterbit Harmony (Version 8
Design Studio (up to version 9.x). Contact
Customer Support
support for assistance if your
Jitterpaks
projects were created in
Version
versions 2.x, 3.x
,
or 4.x.
 

Considerations

when using

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 source in the project, and call the ReadFile function the ReadFile function to get the key and pass it to the plug-in.NOTE

Tip
TIP: The PGP plug-in will still work with the local key files.
 You
You will
only
have to modify your project only if you are moving from a local server to the Jitterbit Cloud Agent Group.
Panel
borderColor#65379B
titleColor#FFFFFF
titleBGColor#65379B
titleOn This Page
Table of Content Zone

Table of Contents
maxLevel3
minLevel2indent20px

Panel
borderColor#FF7C4C
titleColor#FFFFFF
titleBGColor#FF7C4C
titleRelated Articles
label in ("getting-started-overview","support-overview","sys-req-overview","install-overview","video-library") and space = "DOC"
Panel
borderColor#00B886
titleColor#FFFFFF
titleBGColor#00B886
titleRelated Topics
contentbylabelshowLabelsfalse
max1000
showSpacefalse
sorttitle
cql

HideElements
metastrue

Last updated: 

Lastmodifieddate