Installation Guide – Subscription Licenses

1. INTRODUCTION ............................................................................................................................................................. 2

2. INSTALLING GRAPHICODE SOFTWARE FOR A STANDALONE SUBSCRIPTION ....................................... 3

DETERMINING REQUIRED LICENSE INFORMATION ................................................................................................................. 3
3. THE NETWORK (FLOATING) USER OPTION ......................................................................................................... 4
GRAPHICODE FLEX SERVER NETWORK REQUIREMENTS ...................................................................................................... 4
4. INSTALLING THE NETWORK SERVER OPTION................................................................................................... 5

5. INSTALLING THE NETWORK CLIENT OPTION ................................................................................................... 6

INSTALLING FROM A DOWNLOADED .ZIP FILE ........................................................................................................................ 6
6. TROUBLESHOOTING AND FAQS – NETWORK USER .......................................................................................... 6

1
1. Introduction

The purpose of this guide is to assist in the installation of a subscription license for one of the
GraphiCode PowerPlatform family of programs. The following situations are covered by this
guide.

 Installation of the Single User Option

 Installation of the Network User Option (floating license)

As there is no hardware required for installing and running the software the license file supplied
by GraphiCode requires some information about the machine running the software. Therefore,
the installation is a two-step process. Firstly, the information about the machine must be supplied
to GraphiCode so that a license specific to your machine can be generated and secondly, the
installation of the software using that license can take place.

What is a Single User option?

This installation is tied to a specific PC. The license will run on the specified PC for the
subscription period and then cease working. If a different PC is required to be used (for instance
the user has their machine upgraded) please contact GraphiCode for assistance.
See Section 2.

What is a Network User Option?

This installation requires an additional software installation of the GraphiCode Flex Server license
management software on a server (or PC acting as a server). The license then 'floats' out on the
network. Users (clients) can install the application on numerous machines and then access the
license that floats around the network. This allows users at different machines to use the software
without individual licenses being required. The server machine uses a license file tied to the
physical MAC address of the server. The license used for this installation defines the number of
concurrent users. See Section 3.

 BE SURE THAT ANY OTHER GRAPHICODE PROGRAMS ARE CLOSED BEFORE

BEGINNING THE INSTALLATION PROCESS.
 IF YOU USE A PREVIOUS VERSION’S LICENSE FILE TO INSTALL THE CURRENT
VERSION OF SOFTWARE YOU MAY NOT HAVE ACCESS TO THE LATEST
FUNCTIONS IN THE SOFTWARE THAT YOU ARE ENTITLED TO.

2
 2. Installing GraphiCode Software for a Standalone Subscription

Delivery of your GraphiCode product will be via electronic download. Initially there is no
license file supplied as GraphiCode needs the information specific to your machine in order to
generate the license file. Once this information is determined, the license file will be sent
electronically.

Determining required license information

2.1 Extract the .zip file and right click on Setup.exe file and choose Run As Administrator.
The installation will begin.

2.2 The installer will begin preparing the operating system for software installation and
once this is complete you are presented with the Software License Agreement. After
reading the Agreement, click the appropriate button. You must accept the terms to
proceed with the installation. Select “I accept the terms of the license agreement” and
click “Next”.

