Difference between revisions of "Old GXtest Installation guide"

From GXtest Wiki
Jump to: navigation, search
m (GXtest Executor Installation)
 
(24 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[categoría:Installation Guides]]
+
{{Idiomas| Antigua guía de Instalación| Old GXtest Installation guide}}
 +
[[category:Installation Guides]]
 +
 
 +
 
 +
This Installation Guide is for GXtest 1.1.7 and older versions.
 +
 
  
 
The various components to install are listed below:
 
The various components to install are listed below:
 
* GXtest Designer and GXtest Recorder to create and edit Test Cases
 
* GXtest Designer and GXtest Recorder to create and edit Test Cases
* GXtest Manager (GXtest Daemon and GXtest Executors included) to schedule the tests to execute
+
* GXtest Manager (GXtest Daemon and GXtest Executors included) to schedule the tests to be executed
 
* GXtest Extension, useful to export the GeneXus KB (X, Ev1 or upper)
 
* GXtest Extension, useful to export the GeneXus KB (X, Ev1 or upper)
  
GXtest Designer has to be installed on machines where users want to model the test cases. It is a single-user component that connects to its own database and then the Manager database, so it must be on the same LAN.
+
GXtest Designer has to be installed on machines where users want to model the test cases. If you install this component alone (without GXtest Manager), users will be able to create and execute test cases, but they will can't schedulle and execute tests until GXtest Manager is installed.
  
Additionally, where installing a GXtest Designer you need to install GXtest Recorder to record test cases from Internet Explorer.
+
Additionally, where installing a GXtest Designer you need to install a GXtest Recorder to record test cases from Internet Explorer.
  
The component GXtest Recorder can be installed without the GXtest Designer, in order to record test cases and save them as compressed XML files that can be sent after to the user who is using GXtest Designer, to import and use them in any project.
+
The component GXtest Recorder can be installed without the GXtest Designer, in order to record test cases and save them as compressed XML files that can be sent afterwards to the user who is using GXtest Designer. This user then will be able to import and use them in any project.
  
The GXtest Manager is installed as Web application in a .NET environment. It can be remotely accessed by different users. At the same server (not necessarily) GXtest Daemon component must be running, which checks if there are scheduled tasks ready to execute, and makes them execute in the indicated  machine (in the GXtest Executor component).
+
GXtest Manager is installed as a Web application in a .NET environment. It can be remotely accessed by different users. At the same server (not necessarily) the GXtest Daemon component must be running. This component checks if there are scheduled tasks ready to be executed, and makes them execute in the machine specified in the GXtest Executor component.
  
So there can be several GXtest Executor where tests are run effectively. They must also have access to the GXtest Manager database. Because they are the ones who run the test cases, they must also have access to the application under test.
+
As a result, there can be several GXtest Executors where tests are ran effectively. They must have access to both the GXtest Manager database and to the application under test (across http).
  
 
== Prerequisites ==
 
== Prerequisites ==
You must have SQLServer 2005/2008. If you don't have SQLServer 2005/2008 installed you can find a version (Express) for free download [http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=31711d5d-725c-4afa-9d65-e4465cdff1e7 here].
+
You must have SQLServer 2005/2008. If you don't have SQLServer 2005/2008 installed you can find the Express version for free download [http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=31711d5d-725c-4afa-9d65-e4465cdff1e7 here].
  
GXtest works on Windows XP® (SP2), Windows Vista® and Windows 7® operating systems, with Internet Explorer® version 6, 7 and 8. No special hardware requirements are defined to run this applicative.
+
GXtest works on Windows XP® (SP2), Windows Vista® and Windows 7® operating systems, with Internet Explorer® version 6, 7 and 8. It is necessary to have the .Net Framework already installed.
  
It is also necessary for the execution of GXtest Manager the IIS web server - Internet Information Services, which is packaged as a Windows component.
+
No special hardware requirements are defined to run this application.
 +
 
 +
It is also necessary for the execution of GXtest Manager to have installed the IIS web server - Internet Information Services, which is packaged as a Windows component.
  
 
== Installation (step by step) ==
 
