Execu/Tech Systems, Inc.
Knowledgebase
Search:
850-747-0581EmailWebsite
Contents
 
IndexBookmarkPrint This Article

Home > Execu/Suite Hotel PMS > Execu/Suite Hotel PMS Setup > Installation > Software Installation > Software Installation - Client

Software Installation - Client

You must run "Register Programs and Controls" after installing a new client computer, server, software updates or changes to the server name or data location.  Register Programs and Controls

Installing at the client is nothing more than creating a shortcut    
Or, in a remote desktop environment, configuring the connection. 

There is no software to install, you're just creating a shortcut.

Each Windows user that needs access to the software should have a shortcut or Remote Desktop Connection. All users who run Execu/Suite will need to have full control of the Execu/Suite folder on the server. No other access to folders on the server is needed except in special, very rare circumstances. 

This is the basic layout of the typical client-server setup on a TCP/IP network. When finished, your shortcut properties will look similar to this. THIS IS ONLY AN EXAMPLE! Your shortcut will differ based on options described, below.



  These are common errors you'll get when you miss a step or type something wrong when making a shortcut:
cbl.out Program Missing
Start Program Missing

Sometimes your computer will lose its connection to the server and you might see the errors found here:
Missing or Broken Shortcut / Icon

If you assign a terminal number that's already in use, you will get this error:
Cannot Run More Than Once

Sometimes you'll select a terminal number that was previously used in another company. You might find that your ID and Password don't work. Try this:
Change Company Code

When installing Execu/Suite on the client, you have two options. The first, and most common, is to create a shortcut that runs the software from the server. The second is to use Microsoft Terminal Services and run the software via Remote Desktop. When using Remote Desktop, you have the option of using RemoteApp - Running as RemoteApp

   Before creating the shortcuts, there are two things you should know. Command Line Arguments and Terminal Numbers:

Command Line Arguments

Our software uses command line arguments to specify the menu structure and terminal number.
  • Your primary concern is the terminal number, explained below. 

  • When making a shortcut, you must enter both the "Target" and "Start in".

  • An example "Target" is: "\\server\share\wrun32.exe" -w -c wruncbl.fil START 01

  • An example "Start in" is: "\\server\share\"
Point Of Sale (POS)

There is an additional command line argument that can be added to an Execu/Suite Point of Sale shortcut that will auto login directly to the keyboard screen.
This command line argument it menu.aut 
It should be added after "start" and before the terminal number, like this:
C:\EXECUTECH\HotelTest\wrun32.exe -w -c wruncbl.fil start menu.aut 01 


   Terminal Numbers
  • The terminal number is a two digit number from 01 to 96 placed at the end of the shortcut.

  • With either method, each client must have a different terminal number specified in the shortcut.  

  • Terminal numbers 97, 98 and 99 are typically reserved for Execu/Tech support operations.

  • Execu/Tech does not maintain a list of each customer's terminal numbers. The customer numbers them and should make a note of what terminals are used and where.
Sometimes you need your terminal to access a City Ledger, General Ledger or Inventory batch that another terminal also accesses. We allow 8 separate batches at a time, based on the terminal number. Using this table, you can see that the first batch can be accessed by terminals 01, 09, 17, 25, etc. So, if you need access to the same batch that terminal 07 is using, you will need to use a terminal number in the same column. 

Look at the lower left area of your Execu/Tech screen. 
Note the Terminal number:



Find your Execu/Tech terminal number
01 02 03 04 05 06 07 08
09 10 11 12 13 14 15 16
17 18 19 20 21 22 23 24
25 26 27 28 29 30 31 32
33 34 35 36 37 38 39 40
41 42 43 44 45 46 47 48
49 50 51 52 53 54 55 56
57 58 59 60 61 62 63 64
65 66 67 68 69 70 71 72
73 74 75 76 77 78 79 80
81 82 83 84 85 86 87 88
89 90 91 92 93 94 95 96



The first option, creating a shortcut on the client.

DO NOT USE A MAPPED DRIVE! Use the UNC!

Follow this example to create a shortcut: Create Shortcut Manually