2.3 You must now select the type of installation that you are performing. Select
“Subscription License” (if you have received your license file go to Step 2.4 below.

****For information on a network subscription installation please see Section 3.

****

The installer will generate an 8-digit code. (Example - 1a2b3c4d)

Click on the "Save as C:\gcsubcode.txt" button and email this saved file to
‘sales@graphicode.com’. You can exit the installer while waiting for a license file to
be generated and sent back to you.
Once you receive the license file as an e-mail attachment, open the e-mail and save
the file(s) to a temporary location on your computer’s hard drive and start the
installation again, skipping Step 2.3.

2.4 With the Subscription License option checked, specify the location of the license file.
The license file is called gcflex.lic. Then click” Next” and in the next dialog click
“Install”.
The next dialog defines the installation location for the software. GraphiCode strongly
recommends accepting the default location in Program Files as this allows different
versions of software to be present simultaneously and eliminates potential problems.
Click “Next”.

2.5 Select “Complete” and Click “Next”.

2.6 The next dialog reviews all the information entered. You are also given the option to
create a shortcut on the desktop. If all information appears correct then click “Install”.

2.7 The installation will now proceed with status updates being displayed until the Wizard
Completed dialog is displayed. Click “Finish”.

3
3. The Network (Floating) User Option

The setup for a floating license is as follows:

GraphiCode Flex Server

License file is located on this machine and is specific to this machine.
Machine can be physical or virtual
INSTALL FIRST

Shared Location of the gcflex.lic license.

This is a copy of the license file on the GraphiCode Flex Server

Client 1 Client 2 Client 3

GraphiCode has selected FLEXnet as our license management tool due to FLEXnet’s wide
industry acceptance and extensive experience with networking issues. There is a significant
chance that your network administrator is already familiar with FLEXnet.
Virtual Servers are supported. The MAC address used should be for the physical machine
hosting the virtual server.

GraphiCode Flex Server Network Requirements

 The TCP/IP protocol must be installed.

 A local (non-network) C drive must exist (This may be especially relevant for
European computers which may have E drive instead).

 The DLL, winsock.dll, must be installed.

 The Server and Clients should each have a static IP address.

4
 4. Installing the Network Server Option

Please email GraphiCode the MAC address of the physical machine being used
as the GraphiCode License Server. This is the case if you are also using virtual
machines; we still need the physical host machine MAC address.

4.1 Delivery of your GraphiCode License Server will be via electronic download. The MAC
address is required for the generation of the license file. Once the license file is
generated by GraphiCode it will be sent electronically. Copy the license file from the
email to a temporary directory on the server’s hard drive.

4.2 Extract the .zip file and double-click on setup.exe to start the software installer.

4.3 The “GraphiCode FLEX Server – InstallShield Wizard” should appear. Click “Next”.

4.4 The next dialog displays the Software License Agreement. After reading the agreement,
select the appropriate response. You must select “I accept the terms in the license
agreement” to continue. Click “Next”

4.5 The “Customer Information” dialog will appear. Enter the appropriate information and
click “Next”.

4.6 You will then be prompted for the GC Flex Server license file location. Navigate to the
location of the license file in section 4.1 above.

4.7 Now enter the server name or the server IP address in the Server Name field. The Port
Number is set to a default value and is fine unless you are running multiple FLEXnet
servers on your network. Click “Next”. The installer will make a copy of your license file
and modify it with the Server name/ IP address to make it specific to your server.

4.8 The next step is to define the shared location of the license that all of the clients will use
to run the application. WARNING! THIS LOCATION MUST BE CHOSEN CAREFULLY
AS THE FILE MUST BE ACCESSIBLE TO ANY AND ALL CLIENT MACHINES ON
WHICH GRAPHICODE PRODUCTS ARE TO BE INSTALLED. Click “Next”. A copy of
the modified license file is copied to this shared location.

4.9 Finally you will then be asked for the path to where you wish to install the GraphiCode
FLEX Server. The default path is strongly recommended (C:\GCFlexServer).

4.10 The installation will continue until the Wizard Completed dialog is displayed. Click “Finish”
and the reboot the server to effect the necessary changes.

4.11 After you have completed the server installation, there will be a program running on the
server (LMGRD.EXE) which handles the general network license management traffic.
There is another program running on the server called GCFLEX.EXE that handles the
GraphiCode specific requests handed to it by LMGRD. FLEXnet calls this helper program
a “vendor daemon”. If your network has other applications from other vendors using
FLEXnet network licensing, there will be other vendor daemons, but just the one LMGRD
service.

5
5. Installing the Network Client Option

NOTE: The Network server MUST be installed before installing the network clients.

Installing from a downloaded .zip file

5.1A Extract the .zip file and right click on Setup.exe file and choose Run As Administrator.
The installation will begin.

5.2 The installer will begin preparing the operating system for software installation and
once this is complete you are presented with the Software License Agreement. After
reading the Agreement, click the appropriate button. You must accept the terms to
proceed with the installation. Select “I accept the terms of the license agreement” and
click “Next”.

5.3 You must now select the type of installation that you are performing. Select “Network
User”.

The location of the license file is the Shared license location that was defined during
the GraphiCode Flex Server installation. Check with the person who installed the Flex
Server where this license file is located and point all clients to that license file.
Then click” Next”. There is a final reminder that the Flex Server software must be
installed prior to this installation, hit “Next” and in the next dialog click “Install”.

5.4 The next dialog defines the installation location for the software. GraphiCode strongly
recommends accepting the default location in Program Files as this allows different
versions of software to be present simultaneously and eliminates potential problems.
Click “Next”.

5.5 Select “Complete” and Click “Next”.

5.6 The next dialog reviews all the information entered. You are also given the option to
create a shortcut on the desktop. If all information appears correct then click “Install”.

5.7 The installation will now proceed with status updates being displayed until the Wizard
Completed dialog is displayed. Click “Finish”.

6. Troubleshooting and FAQs – Network User

FLEXNET Licensing Error:-15,578. System Error:10049: ”Winsock:Invalid

Address”

Problem:

This error is a general connection problem on the GC Flex Server between the service and
the host machine. This error is often reported on the client machine when the client attempts
to start the application but is usually addressed on the GC Flex Server.

6
 Solution:

There are number of potential causes for this error so go to the server machine running the
GC Flex Server and check the following in order to eliminate possible causes:

1. Go to the location C:\GCFlexserver\license and open the license file (gcflex.lic) with a text
editor. Make sure that the line in the license beginning SERVER (line 15 or so)
references the correct Servername or IP address of the server. In the same line check
that the port being used (the final number in the line and default of 27001) is not being
used by another service. Close the text editor.
2. Go to C:\GCFlexserver and locate the file LMTOOLS.EXE. Double click that program and
when the application starts go to the Config Services tab and use the Browse Buttons to
browse and reset the path the LMGRD.EXE (C:\GCFlexserver\lmgrd.exe) and the license
file (C:\GCFlexserver\license\gcflex.lic). Save the changes to the Service.
3. In the same ‘LMTools’ application go to the Start / Stop / Reread tab and click “Stop
Server”. Next, click “Start Server” and finally click Reread License File. This refreshes the
service.
4. Finally go to the Server Status tab and click “Perform Status Enquiry”. A report is
generated and scroll to the bottom. If the end of the report references the number of
licenses available and the number of license in use then the server is working; if the
report ends with the “Winsock : Invalid Address” message then try the following:

Firewall

Sometime the services are blocked from communicating by the firewall on the server.
Add exceptions to allow GCFLEX.EXE through the firewall (file is located in
C:\GCFlexserver folder) and also LMGRD.EXE (in the same directory).

If the problem still persists, contact your GraphiCode support provider.

GCFLEX: The desired vendor daemon is down or not responding

Problem:

This error reported by the client but is an issue on the GCFlexserver.

Solution:

1. Go to C:\GCFlexserver and locate the file LMTOOLS.EXE. Double click that program and
when the application starts go to the Config Services tab and use the Browse Buttons to
browse and reset the path the LMGRD.EXE (C:\GCFlexserver\lmgrd.exe) and the license
file (C:\GCFlexserver\license\gcflex.lic). Save the changes to the Service.
2. In the same LMTools application go to the Start / Stop / Reread tab and click “Stop
Server”. Next, click “Start Server” and finally click Reread License File. This refreshes the
service.
3. Finally go to the Server Status tab and click “Perform Status Enquiry”. A report is
generated and scroll to the bottom. If the end of the report references the number of
licenses available and the number of license in use then the server is working; if the
report ends with the “Winsock : Invalid Address” message then try the following:

Ports

Check that the port number specified in the license file (at the end of the line starting
SERVER) is available and not in use by another application..

7
FAQ: Where is my Shared license?

Problem:

How do I find my shared license location.

Solution:

On the client machine go to

C:\Program Files (x86)\GraphiCode\PowerPlatform x.y.z\<GC-ProductName>\license
and open the file gcflex.lic with a text editor. This is the path to the shared license.

FAQ: How do I update the license for my Network installation?

Problem:

If the client applications are updated to a newer version there may be new functionality
available that requires an updated license file to activate this functionality.

Solution:

1. Copy the license file to a temporary location and open the gcflex.lic file with a text editor.
2. Change the "your server name here" line in the new license file to match the name of
your host server (this name should match the Server name in the old license file).
3. Copy the new license file into the root GraphiCode Flex Server installation directory (e.g.
C:\GCFlexServer\license), and overwrite the existing license file.
4. Copy the new license file into the shared network license location (see FAQ above), and
overwrite the existing license file. Note: the shared license location could be the same
location as the root GraphiCode Flex Server Installation directory
(C:\GCFlexServer\license).
5. On the Server machine, go to: Start > Programs > GraphiCode Flex Server > LMTools
Server Diagnostics.
- From the main page of the LMTools Server Diagnostics application, click on the
Configuration Using Services option.
- Click on the Start/Stop/Reread tab and click Stop Server, then Start Server, then ReRead
License File (the bottom left corner of the dialog should report "Reread Server License
File Completed."
- Click on the Server Status tab, then click on Perform Status Enquiry and verify that the
Service and Vendor Daemon are both up and running, and that the license file is being
allocated.
6. Reinstall the GraphiCode product on the client PC(s) to properly update the application
and help files per the new license file.