== Installation (step by step) ==
GXtest has an installer which shows the various components to install. You must first select what you want to install and then each component is configured via a Wizard.
+
GXtest has an installer which shows the various components components that can be installed. You must first select which components you want to install and then each component is configured via a Wizard.
  
 
<br><br> [[image:instaladorUnificado.JPG|center]]<br><br>
 
<br><br> [[image:instaladorUnificado.JPG|center]]<br><br>
  
'''Typical installation''': you might have a PC (or server) to install a GXtest Manager and with one GXtest Executor to run unattended tests there, and in a Tester's PC would be installed GXtest Designer and Recorder. <br>
+
'''Typical installation''': The typical installation consists of having a PC (or server) with the GXtest Manager and with one GXtest Executor to run unattended tests, and a Tester's PC with the GXtest Designer and Recorder. <br>
Then, in the server PC, you would select only GXtest Manager and Executor in the GXtest installer. Then in the Tester's PC you would run the same GXtest installer selecting only GXtest Designer and Recorder components.
+
Then, in order to achieve this configuration in the server PC, you would only select GXtest Manager and Executor in the GXtest installer and in the Tester's PC you would run the same GXtest installer selecting only GXtest Designer and Recorder components.
  
We recommend first installing the server side and then the "clients" or testers. In turn, consider GXtest Designer can work "offline" of GXtest Manager, working in a local database. It is recommended for simplicity to work from the different GXtest Designer installed on the same GXtest Manager database.
+
We recommend first installing the server side and then the "clients" or testers. In turn, consider GXtest Designer can work "offline" of GXtest Manager, in a local database. However, it is recommended for simplicity to work from the GXtest Designer installed on the same GXtest Manager database.
  
* Note: The installation will be done in the C: drive if you want to install on another drive you need to run one by one the MSI attached to installer. The Manager is installed in the directory of the Internet Information Server.
+
* Note: The installation will be done in the C: drive so if you want to install on another drive you need to run one by one the MSI attached to the installer. The Manager is installed in the directory of the Internet Information Server.
  
  
== GXtest Manager Installation ==
+
=== GXtest Manager Installation ===
If you selected to start installing GXtest Manager will run a simple wizard for installation.
+
If you select to start installing the GXtest Manager, then a simple wizard will run for installation.
  
# First, the installer displays the welcome. Press "Next". <br><br>[[image:GXTMInstalador_2.png]]<br><br>
+
# First, the installer displays the welcome window. Press "Next". <br><br>[[image:GXTMInstalador_2.png|center]]<br><br>
# Then the installer let you choose the virtual directory where the web application is going to be installed. If the installation is being done in Windows Vista, Windows 7, you may also specify the Application Pool desired. In this combo select the "Classic. NET AppPool" and then click "Next".
+
# Then the installer lets you choose the virtual directory where the web application is going to be installed. If the installation is being done in Windows Vista, Windows 7, you may also specify the Application Pool desired. In this combo select the "Classic. NET AppPool" and then click "Next".
# Pressing the "Next" button will display the product license. It is important to read it before accepting it. Should agree with the terms, select "I Agree" then "Next" button. Check again after the installation by pressing "Next".
+
# Pressing the "Next" button will display the product license. It is important to read it before accepting it. Should you agree with the terms, select "I Agree" and then press the "Next" button. Check again after the installation by pressing "Next".
# It displays a progress bar and then the following window will be displayed, where you must enter the SQLServer instance to be used by GXtest Manager: <br><br>[[image:GXTMInstalador_4.png]]<br><br>
+
# After the installation wizard displays a progress bar the following window will be displayed. <br><br>[[image:GXTMInstalador_4.png|center]]<br><br> In this window you must enter the SQLServer instance to be used by GXtest Manager.
# This window lets you configure the connection to the database. Be sure you have SQLServer installed before continuing. Basically, you have to enter data base Instance (computer name, the "\" char and the name of the database instance). By default, the instance name of the SQL Server Express version is "SQLEXPRESS".
+
# This window lets you configure the connection to the database. Be sure you have SQLServer installed before continuing. Basically, you have to enter the data base Instance (computer name, the "\" char and the name of the database instance). By default, the instance name of the SQL Server Express version is "SQLEXPRESS".
# Then click "Accept". The system asks if you want to create the schema of the database. If this is not your first installation, the program will warn you that it has found a database (indicating the version) and it asks you what to do. <br>[[image:runmigration.png|center]]<br>The options are:
+
# Then click "Accept". The system asks if you want to create the schema of the database. If this is not your first installation, the program will warn you that it has already found a database (indicating the version) and it will ask you what to do. <br>[[image:runmigration.png|center]]<br>The options are:
 
