Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This guide is intended to help customers prepare for the smoothest transition to Iguana XIguanaX, guiding you through the first steps in migrating your existing Iguana v6 channels to Iguana X IguanaX components. Our migration tools are evolving as we work with customers on their unique Iguana use cases.

Here are a few steps to set up your environment and get started with our migration tools before meeting with us to review your Iguana X IguanaX environment:

Expand
titleInstall Iguana X IguanaX if you haven't already

Download Iguana from https://install.interfaceware.com:8080/ and review our Installation documentation.

Expand
titleExport your Iguana v6 channels to a Git repository in with your cloud Git service provider.

If you do not have one, then you can set up a free account with Bitbucket or Github.

If you have not done this before, we’ve prepared this guide for how to do it: Exporting Iguana 6 code to a Repository. Let us know if you need additional help!

Some customers have tried to share git repos with GitLabs - although you can import Iguana X IguanaX components from any git repository - it unfortunately has not be the smoothest platform to work with in our experience.

Expand
titleAdd any environmental variables used by your channels to Iguana XIguanaX.

See Environment Variables for where and how to add these in Iguana XIguanaX.

Expand
titleImport and run the channel converter in Iguana X IguanaX to convert your version 6 channels

Follow along the steps to import the tool into Iguana X IguanaX and give it a try: Iguana 6 Channel Importer

It’s guaranteed to not 100% successfully convert your channels the first time you run it, but this is an important step for us to identify what the problems are and get moving on addressing them. Every time we go through this process with a customer we found we have been able to improve our process. We are trying to move quickly to identify and solve problems.

If you’re interested in having our team work directly with you on your migration path, contact support@interfaceware.com! . You can provide us access to your v6 Iguana 6 channels using one of the following methods:

Expand
title1) Give us access to the cloud git repository with your channels

This step entails copying the SSH link (ex. git@bitbucket.org:johndoe/iguanaxrepo.git) and sending it to us. Please ensure that your repository is public so that we may pull the channels into Iguana X for testing (this change is made on Bitbucket or Github).

Of course be super careful not to put any Patient Health Information (PHI) in this repo. But making your channels available means we can move a lot faster to help make sure your interfaces will port over to IguanaX easily. If you need some help getting this configured let us know.

Expand
title2) Export your Iguana v6 6 channels to a local repository and share it with us

If you haven’t exported channels to a local repository, we’ve outlined the steps: Exporting Iguana 6 Channels to a Local Repo.

...