Page Comparison

This is something we are building out incrementally starting with a few customers migrating to Iguana X. It’s evolving and proving very helpful in helping us figure out how we can streamline the conversion process .

Expand

title	You'll need 10.1.81 or newer - this video shows how the converter is meant to run

converter.mp4

...

title	So far we are having success with the converter

through finding the key use case patterns and how they can be brought over in a smooth and safe fashion.

Reminder: Reach out to work with us - support@interfaceware.com. We’ve successfully helped a few customers use the converter. It’s been extremely helpful in quickly identifying issues we need to address to help them port over.

If you want to try this - please reach out and we can arrange a Zoom to try it with you - well be happy to walk you through it.

Expand

title	You'll need 10.1.81 or newer - this video shows how the converter is meant to run

converter.mp4

Since this is a new component in this list, I recommend refreshing your cache using the button below:

Image RemovedThen

Expand

title	STEP 1: Add Iguana 6 Channel Importer from + Component

to IguanaX using + Component

Clickthe Iguana 6 Channel Importer and ADD.

Image Added

Expand

title	STEP 2: Edit the custom GitRepo component property to point to a channel export from Iguana 6

Another good repo to try is: https://bitbucket.org/interfaceware/export
or in copy paste-able form:

Code Block
https://bitbucket.org/interfaceware/export

You can also use your own Iguana 6.1 channel exports.

Image Removed

Expand

title

You can test with the default repo included in the component OR you can import your own channels by using your own repository with Iguana 6.1 channels exported! SeeGetting Started for how to export your channels to your own repository.

Edit the GitRepo custom field with your Git repository link. Click the check mark to save your change.

Image Added
Tip! To get your git repository link from Bitbucket, click clone and copy the SSH link provided.
Image Added

Expand

title	STEP 3: Run the component to import and convert all the Iguana 6 channels into components.

It should generate and link a number of components corresponding to the channels in the repository.

All components imported with contain the #imported tag. Use this to filter your dashboard and view all imported components.

Info
Note: If the Importer is erroring with the message below it may be due to the repository privacy settings changing from public to

your channels.

private. To remediate the issue, refresh your Git Cache, wait for the refresh to complete, then rerun the Importer component.

Code Block

Stopping component with runtime error:
main.lua:18: Could not create _bitbucket-org:test-iguana6channels-git. fatal: could not read Username for 'https://bitbucket.org': terminal prompts disabled
Git url: git@bitbucket.org:test/iguana6channels.git

Inside the Channel Importer Tool:

Expand

title	From reading the code of the converter, how could a more detailed map of LLP server components be done?

You can see clearly how the channel structure is converted into IguanaX components in the CHAN library.

Go have a look at CHAN/CHANllpSource.lua

. This code has the mapping of configuration information from Iguana 6 into

Iguana X.

Expand

title	Some areas that we are expanding on

This is a work in progress. What we are doing is going through a practical process of exploring how in practice customers use Iguana. What are the important use patterns that we have to make easy to bring across into the new system.

We aim to quickly identify our customers can get the majority of their interfaces ported over in a smooth safe fashion

IguanaX.

Where is this going?

Expand

title	How does the iguana_shim library module work?

title

The shim module in the CHAN library allows us to simulate API functions which don’t exist under IguanaX that used to be under Iguana 6.

This

is

includes things like iguana.channelName() which don’t make sense for IguanaX which no longer has channels.

Here’s more documentation on shim functions:

Page Tree

root	@self
startDepth	1

Expand

See Shim functions.

Expand

title	How can we deal with obsolete Iguana 6 APIs?

Since the shim module is designed to be a temporary solution during your migration, what are some strategies to deal with the missing obsolete Iguana 6 APIs in your new IguanaX environment?

Our team is experimenting with streamlining this with A library to recreate Iguana 6 APIs for easier porting of code.

Expand

title	How do we convert legacy python based VMDs?

The Channel Importer tool uses our vmd_tool to convert legacy VMDs to an XML format IguanaX can ingest. If you are migrating any Iguana v6 legacy channels that use VMDs, you’ll need to ensure you have the Iguana 6.1.5 installed on the server as the vmd_tool is packaged within.

See How to convert legacy Python Based VMD channels.

Expand

title	Evolving the Channel Importer Tool

We are optimistic we can automate most of the work in converting Iguana 6 to

Iguana X

IguanaX code. Doing the conversion in this way is very powerful since it will give final control to each customer to go the last mile in terms of doing the conversion in manner which helps you each get the best conversion possible.

It makes it possible to customize the script to target specific problems that might only have an impact on your

user

use cases of Iguana

. More to say about that later

.

For now we are working with a number of customers to use this tool to accelerate the process of identifying and eliminating gaps and making

Iguana X

IguanaX a practical platform to migrate to.

Next Exporting Iguana 6 code to a Repository

...

Scaling out channel conversion.

Versions Compared

Old Version 33

New Version Current

Key