PLEASE READ THIS FIRST

OpenInsight 10.0.7

 

Introduction

Thank you for evaluating or purchasing OpenInsight v10.0.7!

Before you begin

When installing OpenInsight 10 make sure to have your authorization code supplied by Revelation Software.  This authorization code can be obtained from the OpenInsight Works Gateway page.  Click on the link Request an Authorization Code.

Works members can download the OpenInsight 10 Full Install from the Works Downloads section of our web site.

An evaluation copy of OpenInsight 10 can be downloaded from the Download Evaluation page on our web site.

Close all non-essential Windows programs and antivirus software.  

The software will only run on Windows 7 Professional 64-bit, Windows 7 Ultimate 64-bit, Windows 8 64-bit all versions except RT, Windows 8.1 64-bit all versions except RT, Windows 10 64-bit Pro and Enterprise, Windows 2008 Server 64-bit, Windows Server 2012 with full GUI, Windows Server 2012 R2 with full GUI, Windows Server 2016 with full GUI, Windows Server 2019 with full GUI.

Major Changes in the OpenInsight 10.0.7 Release

OpenInsight now provides an option to change the precision of mathematical operations.  This can be set by calling the setEPMode stored procedure, passing in 1 to enable and 0 to disable the functionality.  By default, the extended precision math will maintain 32 digits of precision, but  this can be modified by calling the setEPModePrecision stored procedure, passing in the number of digits of precision desired.  Both the enabling of extended precision, and the default number of digits, can also be defined in the application properties.  The following operators/functions are affected: +, +=, -, -=, *, /, ==, =, !=, <>, >, <, >=,<=, mod(), int(), abs(), atan(), cos(), exp(), ln(), pwr(), sin(), sqrt(), tan()

OpenInsight's RLIST functionality and performance have also been improved starting with the 10.0.7 release.  A new version of RLIST (RLISTX), which optionally replaces and extends RLIST, is available to enable these enhancements. RLISTX merges the features of RLIST, SELECT_INTO, OLIST/RUN_REPORT, and RTI_XBAND. One obvious change is the ability to pass in multiple select statements to RLIST in a single call, @FM delimited.  Using the Record Editor, or the Configuration Record option from the OI Console, you must create a CFG_RTI_RLIST record in SYSENV, with RLISTX in field 1.  If this record doesn’t exist, or has anything other than RLISTX in field 1, then normal RLIST behavior ("RLIST 9") and functionality will remain.  (Note that the CFG_RTI_RLIST information is cached by your system; after changing this value, you should exit and re-enter OpenInsight).

The MultiValue BFS (MVBFS) connections for QM, D3 and U2 have been enhanced to submit multiple select lists to the "back end" host for bulk processing whenever possible.  This enhancement can result in significant performance improvements when using an MVBFS connection.  Note that these changes work in conjunction with the RLISTX changes discussed above; you must enable RLISTX and install a "plugin" stored procedure on the host system to access these changes.  There is now a button on the MVBFS connection designer which will install this plugin (a program named RTI_MVBFS_SERVER_PLUGIN_U2, RTI_MVBFS_SERVER_PLUGIN_D3, or RTI_MVBFS_SERVER_PLUGIN_QM).

License Enhancements For OpenInsight 10.0.4 and Above 

