Software Quick Start Guide

Transcription

1 Software Quick Start Guide pcastructurepoint 5420 Old Orchard Road Skokie, IL PH FX QS /15/2006

2

3 Table of Contents Software Quick Start Guide 1 Table of Contents i Network License Quick Start Guide 1 Network Licensing Concepts...1 System Requirements...1 Operating Systems...1 Minimum Requirements...1 Network Requirements...2 License Server and Client Installation...2 Step 1: Installing License Serve Software...2 Step 2: Obtaining Locking Code off License Server...2 Step 3: Obtaining License Code...3 Step 4: Configuring License Server...5 Step 5: Configuring Client Applications...6 Troubleshooting Problem: Error [19] when adding license Problem: Client computer cannot find license server Problem: License server does not run Problem: License server configuration described in Step 4 above does not work Standalone License Quick Start Guide 12 System Requirements...12 Operating systems...12 Recommended Options...12 Program Installation...12 Installation Procedures...12 Purchasing and Licensing Process...19 Online Activation Using the Web...20 Activation by Phone...23 Activation by Running the Program...25 Uninstalling the Program...25 Troubleshooting Problem: Error [17] while installing license i

4

5 Network License Quick Start Guide Network Licensing Concepts A Standalone License permits the use of applications on a single computer. License management is done on that computer and every single installed application requires a separate license code. Network Licensing is more flexible than Standalone Licensing. It allows you to designate one PC or server to run the Network License Server a lightweight service that runs in the background and requires a license code. The number of available licenses (also known as seats) is encoded in this license code required only for the server. Applications communicate with a license server during startup to acquire a license. If no license is available, applications can search for open seats on other servers. IMPORTANT: For Network License Server, please select a PC that is stable and is always available on the network. It can be any PC, but Laptops or Notebooks are not recommended. An operating system of Windows NT or later (2000, XP, 2003 Server) is recommended due to its support for Windows Services. The client applications (i.e. pcacolumn, pcaslab, etc.) can be installed on any PC on the network. Commuter license is an embedded feature of network license. System Requirements Operating Systems Figure 1: Network Licensing Typical Configuration Windows NT4 / 2000 / XP / 2003 Server (recommended) Windows 98 2nd Edition / ME (not recommended) Minimum Requirements 100 MHz processor 32 MB of RAM memory 50 MB of free hard disk space for program installation 1

6 Network License Quick Start Guide Network Requirements Local Area Network (LAN) supports TCP/IP or IPX protocol. License Server and Client Installation IMPORTANT: Applications require Rainbow SentinelLM or higher. If you already have SentinelLM or higher running on your designated server for other applications, you can skip step 1 and go directly to step 2. If you have SentinelLM or prior on your server, then you either have to migrate existing licenses to SentinelLM or you have to select another PC to run SentinelLM Only one version of SentinelLM can run on one server. Step 1: Installing License Serve Software 1.1. Login as Administrator on your designated Server PC If you have the CD, place it in the CD-ROM drive. Open Windows Explorer to browse CD-Drive:\License_Server directory. If you do not have the CD, download file from Double click on the License_Server.exe. This is SentinelLM Follow the steps in Installation Wizard and install the license server. Do not change the default installation paths. This documentation will refer to them. Step 2: Obtaining Locking Code off License Server 2.1. Start Windows Explorer and go to the directory containing SentinelLM applications (C:\Program Files\Rainbow Technologies\Admin\Admin.net\Win32\) Double click on wechoid.exe The dialog box (Figure 2) will show up. Uncheck everything except Disk ID Write down the Locking Code at the bottom of the dialog box. For example, the Locking Code on Figure 2 is 4-123AB (yours may be different). Also write down the IP Address or Host Name of the server for later use. 2

7 Network License Quick Start Guide Figure 2: System Info Dialog Box Step 3: Obtaining License Code 3.1. Visit the online license generation page. Click on the link below or type it into the address bar of your internet browser, then press Enter key. The URL to this web page is On the first page (Figure 3), select the software to be licensed from the Please Select a Product drop-down list, and then select the I d like to get license code for my network version. radio button. Press Next button to go to the next step. Figure 3: Online License Generation Step On the second page (Figure 4), enter order number, serial number, and locking code. If you are not sure where to find them, press the Example links to see examples. Press the Request License Code button to go to the next step. 3

