A machine with the following is required to install Harmony:
Harmony was designed and tested on a 64-bit Operating System.
Double click the installer to start the install for Harmony.
The install is approximately 10Mb in size and will take a few minutes. If you have ProjectWise Explorer installed, a plug-in for it will automatically be installed. In order to integrate with ProjectWise, Harmony must be installed after ProjectWise.
As part of the contract signed between you and Pencil 9 for the use of Harmony, you will have been sent an Organization code. Ensure this is entered correctly when you launch Harmony for the first time.
If your organization needs to generate an install package, ensure that Harmony is installed on a machine and the correct Organization code has been entered. Next navigate to C:\ProgramData\Pencil 9\Harmony and locate Organization.XML . Append this file as part of the install package to be placed in the same location. Harmony will read the Organization code and not require prompting by the application.
Let’s start by creating your first example package and automating its delivery!
The steps below guide you in creating your first package, creating an entry into the master standards catalogue and then using Harmony to automate its delivery.
|Source||Folder in step 1. eg C:\Users\XXXXX\Documents\Harmony source files|
|Display Name||Defaults to folder in step 1, can be changed if required.|
|Vendor||Optional: Any text is acceptable|
|Application||Optional: Any text is acceptable|
|Description||Optional: My first Harmony package!|
Congratulations, you have just automated the delivery of your first item!
The content from Step 1 should now have synchronized to the location in Step 2.
Now, imagine instead of Step 1 being a practice location on your machine, this can be a file server location on your network, a cloud storage solution, or Bentley ProjectWise. This is referred to as a “Master Location”. Step 2 represents a “Target Location”.
Harmony is great at automating the delivery of content from a Master Location to a Target Location. In addition to automating the delivery of the content, Harmony will always keep the target content up to date, and can also automate the configuration of your design applications (such as Autodesk user profiles and Bentley workspaces)
To remove this example package from your local machine, just go to the Download screen, select the Harmony source files line and click the Remove standard button.
To remove this example package from the master standards catalogue, go to the Admin screen, highlight the Harmony source files line and select the Remove standard button.
Now that you have created an example package, learn more about the functionality of Harmony in the proceeding sections.
This section outlines the fundamental ways in which Harmony operates and then suggests some strategies that the admin could employ in order to maximise the benefit that Harmony can bring.
There are a few functions that are available for admins to use for the configuration of their applications.
Harmony will always synchronize content prior to setting any configurations.
In developing a strategy for your organization, it is worth knowing that Harmony can use either of the items 1 and 2 listed above or both together. Item 3 is used to automate the configuration from a Document Management System offering a “no-touch” process for the end user.
Once a source and destination are set, Harmony will create a copy of the source content in the target location after the Set Standard or Test button has been clicked.
If a source folder contains zip files, Harmony will also extract the contents of those zip files.
Once a synchronization is complete, any subsequent click of the Set standard button will start a check process to ensure that only the content from the source is at the target. Modifications to the target location are removed and replaced with that from the source ensuring that only the content from the source is at the target location.
To configure a design application, an Instruction file is required and placed within the root folder of the source location. This file is read by Harmony and the configuration applied.
The Instruction file is generated by Harmony from the Design Apps tab of the Admin screen. This is where the configuration of the application is set.
Plug-in’s for Document Management Systems such as Bentley ProjectWise are also setup during the install, if the application was detected on the machine at that time.
The plug-ins do not require any input from an end-user or configuration from an administrator as they are fully automated. For Bentley ProjectWise, the only item required to automate a project is to have a valid Playlist file in the root of the ProjectWise WorkArea.
When a file from the Document Management System is then set to open, the Playlist automates the process of ensuring the most current up to date standards are synchronized and the design application configured properly.
This occurs before the file is opened and thus allows an application to be configured prior to launch.
The Playlist file is generated by Harmony from the Standards tab of the Admin screen.
When working across a Network infrastructure (including but not limited to Shared Drives, Mapped drives, Network locations and cloud sync solutions such as One Drive), it is important to note that there is one extra step in the workflow to open a file.
This first step, launching and setting the standard first, ensures that the latest content is cached and the design application is configured for use.
An application launcher is provided on the Available standards screen. This is an efficient way to launch the appropriate application. There are no extra command switches used by Harmony’s application launcher, it just launches the application allowing the most current configurations to be active. Applications can be launched outside of Harmony, however note any command switches (such as Autodesk user profile switches) in the shortcut will take precedence.
When setting a source or target for a networked location, ensure the full path is given where possible rather than mapped drives. This is to ensure that users who don’t have the same mapped drive are still able to access the content. Where all users have the same mapped drive, the drive letter can be used.
Please ensure that ProjectWise is installed prior to installing Harmony. This will ensure that the Harmony plug-in for ProjectWise is installed. If installing projectwise after Harmony has been installed, simply run the install again and Harmony will install the ProjectWise plug-in.
When working with Harmony and ProjectWise, there is an extra file that needs to be placed into ProjectWise which provides a fully automated solution for delivering and setting a Standard. This is a Playlist and is placed in the root of the ProjectWise WorkArea. Once an admin creates and adds a playlist to the project, the standards and applications will be automated for the entire team, regardless of the team’s location.
Harmony can be used to configure an Autodesk application such as AutoCAD or Civil 3D by delivering resources as well as configuring a profile which is set to use that content. There are no additional requirements to manage content, cui files, lisp files, dll files, and more. The content should be reviewed and organized in the normal manner. Harmony will simply automate delivering this content to your project teams and ensure their applications are configured to use the right content for each project.
To have Harmony create an Autodesk profile, take steps as follows:
The configuration work is complete after changing the status to Approved.
This guide assumes the user is familiar with the Managed Workspace and the CONNECT edition suite of Bentley Design applications. For the CONNECT Edition suite of Bentley design applications, there are a few critical variables that need to be set for base functionality.
To configure a standard for use with Bentley design applications, take the following steps:
Note: Harmony will modify the ConfigurationSetup.CFG file in C:\ProgramData\Bentley\[Application]\Configuration location. The original file is re-named and a new file is generated which includes any configuration changes. Unsetting a Standard or removing a standard re-sets the original file back in place.
There are many ways to configure Bentley applications from ProjectWise with a Managed Workspace. This guide outlines one way in which Harmony can be used to automate the delivery of content and configuration of Bentley CONNECT edition design applications.
In order to utilise Harmony in ProjectWise the following steps are required:
The next set of steps are to configure the application and then connect this to the managed workspace in ProjectWise.
Organizations can place content in many different locations within the Bentley delivered folder structure, for example within Organization, Organization-Civil or the Workspace.
In managing content for your organization or that delivered by a client organization, it is easiest to leave the folder structure as delivered and make minor changes to incorporate this into your organization.
One method of organizing this is to locate all the Standards within a folder structure that allows easy upgrading and maintenance. One suggestion for a target folder structure is:
A typical path could therefore be:
This can be placed in the Configuration Location field in Harmony and the appropriate standard should have this folder structure as well. This allows the segregation of organization and application including the version.
If multiple applications are required for use on a project, a variable can be used to to define the application name and thus set the Configuration location accordingly. In this scenario, the following would be placed in the Configuration Location field in Harmony:
The Application name folder must then exactly match the value of the variable for each application being set. Eg the following are the values for _USTN_PRODUCT_NAME for that application; OpenRoads Designer, Microstation.