Step 2. Install Version 1 of Web Employee Application

1.  The installer must be able to update the SQL Server database.

     For Windows 7, your user profile must be in the Administrator group. You can then install by double clicking on the MSI file.

     For Windows 8 or 10, start a Command Prompt using Run as Administrator.

     Position to the folder: C:\Program Files (x86)\LANSA\x_win95\x_lansa\x_apps\WEBAPP.

2.  Enter the following command and then press the Tab key.
msiexec.exe /I WE

     The MSI file name will be completed for you. Your command should now look like this:
Msiexec.exe /I WEBAPP_V1.0.0_en-us.msi

     Press Enter. The Windows Setup dialog will be displayed:


3.  Click Next to continue.

4.  The End User Licence Agreement dialog will be displayed:

a.  An example license file is supplied in folder:

 .    You should edit or replace this file to implement your company licensing terms if necessary.

b.  Select the "I accept …." Check box and click Next to continue.

5.  You can now select the Installation Scope. Select "Install for all users of this machine". This would always be the requirement for a web application, which in practice would be installed to a Windows server machine.

     Both options will be shown in Windows 7 provided the installer is an Administrator and in Windows 8, provided the installation was started from a Command Prompt using Run as Administrator.

6.  Click Next to continue. The Destination folder dialog will be shown:

     The Change button allows an alternative folder to be selected.

     Note: The suggested path includes Company Name and Application Name:
. . . \II Web Systems\Employee Web Application

7.  The DBMS Type to be used is displayed.

     If other DBMS software is installed, this setting could be changed. This should normally be the case.

     Click Next to continue.

8.  The database settings you defined in Package Maintenance are then displayed.

     Ensure that the User field is blank. If User ID and Password are entered, the install will assume the database settings require a secure login. Your install is using a database that uses Windows security.

     The Setup Database check box must be checked. This installation is defining a new database.

     An ODBC DSN entry will be created, named WEBAPP, pointing to the database server and database name defined in the package.

     The XVLWAPP template settings always show these settings.

9.  The User ID settings for the user id with rights to execute the web application are displayed:

     You have the option to Create a New User or Use Existing User. The user must belong to groups:

     Enter suitable values and click Next to continue:

10. The install will define a local web site in IIS. A suitable Port number will be generated. LANSA uses port numbers starting from 8081.

     Click Next to continue.

11. The LANSA Communications Port number setting is displayed. This contains a default value of 4550, ensure that the value is the one determined in the package settings. 4547 was the suggested value.

     Click Next to continue.

12. The Choose Setup Type dialog is displayed.

     Click Typical to continue.

     Note: Currently, all setup types install the complete package.

13. The "Ready to Install …" dialog is displayed, displaying the main install settings. At this stage, you could use the Back button to return to previous settings and change these if necessary.

     Click Install to continue.

14. The Setup Wizard will install the LANSA web application, showing a progress bar.

15. Once the install is complete, the following dialog is displayed.

16. Click Finish to continue which will run the LANSA Server Licence application.

Your Visual LANSA development system has a USB dongle or softkey licence which supports execution of a web application. You have installed an independent LANSA system which must be separately licenced with server licence. A License can be obtained from your LANSA vendor. See LANSA Support web site for more details on product licensing.

17. This step assumes that you do not have a web runtime server license (License code PWB) for your PC.

     Select the Add Licenses tab. Use the Generate CPU file button to run the X_CPU Utility.

     A licence request file must be generated, in order to request a web runtime licence, using the X_CPU utility. This generates a unique value for your machine.

     The X_CPU utility uses a network card in your machine as part of the unique identifier which it generates. Usually a command prompt will be displayed, as shown, because your PC has more than one network connection. Always select the hardware Ethernet card, Option 1 in this example, and press Enter.

     The following message box will be displayed. Email the X_CPU file to your LANSA vendor and request a temporary Web runtime licence (licence code PWB).

18. The license will be supplied via email, as an attached XML file, which must be loaded using the Server Licensing program. Save the license file to any convenient folder.

     Start the server licensing form as follows:

a.  Start a Command Prompt using Run as Adminstrator.

b.  Navigate to the deployed system "execute" folder. For example:
c:\Program Files (x86)\II Web Systems\Employee Web Application\x_win95\x_lansa\execute

c.  Launch the license form as follows:
x_run proc=*licenses

     Your form will have no existing licenses shown on the Applied tab.

d.  Select the Add Licenses tab.

     Use the ellipsis button in the Load Server License Codes from edit box, to navigate to the folder containing the XML license file.

e.  Select the license file and click Open.

f.  Select the new license and click the Apply Selected button.

g.  Select the Applied tab, where the license should be shown as Status = Valid.