8 Network License Quick Start Guide Figure 4: Online License Generation Step On the third page (Figure 5), enter address of the license requester. The domain name of this address must be the same as the domain name of the purchaser s address. Optionally, the license code will be sent to any valid address provided in the CC field. Press the Generate License Code button to generate and see the license code Your license code will be shown on the next screen and sent to the requester s address (as well as to the CC address, if provided). If you have any difficulties to generate the license online, please send an to licensing@pcastructurepoint.com with the following information: Order Number (e.g ) Serial Number (e.g ) Locking Code (e.g AB) Product Name (e.g. pcacolumn) Number of seats purchased (e.g. 3) Full Contact Info (Your Name, Company Name, Address, Phone Number) We will then process your request and you back the License Code. 4

9 Network License Quick Start Guide Figure 5: Online License Generation Step 3 Step 4: Configuring License Server 4.1. Run WlmAdmin.exe tool. This utility is by default installed in the C:\Program Files\Rainbow Technologies\Admin\Admin.NET\Win32 folder. Open proper folder if SentinelLM is not installed in the default folder. Figure 6: WlmAdmin before license installation 4.2. On the left pane of WlmAdmin window (Figure 6), click on the + sign in front of the Subnet Servers, and then click on the + sign in front of the name of the server (e.g. SentinelLM-Server). If any features are already installed, they will be listed under the server name, otherwise, nothing is listed Right click on the server name, select Add Feature / From a String from the pop up menu (Figure 7). 5

10 Network License Quick Start Guide Figure 7: Right click on the server name to show this pop up menu 4.4. On the Add Feature to Server dialog box (Figure 8), check the Add feature to server s file check box. Copy the license code for one PCA product (e.g. pcaslab) from the license code , and then paste it into the License code text box. Leave the Distribution criteria text box empty. Press Add button to continue. If you receive an error message after pressing the Add button, refer to the Troubleshooting section at the end of this guide. Figure 8: Check the check box and copy/paste license code 4.5. Repeat step 3 and 4 to add all the PCA software features one by one. After you are finished, all the features should be listed under the server name (Figure 9). The server has been configured successfully. Please note that the license version and your software version do not need to match exactly. This allows free updates to be installed without obtaining new license codes. Figure 9: All the features are installed successfully Step 5: Configuring Client Applications IMPORTANT: This step has to be repeated on every single client PC that will run PCA applications (i.e. pcacolumn, pcaslab, etc.) Login as Administrator on the client PC. 6

11 Network License Quick Start Guide 5.2. Refer to product specific Quick Start Guide to install the application software on the client PC. If you do not have the CD, visit to download the latest version and install it. Quick Start Guides are also available on our website. IMPORTANT: If you purchased and installed the software before October 1, 2003, you may have a version that is not compatible with the network license server. Please visit to download the latest version and install it On the client PC, open Windows Explorer and go to client application directory (e.g. C:\Program Files\PCA\pcaColumn\) Use a text editor (e.g. Notepad) to open a file named lshost.txt in this client application directory. Delete any text that may be present (e.g. no-net), and type in the license server IP address in the first line. For example, if the Network License Server is running on a PC with an IP address of , just type in in the first line. Save and close this file. TIP: You may enter multiple IP addresses (each in a separate line) in the lshost.txt file to specify redundant license servers. This will force the application to search for an available license seat starting from the server specified in the first line and subsequently moving to the next specified server if there is no license available on the current server. Also, if you prefer that applications detect license server automatically, you can use LAN keyword in a single line in the lshost.txt file. Since the applications use broadcast method to detect server, startup time is longer in this approach. Please note that the broadcasting is performed only in the subnet where client computer is located. If client computer and license server are located in different subnets, server IP address must be used. The configuration is complete. Now you are ready to use the application. Congratulations! Troubleshooting 1. Problem: Error [19] when adding license. SentinelLM: Error [19]: Failed to add license code a. The license code copied is incorrect or incomplete. Make sure you copy and paste the proper and the whole license code from license , and then try again. If error persists, follow the alternative procedures in Problem 4 to add features manually. 7