Starting with OpenInsight 10.0.4, "child" processes launched from OpenInsight can be configured so that they do not consume additional license seats.  In particular, CTO, AREV64, BRW, and O4W calls (using the engine server's built-in web server) made from a copy of OpenInsight will not count against the licensed count of users.
 
For example, a single user copy of OpenInsight can now run the IDE, a CTO session, and generate a BRW report at the same time.
 
Note that this enhancement requires both OpenInsight 10.0.4 (or above), and the Universal Driver 5.2 (or above).  OpenInsight 10.0.7 will work with the Universal Driver 5.1, but it will not exhibit these license enhancements until it is "paired" with a UD 5.2.
 
To take advantage of this license enhancement for O4W and engine server tasks, users/developers must update their eserver.cfg file (either directly or through the Settings dialogs).  In particular, any passwords that are currently explicitly embedded in the eserver.cfg can be replaced with an asterisk ("*"); this indicates that the specific connection should use the enhanced licensing.  This also has the additional advantage of no longer requiring manual updates to the eserver.cfg file when passwords are changed for the applications or users defined in the connection string.  (As an additional enhancement, the username can also be replaced with "*" if you wish to use the 'default user' created for an application).
 
For example, if your eserver.cfg previously contained the following lines:
 
WebServerConnection_console=SYSPROG,OICONSOLE,OICONSOLE,65,1,RUN_OECGI_REQUEST,,,1,,
SystemMonitor=RTI_OEMONITOR_CLEANUP,SYSPROG,SYSPROG,SYSPROG;RTI_OEMONITOR_INDEX,SYSPROG,SYSPROG,SYSPROG

 
They can now be replaced with the following lines:
 
WebServerConnection_console=SYSPROG,OICONSOLE,*,65,1,RUN_OECGI_REQUEST,,,1,,
SystemMonitor=RTI_OEMONITOR_CLEANUP,SYSPROG,*,*;RTI_OEMONITOR_INDEX,SYSPROG,*,*

 
************************************************************************************************************************
 
NOTE: OpenInsight 10.0.7 requires the .Net 4.7 framework.  Certain versions of Windows (for example, those running Windows 10 version 1507 or earlier) may have difficulty installing the .Net 4.7 framework.  Before you install this release of OpenInsight 10, please ensure that all required systems have been upgraded to .Net 4.7.  For more information, see this:
 
https://docs.microsoft.com/en-us/dotnet/framework/install/on-windows-10
 
************************************************************************************************************************

Instructions

Running Setup for OpenInsight 10.0.7 (Full Install) 
  1. Copy the OI10Setup64.exe and OI 10 Authorization code to your local “C:” drive.
  2. Copy your OI 10 authorization code to your buffer.
  3. Right-click and “Run as administrator” on OI10Setup64.exe.
  4. Paste in your authorization code when asked.
  5. Choose “Enable enhanced login security policy”.
  6. Click finish and keep “Register client files” checked.
  7. During the client files install, answer “yes” to install optional components.
  8. Make sure that the latest 64-bit java runtime is installed on your computer.

Running Setup for OpenInsight 10.0.7 (Update) 

  1. Copy the OI10UPDTSetup.exe and OI 10 Authorization code to your local “C:” drive.
  2. Copy your OI 10 authorization code to your buffer.
  3. Right-click and “Run as administrator” on OI10UPDTSetup.exe.
  4. Paste in your authorization code when asked.
  5. Browse to your existing OpenInsight 10 Executable Directory.
  6. Enter the password for SYSPROG.
  7. Enter the password for EXAMPLES
  8. Click finish and keep “Register client files” checked.
  9. During the client files install, answer “yes” to install optional components.
  10. Make sure that the latest 64-bit java runtime is installed on your computer.

Initial Startup

  1. Launch your engine server from the DOS CMD prompt.  Run as administrator, CD to C:\Revsoft\OInsight10 directory and type: java –jar oesocketserver.jar
  2. Make sure that ports 18888 and 18088 are permitted in your Windows Firewall inbound rules.
  3. Launch the OI SYSPROG shortcut.  The OpenInsight presentation server executable is located in C:\Revsoft\OInsight10\ OpenInsight.exe.  If you create a shortcut to OpenInsight.exe make sure that the Target properties include /ap=SYSPROG /un=SYSPROG /pw=SYSPROG /dv=1.  This will launch you into the main SYSPROG application.
  4. To log into the SYSPROG application without the command line switches, log in with Application: SYSPROG, User Name: SYSPROG, Password: SYSPROG
  5. To log into the EXAMPLES application use: Application: EXAMPLES, User Name: EXAMPLES, Password: EXAMPLES
  6. To start the Management Console, from the IDE choose, View, Management Console.  Log in as User Name: OICONSOLE and Password: SYSPROG.
  7. To launch O4W, start a browser and go to: http://localhost:18888/o4w/.  Login as User Name: OICONSOLE and Password: SYSPROG.
  8. Documentation is located in the OInsight10\Documents folder.
If you find any issues or have any suggestions while running OpenInsight 10, please enter them into our OpenInsight Issue Tracking System & Suggestion Box located on the Works Gateway page of our web site.  This page also includes a Works Discussion board for questions and answers.

OpenInsight Works

OpenInsight is licensed per user and OpenInsight Works is licensed per developer. If you need additional development licenses or have questions regarding licensing, please contact your Revelation Software sales representative or Revelation Software's Customer Service department at (800) 262-4747.
 
As further releases to the OpenInsight product line are made available, they will be announced on www.revelation.com.
 
If you do not have access to the World Wide Web, please contact your Revelation Software sales representative or Revelation Software's Customer Service department at (800) 262-4747 or (201) 594-1422.
 
In the UK and Europe, please call +44 (0) 208 912 1000 and in Asia, please call +64 (9) 534 9134.