To assist with this first method, we provide a program called the Shortcut Wizard. This program will create a shortcut using a correct command line and will automatically register all ActiveX controls. If you’d rather not manually create the shortcut, use this program to create a desktop shortcut for you.

Using the shortcut Wizard.

Watch this video on using the wizard: ETShortcutWizard

From the client computer, browse to the server’s shared folder containing the Execu/Suite software and look for the program ‘ETShortcutWizard.exe’ and run it.To successfully run the Shortcut Wizard you must right click the application and choose “Run as Adminstrator.”

  1. Right click the application and choose “Run as Adminstrator.”


  2. Select the appropriate options then click, "Create Shortcut."


  3. Did you see a "Run-time error"? If you did then you either failed to perform step 1 or you do not have administrator permissions. Follow step 1 then call your IT to determine if you have administrator permissions.
    ET Shortcut Wizard
    Run-time error '-2147024891 (80070005)':
    Unable to save shortcut "C:\Users\Public\Desktop\HOTEL User 05.lnk".

 This window will be unresponsive as long as the bottom status bar is blinking red and white with the message, “Loading user control data. This may take a couple minutes so be patient.” It’s compiling a list of all ActiveX controls and DLLs that need to be registered. When it’s done you’ll see the status bar remain white with the message, “Control data loaded. Verify folder and terminal number and proceed." At this point, you’ll also notice that the ‘Create Shortcut’ button has appeared. A window will appear with several options. Since the program was run from the Execu/Suite folder, you don’t have to locate the folder, that field will already be filled with the correct folder.  To create a shortcut for Execu/Suite, you simply need to select your desired terminal number then click the ‘Create Shortcut’ button. You won’t be notified if your selected terminal number is already in use, so be sure you’re selecting the correct terminal number to avoid any confusion or security warnings when running Execu/Suite.


The second option, Terminal Services and Remote Desktop. This is the responsibility of your IT professional.

When using Remote Desktop, you have the option of using RemoteApp - 
Running as RemoteApp. 

 In Remote Desktop, you may find that USB barcode scanners and magnetic card swipes do not seem to work properly. 90% of the time the solution is a simple change to the Remote Desktop Connection settings. Open Remote Desktop Connection then click Options. Go to the Local Resources tab and change the Keyboard setting to 'On the remote computer'. You'll have to successfully connect to the server after making this change for it to be saved. 

The Execu/Suite is best run using the ‘Environment’ tab of the user in ‘Active Directory Users and Computers’. Rather than placing the command line in ‘Target:’, you’ll place it in ‘Program file name’. If your server and Terminal Services server aren’t the same machine, be sure to use the UNC, just like in the first option. Otherwise, you should use the drive letter, just like in the example image. Using the UNC when the software is installed locally will cause severe performance issues.



  Failure to configure this setting can leave files locked that may prevent other users from running the software. They may experience errors caused by the locked files that can't be resolved until the disconnected sessions are ended.

Make sure that the disconnected session settings are set in accordance to the needs of the property. You may want to be able to reconnect to a session after a few minutes if you experience frequent disconnects. You also want to make sure that a disconnected session doesn’t remain in that state indefinitely, causing the number of available users to be reduced by one even though the session isn’t in use.  

Setting an appropriate duration to ‘End a disconnected session’  can give the user time to reconnect if needed but allow the count of active users to be accurate if you’re unable to reconnect and close Execu/Suite, properly. We find that 5 minutes is a good setting. This can be set at the server level or user level, whichever your IT prefers.




  Remote Desktop Printers

If you have a lot of terminals, it's important that the printers for each terminal are not published into the list of printers that all other terminals will see. This can create huge delays when the the software needs to display a printer dialog and can make printer selection confusing for the users.

It's also important that printers that will be used in Point of Sale be static printers and not "session" or "redirected" printers. 


You must run "Register Programs and Controls" after installing a new client computer, server, software updates or changes to the server name or data location.  Register Programs and Controls






Article ID
 software_installation___client
Views
 3449
Last Modified
 5/19/2017 11:48 AM