HOW TO BE AN IGUANA POWER USER - … to be an Iguana Power... · IGUANA USER CONFERENCE 2013....

HOW TO BE AN IGUANA POWER USER

IGUANA USER CONFERENCE 2013

AGENDA FORMAT

•  Introduction – View Point – Power User –  Iguana

•  Three Narratives

– Where are the Iguana Translator Projects? – Where are the Iguana Logs? – How to build your Iguana platform

•  Wrap Up IGUANA USER CONFERENCE 2013

INTRODUCTION


•  View Point •  Power Users •  Iguana

IGUANA POWER USER


•  Iguana 5.5 Power Users understand Iguana as a platform

•  Know where Iguana files live •  Use Iguana for IT support functionality •  Use Iguana in SDLC as IDE for

analysis, design, development, enhancements and testing

IGUANA 5.5


•  Settings

•  Logs

•  Dashboard

•  Translator

•  Lua •  API •  Module •  Platform

DASHBOARD


•  http://wiki.interfaceware.com/1190.html

IGUANA SETTINGS


WHERE ARE THE IGUANA TRANSLATOR PROJECTS

•  What are these files? •  What are the controls on the scripts? •  Did I backup the files?

•  Why is it important to know this •  Control design, development, testing and support

•  How do we get the information? •  Text editor, Translator IDE, Fossil, Translator API


WHERE ARE THE TRANSLATOR FILES

•  IguanaConfiguration.xml •  vcs_repo.sqlite •  edit/admin/<GUID>/

•  main.lua •  project.prj

•  edit/admin/shared/ •  codemap, dateparse, hl7util, netrequire, node, ran,

stringutil


TRANSLATOR SCRIPT


TRANSLATOR IDE


TRANSLATOR SCRIPT UPDATING


•  Edit the Script

TRANSLATOR IDE AND SCM


•  Save the Milestone

TRANSLATOR MILESTONE


•  Review Milestone

•  Identify Changes

TRANSLATOR DIFF


FOSSIL DIFF


•  Diff •  Translator

Project in Fossil

FOSSIL

•  SCM tool •  SQLite database •  View into entire Iguana Instance •  Timeline of Changes •  Understanding Source Code Control


•  $> ./fossil ui vcs_repo.sqlite


TRANSLATOR AND FOSSIL


WHERE ARE THE IGUANA LOGS

•  What is Iguana Logging? •  Where are the Iguana Logs? •  What are these files?

•  Who, what, when, where and why •  Did I backup the files?

•  Why is it important to know this •  Control design, development, testing and support

•  How do we get the information?


IGUANA LOGGING

•  Iguana is a robust message router and transform engine with full auditing capability and extensive search functionality

•  Iguana is a reliable and fast message data store

•  Append only logging with full CRC checking for high availability and integrity


LOGS DIRECTORY


LOGS FILES

•  YYYYMMDD.log –  Iguana Write Thru Message Logs – Schedule into a backup plan

•  Index files –  log/index/*.* – Log/meta/*.* – Generated from scratch, not for backup



IGUANA LOGS

•  FTS and REGEX based searching •  Find All Related Entries •  Resubmit to a different channel


IGUANA LOGS


LOGS – SEARCH PANEL


•  FTS •  Substring •  REGEX •  Date, Time •  Channel •  AND, OR, NOT •  Google like syntax

LOGS – SEARCHING


Find whole words ! Find parts of words / Regular Expression Range Name Compound question

•  FTS •  Substring •  REGEX •  Date, Time •  Channel •  AND, OR, NOT •  Google like syntax

LOGS MESSAGE ACTIONING


LOGS – RELATED ENTRIES


LOG MESSAGE RESUBMIT


•  Edit the message

•  Review •  Select the

Resubmit channel

LOG EXTERNAL API


•  Logs External API

•  Search and Mine messages

•  Filters •  Date Ranges

LOG API_QUERY


HOW TO BUILD YOUR IGUANA PLATFORM

•  Program in Lua – Use Tips and Tricks – Use Built in API

•  Create a Module •  Use existing modules •  Use External API •  Use Channel API •  Build an Application


PROGRAM IN LUA


•  Practice Lua •  Follow the Original Power User - Eliot

TRANSLATOR LUA TIPS


•  Function trace(a,b,c) return end •  declare variables local •  Keep your functions short •  pcall to catch errors •  error to interrupt flow •  queue.push() writes your message

CREATE A MODULE


MODULES ENCAPSULATES FUNCTIONALITY


hisadmin. isValidEvent

USE WEB API

•  monitor_query •  status.html •  api_query •  debug


USE EXISTING MODULES

•  Example: Store •  Persistent data store •  Logging workflows •  Reconciling workflows •  Mapping Rules •  Documented API


CHANNEL API


•  Iguana 5.5 channel API – provides start, stop and status capability

•  Iguana 5.6 channel API – Builds on 5.5 – Create channels, clone channels – Available as snapshot release

IGUANA 5.6 CHANNEL API


BUILD AN APPLICATION


•  Select an API or existing module •  Design the storing of the data (see Store) •  Design the front end •  Iguana works well with javascript jQuery

library

DESIGN

•  Pick a data source for instance monitor_query Iguana API

•  Pick a backing store, SQLite database •  Design Logic, Store API output to

database •  Provide javascript front end with controls

for query criteria


MONITOR PLOTTER SCRIPT


•  main(Data) •  Plotter

HTTPS Channel

MONITOR PLOT


•  Browser based application

•  jQuery and flot

•  Monitor Iguana instances and produce graphed results •  http://wiki.interfaceware.com/1448.html

UPCOMING MEMBERS APPLICATION


•  API runs in Iguana as a translator project

•  jQuery front end on nginx •  MySQL database •  Iguana runs on Amazon

EC2 •  Rolling out new members

application this year

WRAP UP

•  Three Narratives – Where are the Iguana Translator Projects? – Where are the Iguana Logs? – How to build your Iguana platform

•  Thank You


HOW TO BE AN IGUANA POWER USER - … to be an Iguana Power... · IGUANA USER CONFERENCE 2013....

Documents

Transcript of HOW TO BE AN IGUANA POWER USER - … to be an Iguana Power... · IGUANA USER CONFERENCE 2013....