Documente Academic
Documente Profesional
Documente Cultură
LatestUpdate:12/22/05
Copyright ARTech Consultores S. R. L. 1988-2005. All rights reserved. This document may not be reproduced in any form without the express permission of ARTech Consultores S.R.L. The information contained herein is intended for personal use only. TRADEMARKS ARTech, GeneXus and GXquery are trademarks or registered trademarks of ARTech Consultores S.R.L. All other trademarks mentioned herein are property of their respective owners.
Table of Contents
Introduction 1. GeneXus Components 2. Manual Guidelines System Requirements 1. Basic Installation Requirements 2. Generator Requirements 3. GeneXus Patterns Requirements 4. GXquery Requirements Installation 1. Installing GeneXus 9.0 2. Installing Upgrades 3. Installation FAQs License Authorization 1. GXprotection 2000 2. GeneXus License Authorization Overview 3. GeneXus Protection Server 4. Authorizing a GeneXus License for the First Time 5. Authorizing a GeneXus Upgrade License 6. Uninstalling a GeneXus License 7. Transferring a GeneXus License 8. Authorizing a GXquery License More Information Online Resources 4 4 4 6 6 6 8 8 9 9 14 15 17 17 17 18 19 22 22 23 24 28 28
Introduction
1. GeneXus Components
GeneXus has the following components: 1. Development Environment It is an Integrated Development Environment (IDE) for designing and prototyping your applications, regardless of the production platform. 2. Generators GeneXus generates native code for the leading platforms. The generators 1 available are the following: .NET Java .NET Mobile Visual FoxPro Cobol for iSeries RPG for iSeries 3. Patterns This tool is a framework that allows GeneXus developers to apply any pattern to his/her KB. The tool itself comes with a set of 'builtin' patterns, so the developer can start using patterns without the need to develop a pattern himself/herself. The tool lets the developer select a specific pattern, ask for all the parameters the pattern needs, and after that it generates all the GeneXus Objects needed to implement the pattern. It also has the capability to import, compile and execute these objects. More information 4. Database Reverse Engeneering Tool This tool helps you to integrate easier and better to already existing (legacy) databases. It creates a normalized data model in GeneXus even when the existing database does not comply with URA. It takes all the information of the schema of the database and uses all the related features of GeneXus (Transactions, subtypes, data views) in order to create the best possible model. And it allows doing all this in an incremental way. More information 5. GXquery This is a flexible analysis tool for end users who need to create their own dynamic reports. Provides easy and safe access to all the information of your organization. Allows end users to build their own reports.
2. Manual Guidelines
There is only one setup wizard to install the components mentioned above. In the Installation chapter you will find a detailed description of the installation process. Before the installation, check the requirements of each component in the System Requirements chapter.
The Visual Basic and C/SQL Generators are not available yet. Any news will be announced in the GeneXus News.
To be used, each component requires an activation code. In the License Activation chapter you will find the required steps to activate them. In addition, there are regular product Upgrades. In the Installing Upgrades section of the Installation chapter you will find information about how to obtain and install these upgrades. If you are already working with previous GeneXus versions and want to migrate your Knowledge Base to version 9.0, read the Compatibility & Conversion section in this versions Release Notes. Finally, in the More Information chapter you will find more information about the product as well as interesting links to resources on documentation, support, forums, etc.
System Requirements
1. Basic Installation Requirements
Below are the minimum requirements to install GeneXus: Hardware Requirements Processor: 500 MHz Intel Pentium class Memory: at least 128 MB of RAM (512 MB recommended) Hard disk: at least 50 MB of free disk space to install the Development Environment, plus an average of 10 MB for each generator. To create GeneXus applications you will need additional space or a shared disk to create the Knowledge Bases. Video: 800 x 600 resolution or higher, with 256 colors Software Requirements Microsoft Windows with NT technology; Microsoft Windows 2000 or higher version. If you are using Windows NT, you must install service pack 6a or higher. Microsoft .NET Framework 1.1 or 2.0 Redistributable 2 Package Microsoft Internet Explorer 6.0 SP1 or higher
2. Generator Requirements
This section contains the requirements to generate and execute applications with the different GeneXus generators:
You can install it from the GeneXus 9.0 CD. It is located under the \Software\Third Party Tools\Microsoft\Microsoft .NET Framework 1.1 directory. The .NET Framework 1.1 Redistributable Package can also be downloaded from Microsofts website: http://msdn.microsoft.com/library/default.asp?url=/downloads/list/netdevframework.asp
Generator .NET
Java
Requirements Microsoft .NET Framework 1.1 or 2.0 Redistributable 2 Package For generating Web interface applications you will need IIS 5.0 or higher (available on Windows 2000 or XP) For generating Windows interface applications or printing PDF reports, you will need Visual J# 3 Distribution Package 1.1 ODBC Driver or ADO .NET provider for the DBMS used Sun JDK (http://java.sun.com/j2se/1.5.0/download.jsp) For generating Web interface applications: o Web Server 4 o Servlet Engine o JavaServer Web Development Kit For generating 3-tier Windows interface applications, depends on protocol used: o HTTP: you will need a Web server and a servlet engine o Visibroker: you will need Visibroker Support JDBC Driver for the DBMS used Microsoft Visual Studio 2003 ActiveSync 3.7 or latter Windows 2000, Windows XP or Windows NT SP5. Microsoft Visual Studio 6.0, with Service Pack 5 or higher MDAC 2.6 or higher Microsoft Visual Studio 6.0, with Service Pack 5 or higher MDAC 2.6 or higher ODBC Driver for the DBMS used Cobol Compiler GeneXus Library for iSeries RPG Compiler GeneXus Library for iSeries
In addition, to create the database and execute the generated applications, you must have some of the following DBMSs installed: Generator .NET Java Visual FoxPro Client/Server DBMS DB2 Universal Database DB2 UDB for iSeries Informix MySQL Oracle PostgreSQL SQL Server
You can obtain Visual J# Distribution Package 1.1 or higher from Microsofts website: http://msdn.microsoft.com/vjsharp/downloads/howtoget.asp or from the GeneXus 9.0 CD, in the following directory: \Software\Third Party Tools\Microsoft\Microsoft Visual JSharp 1.1 4 You can obtain the Jakarta Tomcat Servlets form the CD, in the following directory Software\Third Party Tools\Java\Servlets Servers
Visual FoxPro Cobol for iSeries RPG for iSeries .NET Mobile
DBFCDX (Compound Indexes) DBFIDX iSeries Native iSeries Native SQL Server SQL Server CE
4. GXquery Requirements
You need GXquery 2.0 Upgrade 3 in order to work with GeneXus 9.0 knowledge bases. This upgrade is included in the GXquery installer contained in the GeneXus 9.0 CD.
Installation
This chapter describes the steps to install and update GeneXus 9.0. Note that you must have Administrator rights to execute the installation and apply the Upgrades.
Disadvantages of the network installation You may experience slower performance for some GeneXus operations. If the server or the shared directory is not available, you cannot use GeneXus.
Standalone Installation
1. Insert the GeneXus 9.0 CD into your CD-ROM drive. 2. Run the GeneXus 9.0 setup wizard from the browser (by selecting GeneXus 9.0/Install GeneXus 9.0), or from the CD (by executing the GX90.exe file located in the Software\GeneXus 9.0 directory). 3. Register your name and company name in the dialog box displayed after the Welcome window and the License Agreement. You will also be able to indicate whether you want to register the settings for your username only, or for all the users that share the PC (fig. 1). When you finish, click Next.
Figure 1 4. Optionally, indicate the installation directory in the dialog box that is displayed. The default directory is c:\Program Files\ARTech\GeneXus\GeneXus90, but you may change it by selecting the Browse button. (Fig. 2) NOTE: You must not select a directory that is being used by another GeneXus version.
Figure 2 5. You will see the components that will be installed by default and those that will not be installed by default. The latter are indicated with a red cross. To add components, click on a component and select Will be installed on local hard drive. To remove components, click on a component and select Entire feature will be unavailable. To start the installation, click on the Next button. (Fig. 3)
Figure 3 Note: DBRet will be installed in a silent mode when install GeneXus. GXpublic will be installed in a silent mode when install GeneXus or Patterns or GXquery. 6. Once the installation is complete, a dialog box with three options is displayed: Do you want to create a desktop shortcut to GeneXus 9.0? It creates a shortcut to GeneXus 9.0 in the Windows Desktop. Online Web User Registration It allows you to register in our web site, where you can subscribe to the news service and have access to product upgrades and useful technical information. Launch License Manager It executes the GeneXus License Manager, from where you can activate the installed components. After clicking on the Finish button, the selected options are launched and the set of GeneXus 9.0 programs is created. In addition, if you selected the GXquery component in step 5, the installation of this component will be launched independently. For detailed instructions on how to install GXquery, please refer to GXquery Installation Manual.
Network Installation
GeneXus installation in a network server The network installation differs from the standalone installation only in that GeneXus is installed on a server disk. It can be executed either from the server console or from any workstation connected to the server. It requires full writing rights to the installation servers disk. When executing the installation from a workstation, in step 5 of the installation process you must select the Workstation Setup Files option in order to install the components. This will copy the Workstation Setup to the server so as to be executed later by the workstations. Workstation Setup You must execute this option from each workstation that will use a GeneXus network installation (already executed following the steps of the previous section). 1. Execute GXNSetup.exe from the Nsetup directory located in the GeneXus network installation directory. NOTE: The directory where the new version is installed must be mapped as a logical unit. UNC paths are not supported. This mapping must be kept after the execution of the Workstation Setup; otherwise the installation will not work properly. 2. Register your name and company name in the dialog box that is displayed after the Welcome screen. Also, indicate whether you want to register the settings for your username only, or for all the users that share the PC. (Fig. 4)
Figure 4
3. Select one of the two options of the dialog box that is displayed once the installation is complete: Do you want to create a desktop shortcut to GeneXus 9.0? It creates a shortcut to GeneXus 9.0 in the Windows Desktop. Online Web User Registration This option allows you to register in our web site, where you can subscribe to the news service and have access to product upgrades and useful technical information. Click on the Finish button to launch the selected options and create the set of GeneXus 9.0 programs.
2. Installing Upgrades
Upgrades of the GeneXus components are periodically made available. They are executables that must be applied to an existing installation. Different upgrades are available for the Development Environment, for each generator, and for GXquery. You can download the latest Upgrades from: Development Environment and Generators: http://www.gxtechnical.com/updategx90
Installation
Below are detailed instructions for installing Upgrades: 1. Download the corresponding Upgrade executable and run it. 2. If an installation of the component to be upgraded is not detected in your PC (for the same GeneXus version), a message will be displayed and the installation will be cancelled. Otherwise, the installation will be executed. NOTES: Version 9.0 upgrades do not prompt you for an installation directory, as it is obtained from the previous installation. Visual FoxPro and Visual FoxPro Client/Server Upgrades must be applied not only to the network installation, but also to each one of the workstations sharing this installation. In this case, the Upgrade installation will only update the workstations DLLs and OCXs.
3. Installation FAQs
How do I add components to GeneXus?
Rerun the setup and select the Modify option. Add the desired components and continue with the installation.
Can I have more than one GeneXus 9.0 installation in the same PC?
You cant have more than one local version. When executing the setup for the second time, the previous installation is detected and a dialog box is displayed with the following options: Modify, Repair and Remove. These options apply to the previous installation. You can have a local installation and use a network version by executing the Workstation Setup. However, remember that when working with Windows NT/2000/XP it will use the settings of the last setup used. To make sure that youre running the selected version, execute the GX Register tool, located in the GeneXus 9.0/GeneXus Utilities set of programs. You may also execute GXReg.EXE in the GeneXus installation directory.
Can I have more than one GeneXus version installed on the same PC?
Yes, you can. The only constraint is that they must be installed on different directories.
License Authorization
1. GXprotection 2000
GXprotection 2000 is the protection system used by GeneXus products since the release of version GeneXus 6.1 Patch 5. Previous versions of GeneXus used the Crypkey protection system.
The following GeneXus products use concurrent licenses: GeneXus Development Environment and all the GeneXus Generators GXflow Process Modeler GXplorer Metadata Manager
The following GeneXus products use single user licenses: GXquery GXflow Client GXplorer OLAP GXportal Back Office GXportal Single Sign On Module
To view what type of license each product is using, open the GeneXus License Manager, a GeneXus utility that is automatically installed with GeneXus: When you authorize a product that uses single user licenses, it prompts you for the license owner. In the Restriction column, the single user license information is displayed. Besides, it indicates the number of unassigned copies if the product has licenses that havent been assigned. The Authorized Users button is enabled only when the license is already assigned to a user.
After installing GeneXus, you have to authorize the licenses of the GeneXus components that you have purchased, such as the GeneXus Developer Environment, GeneXus Generators, and other GeneXus products. Otherwise, you will get a protection error when trying to use those components and products. To authorize a license, you need to request and install a file called Site Key in the machine where you will use the product (local installation) or in a license server (remote installation). The Site Key files have a gxa extension. The process for requesting and installing Site Keys, also referred to as requesting and installing GeneXus licenses, is performed using the GeneXus License Manager, a GeneXus utility that is automatically installed when you install GeneXus and any other GeneXus product. To request a Site Key you will send a GeneXus-generated code, called Site Code, to your distributor. Your distributor will process it and send you the corresponding Site Key. There are two ways to authorize GeneXus licenses: Local Installation: The Site Key is installed on the same PC where the licensed user will use the product. In this case, the license installation is local while the licensed product may be installed on the user PC (local) or on another machine. Remote Installation: The Site Key is installed on a different PC than the one where the licensed user will actually use the product. In this case you need to install the GeneXus Protection Server on a license server. This option enables licensed users to use the product from any networked PC with access to the license server and is the recommended option for customers using several GeneXus licenses. Here again, the licensed product may be installed on the user PC or on another machine in the network.
In addition, the authorization process varies depending on whether or not there are previous versions of GeneXus installed on your PC. Note: The authorization process is needed for all GeneXus components except for the Visual FoxPro GeneXus Generator and Visual Basic GeneXus Generator when used in File Server mode (with DBF or Access as DBMS).
The GeneXus Protection Server is a service that runs on Windows 2000/XP/NT or higher, and provides licenses to any network client, regardless of where the product is installed (on the server or on any other PC). Clients accessing this service must be under the same domain. Whether you have installed GeneXus locally o remotely, you have to enter the name or IP address of the license server in the Select Computer option of the License Manager.
Note: You can only choose Remote License if you have previously installed the GeneXus Protection Server on the computer that will be the license server. For more information read Section 3. GeneXus Protection Server. 3. Click on the Authorize button. 4. Choose the Request Licenses option to select the components that you want to authorize, that is to say, the ones that you have purchased. Then click Next. 5. Select one of the two methods available for requesting your licenses: a) Authorize Online: In this case, the license request will be made via the Internet. To do so, complete the request information in the web form that will be displayed and submit it. b) Generate Authorization File: Use this option if you dont have an Internet connection on your PC. This option will generate a file containing all the corresponding Site Codes for your licenses. To do so, follow the instructions provided in the Authorization Wizard. You will then need to send the generated file to your distributor via email.
6. After receiving the Site Key (gxa file) via email, copy it to your hard disk. 7. Execute the GeneXus License Manager once again. 8. Click on the Authorize button and choose the Enter Licenses option. Then click Next.
9. Choose the Authorize from File option and browse to select the Site Key
You can now use both versions on the same machine! Note: GXprotection 2000 is not compatible with the Crypkey protection system (used up to version 6.1 Patch 4). For this reason, it is not possible to transfer or share keys between those versions.
To uninstall GeneXus licenses, follow these steps: 1. Execute the GeneXus License Manager, located in the GeneXus Programs menu. You may also run GxLMgr.exe from the product installation directory.
2. Select the product license that you want to uninstall and click on the Uninstall button. 3. Enter the number of licenses that you want to uninstall and click OK.
4. Copy the Uninstall Key that will be prompted to you. 5. Send the Uninstall Key to your distributor. Note: Licenses remain active on a PC after uninstalling a product. Before removing the product, back up the GxLMgr.exe file to be able to uninstall or transfer the licenses later.
There are two ways to transfer GeneXus licenses: Direct Transfer: This option enables you to transfer one or more licenses from a user PC or protection server to another located in the same network. The GeneXus Protection Server must be installed in the target server. To directly transfer a GeneXus License: 1. Open the License Manager and click on Select Computer to connect to the source machine, that is to say, where the license is currently installed. If the license to be transferred is on a PC, the Direct Transfer must be performed from the source machine. Otherwise, if the license is on a server, the transfer can be performed either from
the source server or the target server. 2. Click the Transfer button, select the Direct Transfer option, enter the target server name, and the number of copies to be transferred. When you have finished, click OK. The process to transfer single user licenses is different from that of concurrent licenses in that the user(s) to be transferred must be indicated in the transference dialog box. Remote Transfer: This option is used for transferring one or more licenses between two machines. It can be between two servers, two PCs, a server and a PC or vice versa. To remotely transfer a GeneXus license: 1. Register Transfer, on the target machine. 2. Transfer Out, on the source machine. 3. Transfer In, on the target machine
2. Click on the Select Computer button and choose Local License or Remote License.
Note: You can only choose Remote License if you have previously installed GeneXus Protection Server on the computer that will be the license server. For more information read Section 3. GeneXus Protection Server. 3. Click on the Authorize button. 4. Choose the Request Licenses option and select GXquery. Then click Next. 5. Select one of the two methods available for requesting your licenses: a) Authorize Online: In this case, the license request will be made via the Internet. To do so, complete the request information in the web form that will be displayed and submit it. b) Generate Authorization File: Use this option if you dont have an Internet connection on your PC. This option will generate a file containing all the corresponding Site Codes for your licenses. To do so, follow the instructions provided in the Authorization Wizard. You will then need to send it to your distributor via email.
6. After receiving the Site Key (a .gxa file) via email, copy it to your hard disk. 7. Execute the GeneXus License Manager once again. 8. Click on the Authorize button and choose the Enter Licenses option.
9. Click on the Authorize from File button and browse to select the Site Key (.gxa) file.
10. Click on the Authorized Users button in the License Manager to enter the GXquery usernames of the license owners. Then click OK. You are now ready to start using GXquery!
More Information
Online Resources
GeneXus 9.0 Help
You can obtain the updated version of GeneXus 9.0 Help at: http://www.gxtechnical.com/helpgx90.
Customer Support
The Technical Support services are provided by ARTech and the associated distributors. ARTech provides these services directly to its customers in Brazil, Colombia, Mexico, Panama and Uruguay, to all GeneXus distributors worldwide, as well as to the customers that have purchased extended support. Customers in the rest of the world receive the service from their respective distributors. Please visit http://www.genexus.com/distributors to view the list of distributors. Further information at: http://www.gxtechnical.com/assistedsupport
Forums
There are public forums related to different topics of the GeneXus world. You can subscribe at http://www.gxtechnical.com/forum.