12 Network License Quick Start Guide Figure 10: Determine License Server Status Using WlmAdmin.exe 2. Problem: Client computer cannot find license server. a. Make sure the license server is running properly (Figure 10). b. Open Windows Explorer, and then go to PCA software folder. For example, the default path for pcacolumn is C:\Program Files\PCA\pcaColumn\. Double click to open lshost.txt. Make sure the IP address of the license server is in this file. Please use IP address rather than server name because occasionally server name does not work. If this file is empty, the client (e.g. pcacolumn) will try to locate the license server by broadcasting in the same subnet. If the license server and client are in different subnet, IP address of the license server must be in the lshost.txt file on the client computer. 3. Problem: License server does not run. a. Make sure license code is applied to the computer from which the locking code is extracted. License code and locking code must match on a particular computer. Please follow Step 2 Obtaining Locking Code off License Server to double check the locking code, and compare it to the locking code in the sent to you by pcastructurepoint. b. If the license server computer is running Windows XP with Service Pack 2 or Windows 2003 Server, an exception must be set up in Windows Firewall. Open Control Panel and check the status of the 8

13 Network License Quick Start Guide Windows firewall. If the status is On (recommended), add an exception for UDP port 5093 (Figure 11). Open this port if it is blocked by any other active firewall software running on the server. Figure 11: Windows Firewall c. Open Windows Explorer and go to the folder where lservrc file is located. The default path to this file is C:\Program Files\Rainbow Technologies\SentinelLM Server\English\. Make sure the first character of the file name is l (for library), not I (for International) or 1 (one). d. If you have multiple license codes in lservrc file, make sure there is only one license code per line. If you need to append a new license code to an existing lservrc file, make sure the new license code is put in a new line. You may need to uncheck Word Wrap in notepad as shown in Figure 12. Figure 12: Uncheck Word Wrap in Notepad 9

