ODIS-IC/NDT Quick Installation Guide

From OKOS Wiki
Jump to navigation Jump to search

This guide describes the basic steps to get ODIS-IC or ODIS-NDT installed on your system.

BEFORE YOU BEGIN

IF YOU ARE UPGRADING FROM A PREVIOUS VERSION
Do NOT uninstall the previous version until the new version is installed. The ODIS installer will copy settings and parameters from the previous version. The previous version can be left in place if the user wishes to revert to the old program at a later time.

MAKE SURE YOU ARE USING THE CORRECT INSTALL BEFORE PROCEEDING.
32-bit Installs are named "ODIS_3_xx_xx.msi". 64-bit installs are named "ODIS_3_xx_xx-64.msi". If the wrong version is installed, ODIS will display an error message and exit.

CHECK YOUR SYSTEM REQUIREMENTS
Look here.

IF YOU RECEIVED THE ODIS INSTALLER IN A ZIP FILE, EXTRACT THE FILES TO A CONVENIENT FOLDER BEFORE PROCEEDING.
Installation will not work correctly unless the files are extracted.

Installation Procedure

Follow the steps in order.

Start the installer

Installer

Run the "ODIS_3_xx_xx" MSI. You will get a dialog box like the one below.

Hit "Next".


Select Run Mode

Run Mode

Select the default mode in which you wish ODIS to run.

By default, "ODIS" is selected. Choose "ODIS (Post-Processing)" if you are going to run ODIS offline for post-processing or reading of ODIS data. Make sure your computer meets the minimum requirements for ODIS.

Run modes such as Basic, Advanced, or Production can be chosen through the Security manager.


Set the Install Options

Select Install Options

Select whether to create a new ODIS_DATA folder, and/or copy configuration settings from the previous version.

IF YOU ARE UPGRADING FROM A PREVIOUS VERSION
a) You do not need to recreate an ODIS_DATA folder: Uncheck that option.
b) Make sure "Copy Configuration" is checked.

IF YOU ARE INSTALLING ON A NEW SYSTEM, OR NOT COPYING CONFIGURATION SETTINGS FROM A PREVIOUS VERSION ("CLEAN" INSTALL)
a) Make sure to uncheck the "Copy Configuration" option.
b) If you are installing a new version, make sure the "Install ODIS Data Folder" option is checked. Otherwise, leave it off.
c) You will be prompted to specify the type of Motor Controller and Pulser/Receiver in the system

Note: "Copy Configuration" will have no effect if no previous version of ODIS is installed.

When your options are set, hit "Next".


Specify the Motor Controller type (new/clean installs only)

Motor Controller Setup

The user will be prompted to specify the type of motor controller in the system.

If installing an offline system, select "None".

Select the type and hit "OK".


Specify the Pulser/Receiver type (new/clean installs only)

Pulser/Receiver Setup

The user will be prompted to specify the type of digital Pulser/Receiver in the system. The Communication Port or IP Address (depending on the type of P/R) must also be set.

If installing an offline system, select "None".

Select the P/R type and Port, then hit "OK".


Configure Communications (new/clean installs only)

Configure Communications

ODIS has configuration settings for I/O, LightPole, and can be configured as a server. Set the parameters on this page. Leave blank any items not in use. If copying the setup from a previous version, this page will be skipped.

LightPole Addr
the IP Address of the attached Light Pole (if present) If none, leave blank.
Server Port
the TCP/IP Port to be used if configuring ODIS as a server. The IP Address will be loaded from the IP address of the install computer. If you do not want to treat ODIS as a server, leave blank.
Server Name
the name of the Server as broadcast over UDP. Optional.
I/O Addr
the IP Address of the attached I/O Interface (if present). If none, leave blank.



Select Token File

Token File selection

Select the token file to be used to activate this installation. A token file is required for ODIS to run. If you have no token file, contact OKOS Solutions. You can add the token manually at a later time if one is not present.

If installing from a previous version, simply browse to the location of the previous install and select the token file from that directory.



Select Installation folder

Select Installation Folder

You can change the default installation folder as needed. It is recommended to NOT install the software in the "Program Files" directory, so as to allow easy access to ODIS configuration files.

Leave the installation on "Everyone". Hit "Next".


Confirm your Installation

Confirm Installation Settings

Hit "Next".


Installing

Installation Progress

Progress bar will appear. You may get a dialog asking if you want to make changes to the computer: if so, select "Yes".

When installation is complete, hit "Next".


Finish Installation

Installation Complete

Press "Close". Your installation is complete.



Install Token File Manually (Optional)

If your token expires or you had an older system, you will have to manually install the token file. To update or install your run Token, perform the following steps:

  1. Put the Token file provided by OKOS into the application installation directory.
  2. open the file with extension ".exe.config" in a text editor
  3. find the "TokenFile" key, it will be located in the "appSettings" section near the bottom of the file:
 <add key="TokenFile" value="ODIS_IC.xml"/>
  1. change the value to match the name of your Token file. Note that token files always have an ".xml" extension
 <add key="TokenFile" value="MyTokenFileName.xml"/>
  1. save the exe.config file

Run ODIS

Example ODIS Desktop Icon
ODIS Splash Screen

To Start ODIS, double-click on the icon on your desktop, or select it from the Start Menu.

On startup of ODIS, you may asked if you want to give access to the program to certain ports, Select "Yes" (this is for Galil Ethernet-based motion controllers).