REFLEX iogas Desktop Client Installation Guide. Version 5.2

Size: px

Start display at page:

Download "REFLEX iogas Desktop Client Installation Guide. Version 5.2"

Rosa Butler
5 years ago
Views:

1 REFLEX iogas Desktop Client Installation Guide Version 5.2

2 Contents Technical Specifications... 3 Installation Guide for PC Users... 5 Single-Seat Licensing on PC PC Licence Trouble Shooting Installation Guide for Mac Users Single-Seat Licensing on Mac Mac Licence Trouble Shooting Transfer Single-Seat Licence... 20

3 Technical Specifications Operating System Windows XP (any version) Windows 7 (32 or 64 bit) Please download the matching installer Runs on Windows 8 Mac OSX or later NB. Intel based Mac only as Power PC Macs do not support Java 1.6. CPU RAM Graphics A Dual Core processor is recommended. An Intel Celeron processor is not recommended. 2+ GB recommended, 1 GB minimum required. Performance may vary with graphics card Printer/Plotters Uses operating system defaults Installation Permissions Runtime Permissions Installation Disk Space Network MUST be installed while logged on with Administrator permissions. Administrator permissions are no longer required from release 4.5. Note Users must have permission to write to C:\Users\<USERNAME>\AppData\Roaming\ and to C:\Users\<USERNAME>\AppData\Local\Temp. This is allowed by default. >100Mb of free space on the Program Files drive is required for the installation process. Internet not required to run iogas. Licence keys are sent by . Supporting Software URL Sites NONE required. Here is the list of URLs that iogas may use (the ones in bold are the more important ones). Diagrams: Application:

4 Note: Some of these links may forward to other servers.

5 Installation Guide for PC Users Download the latest iogas installer file from the iogas website at Downloads can also be obtained via the Help>Check for Updates menu option. Note that for Windows operating system users there are two installers available: A 32-bit version and a 64-version. Registration is required in order to download from this site. 1. Download the installation file onto the PC 2. Browse to the location of the installer file and double click on the executable file to run. If the installer file has unpacked properly the Setup Wizard screen is displayed. If any warning messages are received click Run to ignore. Click Next in the Setup Wizard to continue. If iogas is already installed on the machine the following dialog may be displayed first of all. Welcome dialog If you are upgrading from a previous version or re-installing the same version it should be fine to overwrite the existing installation. If you are unsure, uninstall the existing program via Control Panel>Add/Remove Programs.

6 Setup Wizard dialog 3. Read and accept the Licence Agreement and click Next to continue. Licence Agreement dialog

7 3. If there is no existing iogas installation or you selected No, install into a different directory in the first dialog, this is where you can specify the installation location. Either accept the default location (recommended) or enter the desired installation file path. If there is a previous version installed in the default location the iogas folder will already exist. The default installation folders are as follows: PC 32-bit installation C:\Program Files\ioAnalytics\ioGAS (or C:\Program Files (x86)\ioanalytics\iogas if installed on 64-bit machine) PC 64-bit installation C:\Program Files\ioAnalytics\ioGAS-64 Click Next to continue. Select Destination Directory dialog (32-bit default location) 5. Select the Start Menu Folder name (default is shown below). The option to Create shortcuts for all users can also be selected in this window. Click Next to continue.

8 Setup Start Menu and Shortcuts dialog 6. The Select File Associations window enables the software to open when an iogas generated file is double-clicked in Windows Explorer. Click Next to continue. Select File Associations dialog

9 7. To create an iogas desktop icon, check the box in the Select Additional Tasks window. Click Next to continue. Select Additional Tasks dialog 8. Click Next to start the installation.

9. To start the iogas program either select Start>Program Files>ioAnalytics>ioGAS or double-click on the iogas desktop icon if created during the installation process.

10 9. To start the iogas program either select Start>Program Files>ioAnalytics>ioGAS or double-click on the iogas desktop icon if created during the installation process. Single-Seat Licensing on PC When iogas is installed onto a machine for the first time the software will run for two weeks in evaluation mode. After this time the software will require a valid licence file in order to run. If you have purchased a single-seat iogas or a 12 month academic or stand-alone node-locked licence then you will need to send us your Machine ID number in order for the licence file to be issued. 1. Select Help>Send Machine ID within iogas Example Send Machine ID window 2. the Machine ID number to iogas.licence@imdexlimited.com. Use the Copy address and Copy Machine ID buttons to copy and paste these details into the Within 1 business day you will receive an iogas licence file gas.single.glc by return Copy the gas.single.glc file to the C:\ProgramData\ioGAS folder. If licensing a shared computer this will enable all users who login to the computer to access the iogas software. The C:\ProgramData\ioGAS folder may be hidden from view on your computer in Windows Explorer. To make this file path visible go to the Organize drop-down menu and select Folder and Search Options from the list. Click on the View tab and scroll down to Hidden file and folders. Check the Show hidden files, folders, and drives option. Click OK to finish.

11 PC licence location gas.single.glc file 5. If iogas is already open then re-start for the new licence details to take effect. 6. To check that iogas is licensed correctly select Help>About. The dialog should state that the licence is valid with the correct Machine ID and Licensed Days remaining on your machine.

Single-seat licence details in Help>About dialog PC Licence Trouble Shooting If you have any problems licensing the iogas software firstly check that the gas.single.

