You are viewing an old version of this page. View the current version.
- Register for Harmony
- Set up Environments
- Download the new Harmony Studio
- Upgrade your Integration Server to Local or Cloud Agents
- 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:
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.
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 email@example.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.
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 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
- 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
- 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
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:
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
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.
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).
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.
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.
Last updated: Jun 06, 2017
- No labels