Installation Guide Subscription Licenses

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: Solution: This error reported by the client but is an issue on the GCFlexserver. 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: Solution: How do I find my shared license location. 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: Solution: 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. 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. 8