#* To migrate ("Run Migration") maintaining the current data base (this is the recommended option if your database has a previous version).
 
#* To migrate ("Run Migration") maintaining the current data base (this is the recommended option if your database has a previous version).
 
#* Override base ("Overwrite database"), deleting the current data.
 
#* Override base ("Overwrite database"), deleting the current data.
#* Take no action on the database ("Do nothing"). <br>The installer will do this check first for GXtest Database Manager, and then to test the repository GXtest Designer.
+
#* Take no action on the database ("Do nothing"). <br> <br>
 
# You have successfully installed GXtest Manager on your system.
 
# You have successfully installed GXtest Manager on your system.
  
After installing the Manager is required or rebooting the machine, or start manually GXtest Daemon service. Then every time you start the machine running this service will start automatically. In order to work properly, you must have entered the license, so you should restart the machine after enabling license.
+
After installing the Manager you must reboot the machine, or start manually GXtest Daemon service. Then every time you start the machine this service will start automatically. In order to work properly, you must have entered the license, so you should restart the machine after enabling it.
  
=== GXtest Executor Installation ===
+
==== GXtest Executor Installation ====
On every machine you wish to use to run tests GXtest Executor must be installed. This is an application that is accessible on the System Tray. After installed you have to run it manually from the Start menu. Every time you reboot the system it will run automatically.
+
On every machine you wish to run schedulled tests, GXtest Executor must be installed. This is an application that is accessible on the System Tray. After installed you have to run it manually from the Start menu. Every time you reboot the system it will run automatically.
  
