Installation Manual Copyright Artech Consultores S
Total Page:16
File Type:pdf, Size:1020Kb
Installation Manual Copyright ARTech Consultores S. R. L. 1988-2003. 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 GeneXus Query 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 Table of Contents______________________________________3 Introduction__________________________________________4 1. GeneXus Components __________________________________________4 2. Manual Guidelines _____________________________________________4 System Requirements___________________________________5 1. Basic Installation Requirements ___________________________________5 2. Generator Requirements ________________________________________5 3. GeneXus Query Requirements ____________________________________7 Installation___________________________________________8 1. Installing GeneXus 8.0__________________________________________8 2. Installing Upgrades ___________________________________________14 3. Installation FAQs _____________________________________________15 License Activation_____________________________________16 1. New GeneXus User____________________________________________17 2. User of Previous GeneXus Versions _______________________________17 3. GeneXus Query Activation______________________________________18 4. Activation FAQs ______________________________________________18 More Information_____________________________________20 Online Resources ________________________________________________20 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 available are the following: • .NET • Java • Visual Basic • Pocket PC • C/SQL • Visual FoxPro • Cobol for iSeries • RPG for iSeries 3. GeneXus Query 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. 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 8.0, read the Backward Compatibility section in this version‘s Release Notes. This document is included in the GeneXus 8.0 CD, under the directory: Technical Documents\GeneXus 80 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 .elow are the minimum requirements to install GeneXus: Hardware Requirements Processor: 500 MHz Intel Pentium class Memory: at least 64 MB of RAM (256 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 Microsoft Windows 98 or higher. If you are using Requirements Windows NT, you must install service pack 6.0 or higher. Microsoft .NET Framework 1.1 Redistributable Package 1 Microsoft Internet Explorer 6.0 SP1 or higher 1 2. Generator Requirements This section contains the requirements to generate and execute applications with the different GeneXus generators: Generator Requirements .NET • Microsoft .NET Framework 1.1 Redistributable Package 1 • 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# Distribution Package 1.1 2 • ODBC Driver for the DBMS used 1 You can install it from the GeneXus 8.0 CD. It is located under the Tools directory. The .NET Framework 1.1 Redistributable Package can also be downloaded from Microsoft‘s website: http://msdn.microsoft.com/library/default.asp?url=/downloads/list/netdevframework.asp 2 You can obtain Visual J# Distribution Package 1.1 from Microsoft‘s website: http://msdn.microsoft.com/vjsharp/downloads/howtoget.asp or from the GeneXus 8.0 CD, in the following directory: Tools\Microsoft VJSharp 1.1 Java • Sun and/or Microsoft JDK (we recommend having both) • For generating Web interface applications: o Web Server o Servlet Engine o JavaServer Web Development Kit • For generating 3-tier Windows interface applications: o HTTP: you will need a Web server and a servlet engine o CORBA: you will need Visibroker • JDBC Driver for the DBMS used Visual Basic • Microsoft Visual Studio 6.0, with Service Pack 5 or higher • MDAC 2.6 or higher 3 • If you use Sheridan Data Widgets, you will need version 3.0 or higher installed. • ODBC Driver for the DBMS used (except if you are working with Access) Pocket PC • Embedded Visual Tools 3.0 4 • Windows 2000, Windows XP, Windows NT SP5, or Windows 98 Second Edition (the latter does not support the emulator). C/SQL • C Compiler (Visual Studio 6.0 Service Pack 5 or higher in Windows environments) • Remote Execution Service • Precompiler or ODBC Driver for the DBMS used The requirements for this generator may vary depending on the platform and the access technology used to access data. They also change depending on where the source will be compiled. For further information please refer to: C/SQL Generator Requirements Visual FoxPro • Microsoft Visual Studio 6.0, with Service Pack 5 or higher • MDAC 2.6 or higher 3 Visual FoxPro • Microsoft Visual Studio 6.0, with Service Pack 5 or Client/Server higher • MDAC 2.6 or higher 3 • ODBC Driver for the DBMS used Cobol for iSeries • Cobol Compiler • GeneXus Library for iSeries RPG for iSeries • RPG Compiler • GeneXus Library for iSeries 3 You can install it from the GeneXus 8.0 CD. It is located under the Tools directory. 4 You can obtain Embedded Visual Tools 3.0 from: http://www.microsoft.com/downloads/details.aspx?FamilyId=F663BF48-31EE-4CBE- AAC5-0AFFD5FB27DD&displaylang=en It includes the Pocket PC 2002 emulator. To install the Pocket PC 2000 emulator, download it from http://www.microsoft.com/downloads/details.aspx?FamilyId=BB3F4D7B-DE2A-4E1A- A175-26A68C301AC4&displaylang=en In addition, to create the database and execute the generated applications, you must have some of the following DBMSs installed: Generator DBMS .NET DB2 Universal Database Java DB2 UDB for iSeries C/SQL Informix Visual FoxPro Client/Server Oracle PostgreSQL SQL Server Visual Basic Access DB2 Universal Database DB2 UDB for iSeries Informix Oracle PostgreSQL SQL Server Visual FoxPro DBFCDX (Compound Indexes) DBFIDX Cobol for iSeries iSeries Native RPG for iSeries iSeries Native Pocket PC ADOCE 3. GeneXus Query Requirements You need GeneXus Query Upgrade 5 in order to work with GeneXus 8.0 knowledge bases. This upgrade is included in the GeneXus Query installer contained in the GeneXus 8.0 CD. Installation This chapter describes the steps to install and update GeneXus 8.0. Note that you must have Administrator rights to execute the installation and apply the Upgrades. 1. Installing GeneXus 8.0 INSTALLATION OPTIONS When installing GeneXus, you can choose between two options: Standalone installation: this option installs GeneXus on a local or shared disk and updates your system to ensure proper product operation. In this case, GeneXus runs without the need of a network connection. Network installation: this option installs GeneXus on a shared directory or a network server so that the product can be concurrently used by more than one workstation. After the network server installation is complete, you must run an installation called Workstation Setup in each workstation. Advantages of the network installation • Your local disk space is not affected by the installation of GeneXus. The workstation setup procedure is quite faster because you don‘t have to copy all the installation files to each one of them. • As for version maintenance, the installation of Upgrades is simpler as they are only applied to the shared installation and not to all workstations. 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. Below are detailed instructions for both installation processes. STANDALONE INSTALLATION 1. Insert the GeneXus 8.0 CD into your CD-ROM drive. 2. Run the GeneXus 8.0 setup wizard from the browser (by selecting GeneXus 8.0/Install/Install GeneXus 8.0), or from the CD (by executing the GX80.exe file located in the GeneXus80