12 Single-seat licence details in Help>About dialog PC Licence Trouble Shooting If you have any problems licensing the iogas software firstly check that the gas.single.glc file is located in the correct folder. If the licence file is in the correct folder but iogas is still not working then please send the log.txt file located in the C:\Users\Username\AppData\Roaming\ioGAS\log folder to Help>About dialog contains the build version and other critical information. If you are experiencing difficulties a screen capture of this information may help us to determine the cause of the problem. The C:\Users\Username\AppData\Roaming\ioGAS\Log folder may be hidden from view on your computer in Windows Explorer. To make this file path visible go to the Organize drop-down menu and select Folder and Search Options from the list. Click on the View tab and scroll down to Hidden file and folders. Check the Show hidden files, folders, and drives option. Click OK to finish.

Installation Guide for Mac Users To install iogas4.5 or later on a Mac it must be running OSX 10.7.3 or later. Older versions of iogas can be run with OSX 10.5.4 or later.

13 Installation Guide for Mac Users To install iogas4.5 or later on a Mac it must be running OSX or later. Older versions of iogas can be run with OSX or later. If eligible for OSX updates then this can be done by opening Apple Software Update and following the prompts. The Mac must also have at Java 1.7 or later installed on the machine. Older versions of iogas require Java 1.6 to be installed. Java 1.7 is not compatible with earlier versions of OSX, so the iogas software cannot be run on these computers. If you do not have the correct version of Java a message may be displayed similar to this one: Java updates can be downloaded and installed from the website. Make sure to download the latest JRE 1.7 for Mac OSX and follow the prompts to install. 1. Download the latest iogas Mac installer file from the iogas website at Registration is required in order to download. Downloads can also be obtained via the Help>Check for Updates menu option. 2. Browse to the location of the installer file on the computer and double click to run.

displayed. If any warning messages are received click Run to ignore.

14 Download Installer file to local machine 3. If the installer file has unpacked properly the Setup Wizard screen is displayed. If any warning messages are received click Run to ignore. Click Next in the Setup Wizard to continue. Setup Wizard dialog 4. Read and accept the Licence Agreement and click Next to continue.

15 Licence Agreement dialog 5. The Select File Associations window enables the software to open when an iogas generated files is double-clicked in Finder. Click Next to continue.

16 6. To create an iogas desktop icon, check the box in the Select Additional Tasks window. Click Next to continue. 7. In the final Setup Wizard window click on the Finish button. 8. Once installed iogas will now be displayed in the Applications list:

Note: The 2 week trial is not available in the Mac installation. Please contact us if you would a trial licence file and include your Machine ID number.

Single-Seat Licensing on Mac To run iogas on a Mac computer a valid licence file is required.

17 Note: The 2 week trial is not available in the Mac installation. Please contact us if you would a trial licence file and include your Machine ID number. This number can be found by starting iogas and clicking on the "Send Machine ID" button in the displayed dialog. Single-Seat Licensing on Mac To run iogas on a Mac computer a valid licence file is required. Please also use this process to obtain an evaluation licence as the two-week free trial period is not available on a Mac computer. If you have purchased a single-seat iogas or a 12 month academic or stand-alone node-locked licence then you will need to send us your Machine ID number in order for the licence file to be issued. 1. Start the iogas software 2. Click on the Send Machine ID button in the following dialog: 2. Send the Machine ID number to iogas.licence@imdexlimited.com via . Use the Copy address and Copy Machine ID buttons to copy and paste these details into a new . If requesting an evaluation licence, please make a note of this in the .

To install the licence file, right-mouse click on the iogas application and choose Show

18 3. Within 1 business day you will receive an iogas licence file gas.single.glc by return To install the licence file, right-mouse click on the iogas application and choose Show Package Contents: 5. Browse to the Contents>Resources>app folder and copy the licence file to this location. Default Installation Folder Showing gas.single.glc file

19 6. Start iogas from the Applications folder or from the desktop icon and it should now be fully installed and licensed. 7. To check that iogas is licensed correctly open the application and select Help>About. The dialog should state that the licence is valid with the correct Machine ID and Licensed Days remaining for your machine. Valid Licence Details Note that anyone who logs onto this machine will be able to use this iogas licence. Mac Licence Trouble Shooting If you have any problems licensing the iogas software firstly check that the gas.single.glc file is located in the correct folder (not in the parent ioanalytics folder or in a sub-folder under the installation path). If the licence file is in the correct folder but iogas is still not working then please send the log.txt file located in the apps folder (default installation) to iogas.support@imdexlimited.com

20 The Help>About dialog contains the build version and other critical information. If you are experiencing difficulties a screen capture of this information may help us to determine the cause of the problem. Transfer Single-Seat Licence Although the single-seat licence is locked to one computer there may be instances where it needs to be transferred to another computer for example, if you purchase a new computer, re-build your existing computer or a licence needs to be moved from a computer used by somebody who is no longer with your organisation. In all of these events we will need to issue you with a new licence file. To request a new licence file please iogas.licence@imdexlimited.com and provide details about the licence to transfer (name and/or Machine ID number), new licence holder name, new licence holder address and the Machine ID of the new computer. This can be found under the Help>Send Machine ID menu option from within iogas or click on the Send Machine ID button in the displayed message window when iogas is started.

iogas Classic Server Licence Installation Guide Version 6.0

iogas Classic Server Licence Installation Guide Version 6.0 Contents Server Licence Technical Specifications... 4 Classic Server Licence Model... 5 Installation Steps... 5 Server Licence Usage Files...