iogas Floating Server Licence Installation Guide

Size: px

Start display at page:

Download "iogas Floating Server Licence Installation Guide"

June Wood
5 years ago
Views:

1 iogas Floating Server Licence Installation Guide

2 Contents Server Licence Technical Specifications... 4 Floating Server Licence Model... 5 Installation Steps... 5 Server Licence Usage Files... 7 Test Server Installation... 7 Desktop Client Technical Specifications PC Desktop Client Installation Mac Desktop Client Installation Connect Desktop Client to Floating Server Licence Return Token Trouble Shooting Uninstall... 25

4 Server Licence Technical Specifications Operating System CPU RAM Graphics Installation Permissions Windows 7 (32 bit) Windows Server (Version 2008 or later) Any 1 GB minimum required. Any MUST be installed while logged on with Administrator permissions and the service will run with these permissions Access to the Windows WMIC command on the computer. This can be tested by running wmic csproduct get uuid command in Windows command prompt, and receiving two lines output and no error message. Installation Disk >100Mb of free space on the Program Files drive is required for the installation process. Space Network Internet not required to run iogas. License keys are sent by . iogas client programs must be able to connect to the server via TCP/IF port (the exact port can be configured) Supporting Software NONE required.

5 Floating Server Licence Model Floating licence tokens are shared over a network between multiple users. Tokens are borrowed from the server for a specified period (minimum 24 hours) and enable the software to be used offline during this time. Tokens are automatically returned to the server when the offline time period expires or they can be returned earlier if required. The number of tokens purchased should support the number of concurrent users of the software. Floating tokens are recommended for organisations with a number of users who will be using the iogas software at irregular intervals. Available as a renewable 12 month lease. Installation Steps 1. Download the latest iogas Server Licence Software installer file from the iogas website at 2. Copy the installer file to a server computer on your network that can be accessed (via LAN, WAN, VPN, etc) by all the other computers which will be running iogas. 3. Browse to the location of the installer file on the computer and double click to run. 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 Window

6 4. Enter the desired installation directory (or leave as the default shown below). Click Next to continue. Select Destination Directory Window 5. In the final Setup Wizard window click on the Finish button.

7 6. Go to the installation folder (e.g. C:\Program Files\ioAnalytics\Licence.Server3) and locate the Server.ID.To. .txt file. Copy the ID number into an or attach this file and send to and you should receive a server.glc licence file within 1 business day. 7. When you receive the server.glc file copy it to the Licence.Server3 installation folder. The iogas Server Licence operates as a Service under Administrative Tools in the Control Panel (Windows OS). It is not necessary to restart the Licence Server service after installation or when a licence file is updated. The service should be running even if not licensed (It will just reject any requests). If a TCP/IP port number other than the default is to be used to contact the server, edit the server.ini file located in the Licence.Server3 installation folder to the desired port number. Server Licence Usage Files In order to assist organisations to see who currently has an iogas server licence token, there are two log files available in the C:\Program Files\ioAnalytics\Licence.Server3 folder (default installation). 1. To create these files right-mouse click on the makelogs.exe located in the installation folder. 2. Select Run as Administrator from the pop-up menu. The following files should be added to the installation folder: o o o _Licence.Server.Summary.v3.csv list of current iogas users _Licence.Server.Usage.v3csv list of all connections to the server licence _Licence Info.txt - View information about the server licence file Test Server Installation 1. To confirm the Server Licence service is running on a Microsoft Windows Server, Windows 7, or Vista machine go to the Control Panel and select Administrative Tools.

8 2. In Administrative Tools select Services. 3. Scroll down the list of services and double click on the ioanalytics licence server service.

9 4. In the ioanalytics licence server Properties dialog the service should show as started (regardless of if it is licensed) and no warning dialog will appear if the service is stopped and started or restarted.

10 Desktop Client Technical Specifications Operating System 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 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. Access to the Windows WMIC command on the computer. This can be tested by running wmic csproduct get uuid command in Windows command prompt, and receiving two lines output and no error message. Installation Disk Space Network >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:

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

12 PC Desktop Client Installation 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.

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

14 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.

15 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

16 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.

17 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. Mac Desktop Client Installation 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.

If the installer file has unpacked properly the Setup Wizard screen is displayed.

18 2. Browse to the location of the installer file on the computer and double click to run. 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.

19 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.

In the final Setup Wizard window click on the Finish button.

20 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:

Connect Desktop Client to Floating Server Licence 1.

If you are running a Mac or the two-week trial

22 Connect Desktop Client to Floating Server Licence 1. Start the iogas software 2. Select the Help> Licence Server Connection menu option. If you are running a Mac or the two-week trial period has expired click on the Configure Licence Server button in the dialog below: 3. The iogas Licence Server dialog is displayed.

Example Server Licence Configuration Showing Host and Port Details 4. Check the Connect to Licence Server box. 5. In the Host window enter the server name or IP address.

23 Example Server Licence Configuration Showing Host and Port Details 4. Check the Connect to Licence Server box. 5. In the Host window enter the server name or IP address. Enter the Port number if it is not the default (Your IT Administrator will be able to provide you with this information) 6. Click on the Test button to make sure the connection is working. If you do not receive a "Successful connection to Floating server at PutHostHere:31415" message displayed or you receive any other error messages contact your IT Administrator. Otherwise click OK twice to exit this dialog and continue to this dialog: 7. Select an Offline Period (days) between 1 and 90 days (24 hours-12 weeks). The Offline Period is the duration for which the iogas software can be used while not connected to the server licence network. Please note that each time the software is started while connected to the server licence network however, the token will automatically refresh so it will be valid from the current date. 8. Click Get Token to finish. 9. Re-start iogas for the server licence token to take effect. The organisation name followed by [S] [Floating] is displayed on the screen when the program is running with a floating server licence like in the example below:

Return Token A token is automatically returned to the server when the offline period expires.

If the software is started while connected to the server licence network before the expiry date the token offline period

Select the Help> Licence Server Connection menu option. 2. The iogas Licence Server dialog is displayed.

24 Return Token A token is automatically returned to the server when the offline period expires. A warning message is displayed when there are less than 2 full days remaining in the offline period. If the software is started while connected to the server licence network before the expiry date the token offline period will be refreshed so that it will be valid from the current date. To manually return a token to the licence server: 1. Select the Help> Licence Server Connection menu option. 2. The iogas Licence Server dialog is displayed. Click OK to continue. 3. Select Return Token. If you have unsaved edits in the currently open iogas file you will be prompted to save them. 4. When you click OK the iogas software will close.

25 If you experience any problems please contact your IT Administrator for assistance. To view your token details at any time see Help>About menu option. Trouble Shooting If you have difficulty connecting to the server licence at any stage it may be necessary to start the service again. To do this, login to the server host machine and go to Control Panel>Administrative Tools>Services. Scroll down to the ioanalytics Licence Server service and double-click on this service. In the Properties dialog the service should show as started (regardless of whether a licence is present). Click on the Stop button and then click on the Start button to re-start the service. If you are still having problems please send an to iogas.support@imdexlimited.com and make sure to attach the log, report.log and server.log.txt files located in the Licence.Server3\log folder. Uninstall To uninstall the iogas server licence software use the Control Panel entry or click on the uninstall.exe located in the Licence.Server3 folder. Note that Service will need to be stopped before the uninstall process can begin. A number of remnant files/folders will remain after uninstalling including the server.glc licence file. Delete these remaining files manually. See also the iogas Licensing FAQ for more information on common issues.

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...