Difference between revisions of "Old GXtest Installation guide"

From GXtest Wiki
Jump to: navigation, search
(Prerequisites)
(Installation (step by step))
Line 26: Line 26:
  
 
== 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|center]]<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|center]]<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.
Line 52: Line 52:
 
# 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 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]].
 
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".  
+
# Then confirm the installation by pressing "Next". A progress bar will be displayed, and 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 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".
+
# 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 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.
+
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 point 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 to 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 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 with no user interaction required.
+
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:
 
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:
Line 80: Line 80:
  
 
=== GXtest Extension Installation ===
 
=== GXtest Extension Installation ===
The GXtest Extension is useful only if you work with GeneXus X or higher 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.
+
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 file to use GXtest Extendion.dll must correspond to the version of GeneXus with which you want to work.
+
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.
 
Then you must restart GeneXus and a new menu GXtest must be enabled in Extensions menu.
  

Revision as of 22:40, 24 May 2010


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. It is a single-user component that firstly connects to its own database and then to the Manager database. For this reason it must be on the same LAN than the databases.

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.

The 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.

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").
      The installer will do this check first for GXtest Database Manager, and then to test the repository GXtest Designer.
  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 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. Then confirm the installation by pressing "Next". A progress bar will be displayed, and you will see the following window:

    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. 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.
    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).

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 point 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 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 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.