For more configuration details see [[GXtest Executor User Manual]].
+
For more configuration details see [[GXtest Executor User's Manual]].
  
 
=== GXtest Designer Installation ===
 
=== GXtest Designer Installation ===
If you selected to start installing GXtest Designer will run a very simple wizard for installation.
+
If you select to start installing GXtest Designer then a very simple wizard will run for installation.
  
# Pressing the "Next" button will display the product license. It is important to read it before accepting it. If you agree with the terms, select "I Agree" and then press "Next" button.
+
# Pressing the "Next" button will display the product license. It is important to read it before accepting it. If you agree with the terms, select "I Agree" and then press the "Next" button.
 
# Then it is necessary to indicate the folder where you will install the product and who will have access to it, if only the current user (Just me) or everyone in the team (Everyone) and then press "Next".
 
# Then it is necessary to indicate the folder where you will install the product and who will have access to it, if only the current user (Just me) or everyone in the team (Everyone) and then press "Next".
# Then confirm the installation pressing "Next" and then a progress bar will be displayed, and then you will see the following window: <br><br> [[image:inst_gxt_5.JPG|center]]<br><br> This window lets you configure the connection to the database. If you don't want to configure the connection to the database at this point you can press "Cancel" and the installation finish successfully, but without setting the connection to the database. If you want to configure the connection, make sure you have SQLServer installed before continuing. Basically, you have to enter Data base Instance (computer name, the "\" char and the name of the database instance). By default, the instance name of the SQL Server Express version is "SQLEXPRESS".  
+
# (Optional) Then confirm the installation by pressing "Next". A progress bar will be displayed, and you will see the following window (will appear only when not installing GXtest Manager): <br><br> [[image:inst_gxt_5.JPG|center]]<br><br> This window lets you configure the connection to the database. If you don't want to configure the connection to the database at this point you can press "Cancel" and the installation finishes successfully, but without setting the connection to the database. If you want to configure the connection, make sure you have SQLServer installed before continuing. Basically, you have to enter the database Instance (computer name, the "\" char and the name of the database instance). By default, the instance name of the SQL Server Express version is "SQLEXPRESS".  
# The option 'Install a working copy DataBase' (recommended for trial version) is used to install a new instance of GXtest Database Designer. With this option, the tester can work in a local working copy and then you can centralize your tests on the GXtest Manager data base to be scheduled. <br> You can verify if the data base connection is correct with the button "Test Connection".
+
# You can verify if the database connection is correct by pressing the button "Test Connection".
# Then click "Accept". The system will asks if you want to create the database schema. If this is not your first installation and you don't want to overwrite the current database press "No", otherwise click "Yes" (recommended).
+
# Then click "Accept". The system will ask if you want to create the database schema. If this is not your first installation and you don't want to overwrite the current database press "No", otherwise click "Yes" (recommended).
  
If you are working with many GXtest Designers on the same database, you should install GXtest Manager (which creates the centralized database, the repository) and then pointing every GXtest Designer to this database. In that case you don't need to create the database schema because you are going to use the one already created.
+
See also [[GXtest_Designer_User_Manual#Login_.2F_Connections| how to edit connections]]. From one GXtest Designer you can access different databases (different installations of GXtest Designer, or GXtest Manager Database).
 
+
See also [[GXtest_Designer_User_Manual#Login_.2F_Connections| how to edit connections]]. From one GXtest Designer you can access to different databases (different installations of GXtest Designer, or GXtest Manager Database).
+
  
 
=== GXtest Recorder Installation ===
 
=== GXtest Recorder Installation ===
If you selected to start installing GXtest Recorder will run a very simple wizard for installation.
+
If you select to start installing GXtest Recorder, then a very simple wizard will run for installation with no user interaction required.
 
+
# Press the "Next" button. The product license will displayed. It is important to read it before accepting it. If you agree with the terms, select "I Agree" and then press "Next" button.
+
# Indicate the folder where you want to install the product and who will have access to it, if only the current user (Just me) or everyone in the team (Everyone) and then press "Next".
+
# Confirm the installation by pressing "Next" and finish the installation pressing "Close".
+
  
 
If the product is properly installed open Internet Explorer®, go to "View -> Toolbar" and select GXtest Recorder. At that time you will see a toolbar like this:
 
If the product is properly installed open Internet Explorer®, go to "View -> Toolbar" and select GXtest Recorder. At that time you will see a toolbar like this:
  
 
[[image:inst_tool_8.jpg|center]]
 
[[image:inst_tool_8.jpg|center]]
 +
 +
=== GXtest Extension Installation ===
 +
The GXtest Extension is useful for the task of exporting the KB of the application under test in order to import it in GXtest. It installs like any other GeneXus Extension and will only work with GeneXus X or higher.
 +
 +
You must copy the file "GXtest Extension.dll" to the Packages folder within the GeneXus installation folder (where the executable GeneXus.exe is). The GXtest Extendion.dll to be used must correspond to the version of GeneXus with which you want to work.
 +
Then you must restart GeneXus and a new menu GXtest must be enabled in Extensions menu.
 +
 +
== Uninstallation ==
 +
To proceed with the uninstallation of the application you must go to "Control Panel / Add or Remove Programs" and look for GXtest entries, select them one by one and press "Remove".
  
 
== License Activation ==
 
== License Activation ==
GXtest uses the same mechanism that GeneXus for licensing through the License Manager GXtest included in the installation folder. To activate the product once installed is necessary to request a license.
+
GXtest uses the same mechanism that GeneXus for licensing through the License Manager GXtest included in the installation folder. To activate the product once installed it is necessary to request a license.
  
 
Also, a trial license may be requested by: Authorize -> Request License -> Authorize Online.
 
Also, a trial license may be requested by: Authorize -> Request License -> Authorize Online.
Line 89: Line 99:
  
 
The Executor and Recorder components can be installed on different machines without any problem.
 
The Executor and Recorder components can be installed on different machines without any problem.
 +
 +
It is important to run the License Manager as an administrator in Windows Vista and Windows 7.

Latest revision as of 16:29, 15 August 2013

Spanish.gif
English.gif
link= {{{3}}}


This Installation Guide is for GXtest 1.1.7 and older versions.


The various components to install are listed below:

  • GXtest Designer and GXtest Recorder to create and edit Test Cases
  • GXtest Manager (GXtest Daemon and GXtest Executors included) to schedule the tests to be executed
  • GXtest Extension, useful to export the GeneXus KB (X, Ev1 or upper)

GXtest Designer has to be installed on machines where users want to model the test cases. If you install this component alone (without GXtest Manager), users will be able to create and execute test cases, but they will can't schedulle and execute tests until GXtest Manager is installed.

Additionally, where installing a GXtest Designer you need to install a GXtest Recorder to record test cases from Internet Explorer.

The component GXtest Recorder can be installed without the GXtest Designer, in order to record test cases and save them as compressed XML files that can be sent afterwards to the user who is using GXtest Designer. This user then will be able to import and use them in any project.

GXtest Manager is installed as a Web application in a .NET environment. It can be remotely accessed by different users. At the same server (not necessarily) the GXtest Daemon component must be running. This component checks if there are scheduled tasks ready to be executed, and makes them execute in the machine specified in the GXtest Executor component.

As a result, there can be several GXtest Executors where tests are ran effectively. They must have access to both the GXtest Manager database and to the application under test (across http).

Contents

Prerequisites

You must have SQLServer 2005/2008. If you don't have SQLServer 2005/2008 installed you can find the Express version for free download here.

GXtest works on Windows XP® (SP2), Windows Vista® and Windows 7® operating systems, with Internet Explorer® version 6, 7 and 8. It is necessary to have the .Net Framework already installed.

No special hardware requirements are defined to run this application.

It is also necessary for the execution of GXtest Manager to have installed the IIS web server - Internet Information Services, which is packaged as a Windows component.

Installation (step by step)

GXtest has an installer which shows the various components components that can be installed. You must first select which components you want to install and then each component is configured via a Wizard.



InstaladorUnificado.JPG


Typical installation: The typical installation consists of having a PC (or server) with the GXtest Manager and with one GXtest Executor to run unattended tests, and a Tester's PC with the GXtest Designer and Recorder.
Then, in order to achieve this configuration in the server PC, you would only select GXtest Manager and Executor in the GXtest installer and in the Tester's PC you would run the same GXtest installer selecting only GXtest Designer and Recorder components.

We recommend first installing the server side and then the "clients" or testers. In turn, consider GXtest Designer can work "offline" of GXtest Manager, in a local database. However, it is recommended for simplicity to work from the GXtest Designer installed on the same GXtest Manager database.

  • Note: The installation will be done in the C: drive so if you want to install on another drive you need to run one by one the MSI attached to the installer. The Manager is installed in the directory of the Internet Information Server.


GXtest Manager Installation

If you select to start installing the GXtest Manager, then a simple wizard will run for installation.

  1. First, the installer displays the welcome window. Press "Next".

    GXTMInstalador 2.png


  2. Then the installer lets you choose the virtual directory where the web application is going to be installed. If the installation is being done in Windows Vista, Windows 7, you may also specify the Application Pool desired. In this combo select the "Classic. NET AppPool" and then click "Next".
  3. Pressing the "Next" button will display the product license. It is important to read it before accepting it. Should you agree with the terms, select "I Agree" and then press the "Next" button. Check again after the installation by pressing "Next".
  4. After the installation wizard displays a progress bar the following window will be displayed.

    GXTMInstalador 4.png


    In this window you must enter the SQLServer instance to be used by GXtest Manager.
  5. This window lets you configure the connection to the database. Be sure you have SQLServer installed before continuing. Basically, you have to enter the data base Instance (computer name, the "\" char and the name of the database instance). By default, the instance name of the SQL Server Express version is "SQLEXPRESS".
  6. Then click "Accept". The system asks if you want to create the schema of the database. If this is not your first installation, the program will warn you that it has already found a database (indicating the version) and it will ask you what to do.
    Runmigration.png

    The options are:
    • To migrate ("Run Migration") maintaining the current data base (this is the recommended option if your database has a previous version).
    • Override base ("Overwrite database"), deleting the current data.
    • Take no action on the database ("Do nothing").

  7. You have successfully installed GXtest Manager on your system.

After installing the Manager you must reboot the machine, or start manually GXtest Daemon service. Then every time you start the machine this service will start automatically. In order to work properly, you must have entered the license, so you should restart the machine after enabling it.

GXtest Executor Installation

On every machine you wish to run schedulled tests, GXtest Executor must be installed. This is an application that is accessible on the System Tray. After installed you have to run it manually from the Start menu. Every time you reboot the system it will run automatically.

For more configuration details see GXtest Executor User's Manual.

GXtest Designer Installation

If you select to start installing GXtest Designer then a very simple wizard will run for installation.

  1. Pressing the "Next" button will display the product license. It is important to read it before accepting it. If you agree with the terms, select "I Agree" and then press the "Next" button.
  2. Then it is necessary to indicate the folder where you will install the product and who will have access to it, if only the current user (Just me) or everyone in the team (Everyone) and then press "Next".
  3. (Optional) Then confirm the installation by pressing "Next". A progress bar will be displayed, and you will see the following window (will appear only when not installing GXtest Manager):

    Inst gxt 5.JPG


    This window lets you configure the connection to the database. If you don't want to configure the connection to the database at this point you can press "Cancel" and the installation finishes successfully, but without setting the connection to the database. If you want to configure the connection, make sure you have SQLServer installed before continuing. Basically, you have to enter the database Instance (computer name, the "\" char and the name of the database instance). By default, the instance name of the SQL Server Express version is "SQLEXPRESS".
  4. You can verify if the database connection is correct by pressing the button "Test Connection".
  5. Then click "Accept". The system will ask if you want to create the database schema. If this is not your first installation and you don't want to overwrite the current database press "No", otherwise click "Yes" (recommended).

See also how to edit connections. From one GXtest Designer you can access different databases (different installations of GXtest Designer, or GXtest Manager Database).

GXtest Recorder Installation

If you select to start installing GXtest Recorder, then a very simple wizard will run for installation with no user interaction required.

If the product is properly installed open Internet Explorer®, go to "View -> Toolbar" and select GXtest Recorder. At that time you will see a toolbar like this:

Inst tool 8.jpg

GXtest Extension Installation

The GXtest Extension is useful for the task of exporting the KB of the application under test in order to import it in GXtest. It installs like any other GeneXus Extension and will only work with GeneXus X or higher.

You must copy the file "GXtest Extension.dll" to the Packages folder within the GeneXus installation folder (where the executable GeneXus.exe is). The GXtest Extendion.dll to be used must correspond to the version of GeneXus with which you want to work. Then you must restart GeneXus and a new menu GXtest must be enabled in Extensions menu.

Uninstallation

To proceed with the uninstallation of the application you must go to "Control Panel / Add or Remove Programs" and look for GXtest entries, select them one by one and press "Remove".

License Activation

GXtest uses the same mechanism that GeneXus for licensing through the License Manager GXtest included in the installation folder. To activate the product once installed it is necessary to request a license.

Also, a trial license may be requested by: Authorize -> Request License -> Authorize Online.

For more information visit http://wiki.gxtechnical.com/commwiki/servlet/hwiki?GeneXus+X+Protection+Manual

The Executor and Recorder components can be installed on different machines without any problem.

It is important to run the License Manager as an administrator in Windows Vista and Windows 7.