Installation Manual
Total Page:16
File Type:pdf, Size:1020Kb
™ GENEXUS Installation Manual Copyright Ó ARTech Consultores 1988-1999. All rights reserved. Table of Contents INTRODUCTION ............................................................................................................ 1 A NOTE FOR ALL GENEXUS USERS ........................................................................... 2 GENEXUS TUTORIAL...................................................................................................... 2 GETTING STARTED...................................................................................................... 3 SETUP OPTIONS ............................................................................................................... 3 SHOULD I KEEP MY EARLIER GENEXUS VERSIONS? ......................................................... 4 CONVERTING GENEXUS APPLICATIONS FROM DOS TO WINDOWS .................................. 4 What files can be deleted once the conversion has been carried out? ....................... 6 CONVERTING MODELS FROM PRIOR GENEXUS FOR WINDOWS VERSIONS TO GENEXUS VERSION 6 EVOLUTION 1 ................................................................................................. 7 COPY PROTECTION SCHEME............................................................................................ 7 REQUIREMENTS ......................................................................................................... 11 GENEXUS STAND-ALONE SETUP .............................................................................. 13 USING GENEXUS AUTHORIZER ................................................................................ 20 Information............................................................................................................... 21 Authorize .................................................................................................................. 21 Authorizing Generators............................................................................................ 23 Direct Transfer......................................................................................................... 23 Uninstall................................................................................................................... 24 GENEXUS Authorizer Log ......................................................................................... 24 Remote License Transfer .......................................................................................... 24 Sharing one License between Two Different Sites.................................................... 26 STARTING GENEXUS .................................................................................................... 28 GENEXUS NETWORK SETUP...................................................................................... 30 AUTHORIZING GENEXUS ON A "SHARED INSTALLATION" .............................................. 31 NOVELL NETWARE NETWORKS .................................................................................. 32 Configuration Requirements .................................................................................... 33 License Related Issues.............................................................................................. 34 WINDOWS NT NETWORKS ............................................................................................ 35 Manual Installation of the License Driver ............................................................... 36 Configuration Program............................................................................................ 37 GENEXUS installed on a Windows NT Server ........................................................... 39 Uninstalling.............................................................................................................. 39 Windows NT Known Problems................................................................................. 40 GENEXUS NETWORK WORKSTATION SETUP ............................................................... 40 TIPS AND LICENSE ERROR MESSAGES ............................................................... 43 INSTALLATION AND CONFIGURATION TIPS .................................................................... 43 Changing the Workstation's Date............................................................................. 43 Synchronizing Workstations Time and Date ............................................................ 43 How to re-authorize a site in case the date of the license is incorrect ..................... 44 New Site Codes......................................................................................................... 45 CKSERVE and CKSERVER ..................................................................................... 45 COMMON LICENSE ERROR MESSAGES .......................................................................... 45 Error Messages when entering a New Site Key........................................................ 45 Error Messages when querying the License:............................................................ 45 GENEXUS AS/400 LIBRARY INSTALLATION.......................................................... 47 ABOUT THE INSTALLATION IF VERSION 2.2 IS USED ....................................................... 47 REQUIREMENTS............................................................................................................. 48 NORMAL INSTALLATION PROCESS FOR VERSION 2.2 ..................................................... 48 ABOUT THE INSTALLATION FOR VERSION 2.3 AND HIGHER............................................ 50 PROBLEMS INSTALLING GENEXUS FOR WINDOWS LIBRARY.......................................... 53 ERROR DESCRIPTION AND RECOVERY PROCEDURES.................................. 54 List of Errors ............................................................................................................ 54 INSTALLING A PATCH .............................................................................................. 57 INTRODUCTION.............................................................................................................. 57 INSTALLING A PATCH .................................................................................................... 57 WHICH WAS THE LAST PATCH RELEASE I INSTALLED?.................................................. 59 DIFFERENCES BETWEEN PATCHES ................................................................................. 59 USER NOTES................................................................................................................. 62 INDEX............................................................................................................................. 64 0 Introduction INTRODUCTION This manual provides all the information you need to know about how to install GENEXUS. You will first come across a "Getting Started" section which briefs you on a few very important points worth knowing before you actually install/setup GENEXUS. You may also go over the minimum requirements needed to successfully install and run GENEXUS in your working environment by referring to the "Requirements" section. If your target environment is a stand-alone computer then you can turn to the specific setup option that directly interests you. If you are a network administrator, you will find information on how to setup GENEXUS on a shared directory or a network file server, under the "GENEXUS Network Setup" section. There is also a specific section covering "GENEXUS Network Workstation Setup". Before running your installed version of GENEXUS you will have to authorize it. The authorizing process is explained in detail under the section titled "Using GENEXUS Authorizer". Users who make use of a particular generator will need to follow the setup instructions and check in the list of generators that require authorization to see if the generator they have chosen to use need to be authorized. When you request site keys from your distributors it is compulsory that you fill-in the 'Request License Authorization Form'. This form is included with every purchase of GENEXUS. Do not forget to read the section titled "Tips and License Error Messages" because it surely broadens your knowledge and helps you avoid nasty errors. There is also a section that covers "GENEXUS AS/400 Library Installation" for those users who are using RPG/400 or COBOL/400 generators. We have also included a section that explains how to Install GENEXUS Patches. This has been incorporated to the manual as it, in itself, is an entire installation process. 1 Installation Manual COPYRIGHT Ó ARTech 1988 - 1999. All rights reserved. This document may not be duplicated in any way without the expressed written consent of ARTech Consultores S.R.L.. The information contained herein is for the personal use of the reader. TRADEMARKS All product names mentioned in this document are the trademarks of their respective holders. A NOTE FOR ALL GENEXUS USERS We strongly recommend that you do not install this GENEXUS version over any prior GENEXUS version. It is good practice to keep your prior version untouched until you are satisfied that your applications run as desired on the newer version. Not only do we suggest that you back up your older GENEXUS versions but also your applications. GENEXUS TUTORIAL A Tutorial on a Sales Application is included with GENEXUS and is automatically installed in the SAMPLES subdirectory of the directory where GENEXUS was installed. It is contained in a compressed