de GeneXus
Última actualización: 23 de junio de 2008
Manual de Instalación de GeneXus
Todos los derechos reservados. Este documento no puede ser reproducido de ninguna manera sin el
consentimiento explícito de Artech Consultores S.R.L. La información contenida en este documento es para uso
personal únicamente.
Marcas Registradas
Todas las demás marcas mencionadas en este documento son propiedad de sus respectivos dueños.
Página 1
Manual de Instalación de GeneXus
Introducción ........................................................................................................................................ 3
Ambiente de Desarrollo ............................................................................................................................ 3
Generadores ............................................................................................................................................. 3
Lineamientos del Manual ..................................................................................................................... 3
Instalación de GeneXus X ..................................................................................................................... 4
Ventajas de la instalación en red .............................................................................................................. 4
Desventajas de la instalación en red ......................................................................................................... 4
Instalación independiente ........................................................................................................................ 4
Instalación en red ...................................................................................................................................... 6
Requisitos de hardware y software para GeneXus X ............................................................................. 7
Guía rápida de activación de licencias .................................................................................................. 8
Compartir licencias de GeneXus X con versiones anteriores ................................................................. 9
Recursos de GeneXus X ........................................................................................................................ 9
Atención al cliente .................................................................................................................................... 9
Foros ......................................................................................................................................................... 9
Otros recursos de la Comunidad ............................................................................................................... 9
Guía de protección de GeneXus X ...................................................................................................... 10
Licencias concurrentes y Licencias de usuario único .............................................................................. 10
Información general sobre autorización de licencias GeneXus .............................................................. 10
GeneXus Protection Server ..................................................................................................................... 11
Descargar e instalar el GeneXus Protection Server ................................................................................ 11
Uso del GeneXus Protection Server ........................................................................................................ 12
Desinstalar una licencia GeneXus ........................................................................................................... 14
Transferir una licencia GeneXus ............................................................................................................. 15
Más información ..................................................................................................................................... 16
Página 2
Manual de Instalación de GeneXus
Introducción
GeneXus X consta de los siguientes componentes:
Ambiente de Desarrollo
Es un ambiente de desarrollo integrado o Integrated Development Environment (IDE) para diseñar y
prototipar sus aplicaciones independientemente de la plataforma de producción.
Generadores
GeneXus genera código nativo para las principales plataformas. Los generadores disponibles son los
siguientes:
• .Net
• Java
• Ruby
Si desea migrar su Base de Conocimiento de una versión anterior a GeneXus X, lea Conversión a
GeneXus X en las Release Notes.
Por último, en Recursos de GeneXus X encontrará más información acerca del producto y links de
interés a recursos de documentación, soporte, foros, etc.
Página 3
Manual de Instalación de GeneXus
Instalación de GeneXus X
Este capítulo describe los pasos para instalar GeneXus X. Tenga en cuenta que para realizar la
instalación se necesitan privilegios de Administrador.
Instalación independiente: Esta opción instala GeneXus en un disco local o compartido y actualiza su
sistema para lograr el correcto funcionamiento del producto. En este caso, GeneXus se ejecuta sin
necesidad de una conexión de red.
Instalación en red: Esta opción instala GeneXus en un directorio compartido o servidor de red para
que el producto pueda ser utilizado simultáneamente por más de una estación de trabajo. Luego de
finalizar la instalación en red, es necesario ejecutar una instalación llamada Workstation Setup en
cada estación de trabajo.
Instalación independiente
1. Introduzca el DVD de GeneXus X en la unidad de DVD-ROM.
3. Se realizará una verificación de prerrequisitos. En caso de que alguno de los siguientes productos
no se encuentre en la máquina de destino, aparecerá un cuadro de diálogo indicando los prerrequisitos
faltantes: Microsoft Internet Explorer SP1 o superior, Microsoft .NET Framework 2.0 o superior y
Microsoft SQL Server 2005 o 2008 (Express o Standard edition). Los dos primeros son obligatorios
para continuar con la instalación. Sin embargo, podrá continuar con la instalación de GeneXus aunque
no se encuentre una instancia local de SQL Server. En ese caso podrá instalarlo en otro momento o
utilizar una instancia de red.
Página 4
Manual de Instalación de GeneXus
5. En forma opcional puede cambiar la ruta de instalación del producto en el cuadro de diálogo que
se despliega. El directorio por defecto es c:\Archivos de programa\Artech\GeneXus\GeneXusX.
NOTA: No seleccione un directorio ya utilizado por otra versión de GeneXus.
6. A continuación podrá indicar el grupo del Menú Inicio y si desea registrar la configuración
únicamente para su nombre de usuario o para todos los usuarios que compartan la PC.
7. Una vez completada la instalación, se abrirá un cuadro de diálogo con tres opciones: Authorize
GeneXus X (ejecuta el GeneXus License Manager, desde donde puede activar la versión), Run
GeneXus X (inicia GeneXus) y Finish Setup.
Página 5
Manual de Instalación de GeneXus
Instalación en red
La única diferencia entre esta instalación y la instalación independiente es que GeneXus se instala en
un disco del servidor.
Puede ejecutarse desde la consola del servidor o desde cualquier estación de trabajo conectada al
servidor. Requiere permisos totales de escritura sobre el disco del servidor donde se va a instalar.
Workstation Setup
Esta opción debe ejecutarse desde cada estación de trabajo que utilizará una instalación en red de
GeneXus (instalada previamente siguiendo los pasos de la sección anterior).
NOTA: Si el directorio donde está instalada la nueva versión está mapeado como una unidad lógica,
este mapeo debe conservarse luego de ejecutar el Worstation Setup. De lo contrario, la instalación no
funcionará correctamente. También hay soporte para rutas UNC.
4. A continuación podrá indicar el grupo del Menú Inicio y si desea registrar la configuración
únicamente para su nombre de usuario o para todos los usuarios que compartan la PC.
5. Luego de finalizar la instalación aparece un cuadro de diálogo con dos opciones: Run GeneXus
X (inicia GeneXus) y Finish Setup.
No es posible tener más de una versión local, ya que al ejecutar el setup por segunda vez se detecta
la instalación anterior y se muestra un cuadro de diálogo con las siguientes opciones:
Repair/Reinstall y Uninstall GeneXus X. Estas opciones se aplican a la instalación anterior.
Sí es posible tener una instalación local y utilizar otra versión en red, ejecutando el Workstation Setup.
Sin embargo, tenga en cuenta que si trabaja con Windows NT/2000/XP se tomará la configuración de
la última instalación ejecutada.
Sí, es posible. La única restricción es que deben estar instaladas en directorios diferentes.
Página 6
Manual de Instalación de GeneXus
Esta sección contiene los requisitos para generar y ejecutar aplicaciones con los distintos generadores
GeneXus:
Generador Requisitos
Ruby Vea los Requisitos del Generador Ruby en las Release Notes
Página 7
Manual de Instalación de GeneXus
Además, para crear la base de datos y ejecutar las aplicaciones generadas debe tener instalado alguno
de los siguientes DBMS:
Generador DBMS
Ruby • MySQL
La instalación de las claves puede ser local o remota (centralizada), independientemente de dónde se
encuentre instalado el producto. Si las licencias se encuentran centralizadas en un servidor, es
necesario tener el GeneXus Protection Server instalado en ese servidor. Luego de autorizar el
producto, las claves pueden transferirse de una PC a otra (local o remota).
Las claves se solicitan a través del GeneXus License Manager, ubicado en el grupo de programas
GeneXus (uno de los programas del producto o ejecutando el archivo gxlmgr.exe que se encuentra en
el directorio donde está instalado el producto). Permite realizar la solicitud vía web o generar un
archivo conteniendo el/los Site Codes que luego usted deberá enviar por email a su distribuidor local.
Si la solicitud se realiza vía email, es decir enviando el archivo al distribuidor, éste reenviará el archivo
a Artech. Luego, de acuerdo a lo especificado por el distribuidor, Artech enviará un archivo
conteniendo las Site Keys directamente al cliente o al distribuidor.
Si la solicitud se realiza vía web, la misma se envía directamente a Artech y el distribuidor recibe una
notificación para que sea confirmada. Una vez confirmada, Artech enviará la respuesta al distribuidor o
al cliente. Recomendamos solicitar las claves por este medio a fin de obtener mejores tiempos de
respuesta.
La respuesta es un archivo conteniendo las claves (Site Keys) de los componentes solicitados. La
activación se realiza por medio del License Manager.
Por información más detallada acerca de la protección consulte el Guía de protección de GeneXus X o
la Ayuda del License Manager.
Página 8
Manual de Instalación de GeneXus
Para saber cuál es la versión instalada del GeneXus Protection Server, lea la descripción del mismo
en el Panel de Control en Agregar o quitar programas. Si no aparece como GeneXus Protection Server 6.2 debe
desinstalar la versión actual e instalar la versión nueva.
1
– Sólo debe actualizar las licencias de los productos que ya existen en GeneXus X (Development Environment,
generadores Java y .Net). Conserve el resto de las licencias de productos en la versión soportada.
Recursos de GeneXus X
Atención al cliente
Los servicios de Soporte Técnico son proporcionados por Artech y sus distribuidores asociados. Artech
proporciona estos servicios directamente a sus clientes en Brasil, Colombia, España, México, Panamá,
República Dominicana y Uruguay, a todos los distribuidores GeneXus a nivel mundial y a los clientes
que hayan contratado soporte extendido.
Los clientes en el resto del mundo reciben el servicio de sus distribuidores respectivos. Para ver una
lista de distribuidores consulte www.genexus.com/distribuidores.
Si desea más información: www.gxtechnical.com/assistedsupport
Foros
Existen foros públicos relacionados con los distintos temas del mundo GeneXus. Puede suscribirse en
www.gxtechnical.com/forum
Página 9
Manual de Instalación de GeneXus
• Licencias concurrentes: Una Licencia concurrente limita la cantidad de usuarios de red que
utilizan un producto en forma simultánea. En este caso, GeneXus controla la cantidad de PCs
que lo utilizan en un momento dado y fija el límite según la cantidad de usuarios de la licencia
adquirida. Por ejemplo, si usted adquirió 10 licencias concurrentes de un producto, ese
producto podrá ser utilizado por un máximo de 10 usuarios en forma simultánea.
• Licencias de usuario único: En este caso, cada licencia de usuario único se asigna a un
usuario específico, el propietario de la licencia, y sólo el propietario de la misma podrá utilizar
todas las funciones del producto.
• GXquery
• GXflow Client
• GXplorer OLAP
• GXportal Back End Users
Para ver qué tipo de licencia utiliza cada producto, abra el GeneXus License Manager, un utilitario
GeneXus que se instala automáticamente con GeneXus:
• Al autorizar un producto que utiliza licencias de usuario único, usted debe indicar el propietario
de la licencia.
• En la columna Restriction se muestra información sobre la licencia de usuario único. Además,
indica la cantidad de copias no asignadas si el producto posee licencias que aún no se hayan
asignado a ningún usuario.
• El botón Authorized Users está habilitado únicamente cuando la licencia ya fue asignada a un
usuario.
Página 10
Manual de Instalación de GeneXus
adquirido, tales como el GeneXus Development Environment, Generadores GeneXus y otros productos
GeneXus. De lo contrario, aparecerá un error de protección cuando intente utilizar esos componentes
y productos.
Para autorizar una licencia, debe solicitar e instalar un archivo llamado Site Key en la máquina donde
utilizará el producto (instalación local) o en un servidor de licencias (instalación remota). Los archivos
Site Key tienen la extensión gxa.
El proceso para solicitar e instalar Site Keys, también llamado solicitud e instalación de licencias
GeneXus, se realiza utilizando el GeneXus License Manager, un utilitario que se instala
automáticamente con la instalación de GeneXus y cualquier otro producto GeneXus.
Para solicitar una Site Key debe enviar a su distribuidor un código generado por GeneXus llamado Site
Code. Su distribuidor lo procesará y le enviará la Site Key correspondiente.
Antes de solicitar sus Site Keys debe instalar el GeneXus Protection Server en la máquina que actuará
como servidor de licencias. A continuación, utilice el GeneXus License Manager para solicitar una o
más Site Keys, indicando el nombre o dirección IP del servidor en la opción Select Computer.
Recuerde que puede ejecutar el GeneXus License Manager desde cualquier computadora en la red del
servidor de licencias.
El GeneXus Protection Server es un servicio que corre en Windows 2000/XP o superior y proporciona
licencias a cualquier cliente de la red, independientemente de dónde esté instalado el producto (en el
servidor o en cualquier otra PC). Los clientes que accedan a este servicio deben encontrarse en el
mismo dominio. Ya sea que haya instalado GeneXus en forma local o remota, debe ingresar el nombre
o dirección IP del servidor de licencias en la opción Select Computer del License Manager.
Página 11
Manual de Instalación de GeneXus
Utilice este proceso para autorizar una licencia GeneXus en una máquina donde GeneXus se haya
instalado por primera vez, es decir, donde no se hayan instalado otras versiones de GeneXus con
anterioridad a la versión actual.
Para autorizar la licencia GeneXus, siga estos pasos:
Nota: Para seleccionar Remote License debe tener instalado el GeneXus Protection Server en la
computadora que actuará como servidor de licencias. Para más información consulte la Sección 3.
GeneXus Protection Server.
a) Authorize Online: En este caso, la solicitud de licencia se realizará vía web. Para utilizar esta
opción, complete la información solicitada en el formulario web que se abrirá y envíelo.
b) Generate Authorization File: Utilice esta opción si no posee una conexión a Internet en su PC. Esta
opción generará un archivo conteniendo todos los Site Codes correspondientes para sus licencias.
Página 12
Manual de Instalación de GeneXus
Para utilizar esta opción, siga las instrucciones proporcionadas en el Authorization Wizard o asistente
de autorización. Luego deberá enviar el archivo generado a su distribuidor vía email.
6. Luego de recibir la Site Key (archivo gxa) por email, cópiela a su disco duro.
7. Ejecute nuevamente el GeneXus License Manager.
8. Haga clic sobre el botón Authorize y seleccione la opción Enter Licenses. Haga clic en Next.
9. Seleccione la opción Authorize from File y busque el archivo que contiene la Site Key (.gxa).
Página 13
Manual de Instalación de GeneXus
Utilice este proceso para autorizar licencias de actualizaciones de GeneXus, es decir, cuando ya posee
una o más versiones de GeneXus instaladas en su computadora.
Si posee una o más versiones anteriores de GeneXus activadas con GXprotection 2000
(GeneXus 9.0, 8.0, 7.5, 7.0 o 6.1 Patch 5) o con Crypkey Protection (GeneXus 6.1 Patch 4 o
anterior), debe desinstalar esas licencias antes de instalar las nuevas.
1. Desinstale de su PC las licencias GeneXus que desea actualizar. Para hacerlo, siga las instrucciones
proporcionadas en la Sección 6. Desinstalación de licencias GeneXus.
2. Instale las nuevas licencias siguiendo las instrucciones proporcionadas en la Sección 4. Autorización
de licencias GeneXus por primera vez.
3. Para utilizar GeneXus X conjuntamente con una versión anterior de GeneXus (GeneXus 6.1 Patch 5
y superiores), siga estas instrucciones específicas para cada versión:
• Para autorizar la licencia de una nueva versión de GeneXus en una PC donde ya hay una o
más licencias anteriores de GeneXus.
• Para dejar de utilizar algunos componentes GeneXus, tales como un Generador GeneXus, y
continuar utilizando otros componentes. Esto le permite pagar únicamente por el servicio de
Software Assurance de los productos que esté utilizando.
• Para reinstalar Windows o el Windows Registry.
Página 14
Manual de Instalación de GeneXus
• Transferencia directa: Esta opción le permite transferir una o más licencias de una PC de
usuario o Protection Server a otro ubicado en la misma red. El GeneXus Protection Server
debe estar instalado en el servidor de destino.
Página 15
Manual de Instalación de GeneXus
del servidor de destino y la cantidad de copias a transferir. Cuando termine, haga clic en OK.
El proceso para transferir licencias de usuario único difiere del proceso para transferir licencias
concurrentes en que el/los usuarios a transferir deben indicarse en el cuadro de diálogo de
transferencia.
• Transferencia Remota: Esta opción se utiliza para transferir una o más licencias entre dos
máquinas. Puede hacerse entre dos servidores, dos PCs, un servidor y una PC o viceversa.
Más información
Para una descripción detallada de cómo transferir licencias GeneXus, consulte la documentación del
GeneXus Protection Server en la GXDL:
www.gxtechnical.com/gxprotection
Página 16