Versions Compared

Key

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

Your time is valuable and so we’ve prepared this guide to help you get organized well in working with us.This guide is intended to help customers to prepare the way for the smoothest transition to Iguana X that we can. To do this will mean sharing some of your channels with us. Of course be very careful not to send us any real Patient Health Information (PHI). If you have time to do these steps before we meet it will really help., guiding you through the first steps in migrating your existing Iguana v6 channels to Iguana X 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 environment:

You can go here:

Expand
titleInstall Iguana X
if you haven't already

Download Iguana from https://downloadsinstall.interfaceware.com/iguanax/And follow the instructions to install IguanaX:8080/ and review our Installation documentation.

Expand
titleMake sure you have access Export your Iguana v6 channels to a cloud accessible GIT repo account provider like bitbucket or githubGit repository in your cloud provider.

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

If you have a choice bitbitbucket is not a bad choice since we know it and can help you. Github also works well.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 - but unfortunately it has not worked so far GitLabs - although you can import IguanaX Iguana X components from any git repository - it just unfortunately has not be the smoothest platform to work with in our experience.

Expand
titleExport your channels to a Git repo in your cloud repo provider.

If you have not done this before, then we prepared this guide for how to do it. Let us know if you need additional help!

Expand
titleGive us access to this git repository in the cloud Add any environmental variables used by your channels to Iguana X.

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

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

Follow along the steps to import the tool into Iguana X 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, you can also provide us access to your v6 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 IguanaX 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.We’re happy to use github or Bitbucket or any other git cloud provider that we can access. If you need some help getting this configured let us know.

Expand
title2) Export your Iguana v6 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.

translator has at least one good sample messageDocument the environmental require so we can set them up in our environment
Expand
titleAdditional information we will need to setup our environment...
  1. Make sure every

  1. Translator that needs sample data

titleIt is important in order to be able to run channels that we have a
  1. contains at least one good sample data message

with each translator. Without it we cannot run your code in Iguana 6 to see how it is meant to run.

We’re happy to brainstorm with you on how to achieve this if you need advice on it - really we are happy with just one message - that is plenty.

  1. so we can see how the channel is supposed to run. Just remember no real PHI please!

Expand
  1. A list of

  1. environment variables used by your channels

One
  1. - one of the best practices is to document these variables in your translator components. It’s really helpful

.
Expand
titleTry running the channel converter in IguanaX to convert your channels.

Here’s the page explaining how to go about trying to do this, do your best to give it a try.

Iguana 6 Channel Importer

It’s guaranteed to be 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.

Expand
titleOverwhelmed? Could not make one of the steps work? We can help.

Breathe deeply.

It’s okay.

We are here to help. When we go through the first zoom call with you, we’ll help you with all the above steps if you haven’t managed to find the time or stumbled on any of the steps
  1. .

Looking forward to working with you! Together we make our lives better by making to possible to transition to a cleaner simpler and more reliable way of building and maintaining interfaces.