14 Network License Quick Start Guide e. The lservrc file must NOT have any extension. It is a common mistake that a.txt is appended to this name. By default, Windows Explorer hides all the known extensions including.txt. To turn off this feature of Windows Explorer, click on Folder Options in the Tools menu, select View tab, and uncheck Hide extensions for known file types as shown in Figure 13. Figure 13: Show Extensions for Known Types in Windows Explorer f. The service SentinelLM must be restarted (or simply reboot the server) after license code is entered into lservrc file. For other network license related issues, please refer to the FAQ Network License section on our website ( 4. Problem: License server configuration described in Step 4 above does not work. If the license server configuration described in Step 4: Configure the License Server does not work, alternatively you may follow the steps below to add features to your server. a. Open Windows Explorer and go to directory containing the license file (C:\Program Files\Rainbow Technologies\SentinelLM Server\English\). b. If a file named LSERVRC (or lservrc in lowercase) does not exist in this directory, use a text editor (e.g. Notepad) to create one. Copy and paste the License Code that you have received from pcastructurepoint into this file. Make sure that there is only one license code per line. Save and close this file. 10

15 Network License Quick Start Guide IMPORTANT: Make sure that file name is exactly LSERVRC without any extensions. Otherwise licenses will not work. By default, Notepad adds a.txt extension. Please remove this extension using Windows Explorer. c. Restart the license server. For Windows NT or later: Go to Start/Control Panel/Administrative Tools, then Services. SentinelLM license server should be listed there. Select it and start the license server by clicking on start. If it is already running, restart it by clicking on RESTART. For Win 9x: If license server is running, a separate window will display with the message License Server Running. Close this window to stop the license server. Open Windows Explorer and go to directory C:\Program Files\Rainbow Technologies \SentinelLM Server\ English\. Double click on lserv9x.exe to restart the License Server. d. Verify the licenses by running application WlmAdmin.exe (located in C:\Program Files\Rainbow Technologies\Admin\Admin.net\Win32). All available licenses will be shown in this application (Figure 10). In the top left corner, expand the Subnet Servers by pressing the +. Your server s name should be visible there. Expand the server name. All the available licenses should be listed there. 11

16 IMPORTANT: These steps are for standalone license only. If you are installing a network license, please read chapter Network License Quick Start Guide. This guide applies to pcacolumn, pcaslab, pcabeam, pcamats, and pcawall since the installations steps are identical. The following guide uses pcacolumn as an example. For installation of pcaframe please download installation Quick Start Guide from System Requirements Operating systems Windows 98 Second Edition or higher Minimum Requirements 100 MHz processor 32 MB of RAM memory 50 MB of free hard disk space for program installation Recommended Options Most recent operating system service pack installed Program Installation Installation Procedures 1. If you have the installation disk please insert it into the CD drive and proceed to step 2. If you do not have the installation disk but downloaded the installation file from our website, please run the file and proceed to step If the auto-run functionality of Windows is enabled on your computer (which is the default setting) and a web browser (Internet Explorer, Netscape, etc.) is installed, the start page (Figure 14) is shown automatically. If the start page does not show up automatically, please go to step 7. 12

17 Figure 14: Start Page 3. If you are going to evaluate PCA software, please click the Evaluation Software License Agreement link and read through the agreement carefully. If you are going to use a commercial copy of PCA software, please click the Software License Agreement link and read through the agreement carefully. 4. Click to start the installation. A second page will be shown as in Figure 15. Figure 15: Second Installation Page 5. Click the Install the program, then a dialog box will be shown as in Figure

18 Figure 16: Click Open to Continue 6. Click the button on Figure 16 to continue and proceed directly to step 11 below. Press Yes or Run button if you see any security warning messages. 7. If the start page doesn t show up automatically, open the Windows Explorer by following Start/Programs/Accessories/Windows Explorer in Windows 95, 98, ME, NT, 2000 or Start/All Programs/Accessories/Windows Explorer in Windows XP/2003 Server. You may also start the Windows Explorer by pressing the short cut of + E. A window similar to Figure 17 appears. Figure 17: Windows Explorer 8. Select the CD drive from the left pane of Windows Explorer (e.g. E drive in Figure 17). 9. Select the pcacolumn folder from the left pane. The contents of this folder are shown in the right pane. 10. Double click the install.exe in the right pane of the Windows Explorer. 11. The installation process starts by displaying the following window (Figure 18). Please read all the information. Then press the button. This will continue the installation process by installing the application software and an evaluation license. 14

19 Figure 18: Beginning of the installation 12. The first step of the application installation process is to review the information on the software and the copyrights announcement as shown in Figure 19. Please read all the information carefully. Press the button to confirm that you have read and agreed with it. This will continue the installation. If you do not agree with the license agreement, press the button. This will stop the installation. Figure 19: Copyright announcement 13. Read the Readme file (Figure 20), and then press to continue. 15

20 Figure 20: Readme File 14. Enter the Registration Information (User Name and Company Name) as shown in Figure 21. Press the button to go to the next step. Figure 21: Registration Information 15. If you continue the installation then the next setup is to decide the directory where pcacolumn is to be installed as shown in Figure 22. The default directory is C:\Program Files\PCA\pcaColumn. You may press the button to locate the directory. If the directory does not exist, the setup program will create it. Press the button to go to the next step. 16

21 Figure 22: Choose Destination Location 16. Enter the group name as shown in Figure 23.Windows will use this name in the Start/Programs menu. Press the button to go to the next step. Figure 23: Select Program Manager Group 17. Press the button as shown in Figure 24 to start the installation. 17

22 Figure 24: Start Installation 18. During the installation a window as in Figure 25 shows the progress as files are copied to your hard drive. Figure 25: Installation progress 19. After the installation is completed, a dialog box similar to Figure 26 is shown. Press the button to finish the installation. 18

23 Figure 26: Installation Complete Purchasing and Licensing Process IMPORTANT: The following information is for standalone license only. For network licensing please refer to the chapter Network License Quick Start Guide. This is the default mode of the license. In this licensing scheme, users are granted 15 days to use our full-featured software evaluation mode. The only visible difference between the evaluation version and the licensed version is an additional start-up dialog box shown in Figure 27. It gives a choice of buying/licensing the software, entering the activation code or running the application in the evaluation mode by pressing the button. When the evaluation period expires the user will either obtain a License, or uninstall the application. Note: Any tampering with system clock or evaluation license file will render the software useless. Figure 27: Start-up Dialog Box 19

24 You may purchase the license online on our web site at or by calling our Sales Team at To buy online you may press Online Licensing button, which will direct you to our website where you will be able to complete the transaction. After the purchase is completed, pcastructurepoint will generate a unique License Code based on the product ID and the locking code derived from the unique hardware-id of the user s computer. This implies that the License Code will not work on any other PC. You can transfer the license to another PC by contacting pcastructurepoint for the transfer fees and procedures. There are 3 ways you can obtain a license code: Online, , or Phone. Online Activation Using the Web You will need your purchase order number, product serial number, and the locking code. The first two are found in the recap sent to you by pcastructurepoint. 1. Obtaining Locking Code Press the button in the start-up dialog box (Figure 27). This will bring up a window as in Figure 28, which shows three license activation methods. Figure 28: License activation methods Select Enter a License Code and then press the button. A window (Figure 29) will pop up where you will be able to see the Locking Code (4-2412B in example Figure 29). Please note that your locking code may be different. Write down the locking code and press back twice to return to Figure 27 20

25 Figure 29: Enter license code 2. License Code Generation Press the Online Licensing button in the start-up dialog box (Figure 27). This will open up a browser and direct you to the pcastructurepoint website (Step1, Figure 30). Please select the 2nd option and press Next. Then you will be prompted to enter purchase order number, serial number, and locking code (Step 2, Figure 30). Please enter these numbers carefully. Then you will be prompted for a valid address (Step 3, Figure 30).The domain name in the must match the one in the purchase order. Once you have successfully generated license code, please copy and paste it to the License Code section of activation window (Figure 29). Then press Next. 21

26 Figure 30: Online Licensing If the entered code is correct the license will be activated and window as in Figure 31 will show. When you press the button the license activation will be completed. Please note that the license version and your software version do not need to match exactly. This allows free updates to be installed without obtaining new license codes. 22

27 Figure 31: Activation completion Activation by Phone If the telephone method was chosen to activate the license the following screen appears (Figure 32). It shows the product ID and the Locking Code. This information is needed when you make a phone call at (HELP) to obtain the license. You will be asked to provide information about yourself in order to verify that you have purchased the license. Figure 32: Activation by phone When your information is verified, the license code will be generated and provided to you by an . When you receive the code type it or copy-paste it in the License Code text box and press the button. If the entered code is correct, the license will be activated and window as in Figure 31 will show. When you press the button the license activation will be completed. 23

28 Activation by If the method was chosen to activate the license a screen (Figure 33) will show prompting you to provide information about yourself. When you type in all the information press the button and it will be automatically ed to us together with the product ID and the Locking Code. After the information is verified the license code will be generated and ed back to you. Figure 33: Activation by After you receive it you may enter it by pressing the button in the start up dialog box (Figure 27) and choosing Enter License Code option. If the entered code is correct, the license will be activated and window as in Figure 31 will show up. When you press the button the license activation will be completed. 24

29 Running the Program 1. In Windows 95, 98, NT, 2000 select the button from the lower left corner of the screen then follow the path of Programs/PCA Programs/pcaColumn/. 2. In Windows XP, 2003 Server, select the button from the lower left corner of the screen then follow the path of All Programs/PCA Programs/pcaColumn/. 3. Select pcacolumn. Uninstalling the Program 1. In Windows 95, 98, NT, 2000 select the button from the lower left corner of the screen then follow the path of Programs/PCA Programs/pcaColumn/. 2. In Windows XP, 2003 Server, select the button from the lower left corner of the screen then follow the path of All Programs/PCA Programs/pcaColumn/. 3. Select Uninstall pcacolumn. 4. Follow the steps shown by the un-installation wizard to remove the program. 25

30 Troubleshooting 1. Problem: Error [17] while installing license. To add a standalone license, set the environment variable LSFORCEHOST to no-net. To add an environment variable, follow the steps below (assuming Windows XP). a. Open Windows Control Panel, and then double click on System. b. Click on the Advanced tab on the System Properties box (Figure 34), and then press the Environment Variables button. Figure 34: System Properties box c. In the System Variables group box (Figure 35), look for a variable named LSFORCEHOST. If the variable exists, press the Edit button, and then change the Value to no-net. If the variable does not exist, press the New button. 26

31 Figure 35: Environment Variables box d. On the New System Variable dialog box (Figure 36), enter the variable name and value as shown below, and then press the OK button. Figure 36: New System Variable box e. Press the OK button on the Environment Variables dialog box. Depending on the operation system, the computer may be required to reboot in order for the new environment variable to be effective. 27