Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
Startup Ambiente de Desarrollo
Documento de Operaciones
-Documentación Confidencial - 1 -
Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
1. Índice
1. ÍNDICE ......................................................................................................................................................2
2. REVISIÓN.................................................................................................................................................3
3. OBJETIVO................................................................................................................................................4
4. DESCRIPCIÓN DEL PROCESO ..........................................................................................................5
4.1. JDK.........................................................................................................................................................5
4.1.1. INSTALACIÓN EN LINUX ......................................................................................................................5
4.1.2. INSTALACIÓN EN WINDOWS ................................................................................................................7
4.2. ECLIPSE ..................................................................................................................................................7
4.2.1. INSTALACIÓN EN LINUX ......................................................................................................................7
4.2.2. INSTALACIÓN EN WINDOWS ................................................................................................................7
4.3. MYECLIPSE ............................................................................................................................................7
4.3.1. INSTALACIÓN EN LINUX ......................................................................................................................7
4.3.2. INSTALACIÓN EN WINDOWS ................................................................................................................8
4.3.3. GENERACIÓN DE SERIAL .....................................................................................................................8
4.4. AQUA DATASTUDIO ..............................................................................................................................8
4.5. INSTALACIÓN EN LINUX ..........................................................................................................................8
4.6. INSTALACIÓN EN WINDOWS ....................................................................................................................9
4.7. MAVEN ....................................................................................................................................................9
4.7.1. INSTALACIÓN EN LINUX ......................................................................................................................9
4.7.2. INSTALACIÓN EN WINDOWS ..............................................................................................................10
4.8. LDAP STUDIO ......................................................................................................................................11
4.9. TOMCAT................................................................................................................................................12
4.10. JBOSS ................................................................................................................................................12
4.11. CVS...................................................................................................................................................12
4.12. CLIENTE DE MAIL ............................................................................................................................12
4.12.1. INSTALACIÓN EN LINUX ....................................................................................................................12
4.12.2. INSTALACIÓN EN WINDOWS ..............................................................................................................13
4.13. SOFTWARE ESPECÍFICO PARA WINDOWS ......................................................................................13
4.14. PUTTY ................................................................................................................................................13
4.15. WINSCP ............................................................................................................................................14
-Documentación Confidencial - 2 -
Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
2. Revisión
Información de las versiones del documento.
Fecha Versión Detalle Autor
Comité
28/07/2007 1.0.0 Creación del documento.
Arquitectura
-Documentación Confidencial - 3 -
Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
3. Objetivo
Este documento esta destinado a los desarrolladores y arquitectos del
equipo de la Software Factory. Presenta una guía para realizar el proceso
de startup del ambiente de desarrollo de forma completa y apunta a reducir
los tiempos de setup del ambiente.
-Documentación Confidencial - 4 -
Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
4. Descripción del Proceso
El software necesario para realizar el startup del ambiente de desarrollo se
puede encontrar en pc.ba.winit.com.ar dentro del directorio /extra/software.
En caso de no encontrarse en dicha ubicación, se hará referencia del lugar
de donde se puede conseguir.
Además, cabe aclarar que para aquellas aplicaciones cuya instalación
difiere entre los sistemas operativos Linux y Windows, se hace referencia a
ambas instalaciones. Sin embargo, si la instalación es única
independientemente del sistema operativo, esta diferencia no se encuentra
detallada.
4.1. JDK
La versión a instalar es la 1.5.
Sitio de referencia: http://java.sun.com/javase/downloads/index_jdk5.jsp
4.1.1. Instalación en Linux
Para la instalación en Linux utilizaremos el Synaptic Package Manager
Ir a System --> Administration --> Synaptic Package Manager.
Si se debe ingresar el password, es el correspondiente al usuario en el
ldap.
Una vez abierto Synaptic Package Manager, buscar java5
Seleccionar para instalar:
bin
demo
jdk
jre
source
-Documentación Confidencial - 5 -
Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
Probablemente, durante la selección de los componentes a instalar, se
sugiera la instalación de algunas dependencias. Aceptar estas sugerencias
e instalar dichas dependencias también
Luego de seleccionados todos los componentes, aplicar los cambios. Con
esto se mostrará una ventana de confirmación donde se detallan los
componentes a instalar, se debe verificar que en dicha ventana se
encuentre desmarcada la opción Download package files only
Se recomienda no instalar el componente doc debido a que da errores
durante la descarga. En caso de haberlo seleccionado y surgir estos
errores, continuar con la instalación sin este componente y luego
desinstalarlo usando el Synaptic Package Manager.
También se pueden instalar los mismos componentes de alguna versión
posterior.
Nota: En caso de desarrollar un proyecto que dependa de alguna versión
anterior (por ejemplo, jdk1.4) se deben seguir los mismos pasos pero
realizando la búsqueda como j2sdk1.4
Luego de la instalación se deberá comprobar qué versión de java se estará
utilizando el sistema operativo. Seguramente no haya quedado configurada
la versión que acabamos de instalar. Esto lo podemos comprobar con el
siguiente comando:
java -version
Si la versión no es la que instalamos se deberán cambiar algunos links
simbólicos siguiendo los siguientes pasos (se toma como ejemplo la
instalación de java 5):
sudo ln -fs /usr/lib/jvm/java-1.5.0-sun/jre/bin/java
/etc/alternatives/java
sudo ln -fs /usr/lib/jvm/java-1.5.0-
sun/man/man1/java.1.gz /etc/alternatives/java.1.gz
Nuevamente, podemos comprobar la versión utilizada que deberá coincidir
con la instalada:
java -version
-Documentación Confidencial - 6 -
Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
4.1.2.Instalación en Windows
Descargar el archivo jdk-1_5_0_09-windows-i586-p.exe de
/extra/software/windows/development/jdk
Ejecutar:
jdk-1_5_0_09-windows-i586-p.exe
4.2. Eclipse
La versión a instalar es la 3.2.
Sitio de referencia: http://www.eclipse.org/
4.2.1. Instalación en Linux
En particular instalamos la versión 3.2.1.
Descargar el archivo eclipse-SDK-3.2.1-linux-gtk.tar.gz de
/extra/software/linux/development/eclipse
Esta aplicación no requiere de instalación, simplemente se debe
descomprimir el archivo en la ubicación deseada.
4.2.2. Instalación en Windows
En particular instalamos la versión 3.2.2.
Descargar el archivo eclipse-SDK-3.2.2-win32.zip de
/extra/software/windows/development/eclipse
Esta aplicación no requiere de instalación, simplemente se debe
descomprimir el archivo en la ubicación deseada.
4.3. MyEclipse
La versión a instalar es la 5
Sitio de referencia: http://www.myeclipseide.com/
4.3.1. Instalación en Linux
En particular instalamos la versión 5.0.
Descargar el archivo
MyEclipseEnterpriseWorkbenchInstaller_5_0M2_E3_2.bin de
/extra/software/linux/development/myeclipse
Seguir los pasos a partir de la ejecución de:
-Documentación Confidencial - 7 -
Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
./MyEclipseEnterpriseWorkbenchInstaller_5_0M2_E3_2.bin
4.3.2. Instalación en Windows
En particular instalamos la versión 5.1.1 GA.
Descargar el archivo MyEclipse_5.1.1GA_Installer.exe de
/extra/software/windows/development/myeclipse
Seguir los pasos a partir de la ejecución de:
MyEclipse_5.1.1GA_Installer.exe
4.3.3. Generación de Serial
Para la generación de número de serie de MyEclipse se debe descargar el
directorio /extra/software/linux/development/myeclipse/keygen y
ejecutar:
java Keygen
Se solicitará un nombre de usuario, puede ponerse, por ejemplo, el del
equipo. Es importante recordar este nombre porque a partir de el mismo se
genera una clave y son ambos valores los que deben ser utilizados en la
registración de MyEclipse.
Nota: Esta misma operación se puede realizar ingresando a
pc.winit.ba.com.ar por ssh y ejecutando:
cd /extra/software/linux/development/myeclipse/keygen
java Keygen
4.4. AQUA Data Studio
Sitio de referencia: http://www.aquafold.com/
4.5. Instalación en Linux
Descargar el archivo datastudio.tar.gz de
/extra/software/linux/development/database tool/aqua_data_studio
-Documentación Confidencial - 8 -
Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
Esta aplicación no requiere de instalación, simplemente se debe
descomprimir el archivo en la ubicación deseada.
4.6. Instalación en Windows
Descargar el archivo ads-windows-x86-4.7.2.exe de
/extra/software/windows/development/database tool/aqua_data_studio
Seguir los pasos a partir de la ejecución de:
ads-windows-x86-4.7.2.exe
4.7. Maven
Sitio de referencia: http://maven.apache.org/download.html
4.7.1.Instalación en Linux
Descargar el archivo maven-2.0.7-bin.zip de /extra/software/java/maven
Descomprimir el archivo maven-2.0.7-bin.zip en la ubicación donde se
desee instalar Maven. Estas instrucciones asumen que se seleccionó el
directorio home del usuario.
Al descomprimir este archivo, se creará el directorio maven-2.0.7. Se
recomienda renombrarlo como maven debido a que dentro del mismo se
podrán colocar, luego, nuevas versiones del producto sin necesidad de
cambios adicionales.
Agregar en /home/<username>/.bachrc el directorio bin de Maven a la
variable de ambiente PATH:
export PATH=/home/<username>/maven/bin:$PATH
Asegurarse que la variable de ambiente JAVA_HOME se encuentra
seteada en /home/<username>/.bachrc con la ubicación del JDK:
echo $JAVA_HOME
Si la misma no está seteada o es incorrecta, setearla con el path del JDK
(en el ejemplo se supone /usr/lib/jvm/java-1.5.0-sun/):
-Documentación Confidencial - 9 -
Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun/
El último paso, entonces, es verificar que se ha instalado correctamente
con el siguiente comando:
mvn --version
Solo queda configurarlo, para ello se puede, directamente, tomar el archivo
settings.xml que se encuentra en /extra/software/java/maven. Este archivo
debe ser copiado al repositorio local: /home/<username>/.m2
Para el uso del repositorio local con Eclipse será necesario contar con un
directorio no oculto (.m2 no será útil en este caso). Por lo tanto, se deberá
crear un link simbólico de la siguiente forma:
ln -fs /home/<username>/.m2 /home/<username>/m2
4.7.2.Instalación en Windows
Descargar el archivo maven-2.0.7-bin.zip de /extra/software/java/maven
Descomprimir el archivo maven-2.0.7-bin.zip en la ubicación donde se
desee instalar Maven. Estas instrucciones asumen que se seleccionó el
directorio C:\Program Files\.
Al descomprimir este archivo, se creará el directorio maven-2.0.7. Se
recomienda renombrarlo como maven debido a que dentro del mismo se
podrán colocar, luego, nuevas versiones del producto sin necesidad de
cambios adicionales.
Agregar el directorio bin de Maven a la variable de ambiente PATH:
C:\Program Files\maven\bin";%PATH%
Asegurarse que la variable de ambiente JAVA_HOME se encuentra
seteada con la ubicación del JDK (en el ejemplo se supone C:\Program
Files\Java\jdk1.5.0_02):
C:\Program Files\Java\jdk1.5.0_02
-Documentación Confidencial - 10 -
Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
El último paso, entonces, es verificar que se ha instalado correctamente
con el siguiente comando:
mvn --version
Solo queda configurarlo, para ello se puede, directamente, tomar el archivo
settings.xml que se encuentra en /extra/software/java/maven. Este archivo
debe ser copiado al repositorio local: C:\Documents and
Settings\<username>\.m2
4.8. LDAP Studio
Sitio de referencia: http://directory.apache.org/studio/ldap-browser-
plugin-standalone-installation.html
Para instalar el plugin de LDAP Studio para Eclipse se deberá ingresar a
Eclipse y seleccionar la opción del menú Help --> Software Updates -->
Find and Install.
En el wizard seleccionar Search for new features to install y hacer click
en Next .
Luego se debe especificar el sitio Apache Directory Studio. Para esto,
hacer click en New Remote Site.
Completar los siguientes datos y aceptarlos:
Name: Apache Directory Studio Update Site
URL: http://directory.apache.org/studio/update/
Asegurarse que el nuevo sitio de actualización (LDAP Studio Update Site)
esté seleccionado y presionar Finish
Seleccionar el componente Apache Directory Studio Update Site y hacer
click en Next.
Aceptar la licencia.
En la próxima ventana, asegurarse que está seleccionado el componente
LDAP Studio Browser y hacer click en Finish.
Para confirmar la instalación, hacer click en Install All.
Luego de la instalación se recomienda reiniciar Eclipse.
-Documentación Confidencial - 11 -
Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
4.9. Tomcat
Sitio de referencia: http://tomcat.apache.org/
Descargar el archivo apache-tomcat-5.5.23.zip de /extra/software/java/tomcat
Esta aplicación no requiere de instalación, simplemente se debe descomprimir el
archivo en la ubicación deseada.
4.10. JBoss
Sitio de referencia: http://labs.jboss.com/ (ex http://jboss.org/)
Descargar el archivo jboss-4.2.1.GA.zip de /extra/software/java/jboss
Esta aplicación no requiere de instalación, simplemente se debe descomprimir el
archivo en la ubicación deseada.
4.11. CVS
Como cliente de CVS utilizamos Eclipse. La configuración correspondiente en el
mismo es la siguiente:
Host: hulk.ba.winit.com.ar
Repository path: /home/cvs/winit
User: usuario del ldap
Password: password del usuario en ldap
Connection type: extssh
Port: por defecto
Nota: En Winit existen otros repositorios. Solo se aclaran por si fuera
necesario conectarse a los mismos. Estos son /home/cvs/repository y
/home/cvs/movistar
4.12. Cliente de Mail
4.12.1. Instalación en Linux
Como cliente de mail para Linux utilizaremos Thunderbird y la instalación
la realizaremos por medio de Synaptic Package Manager
-Documentación Confidencial - 12 -
Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
Ir a System --> Administration --> Synaptic Package Manager.
Si se debe ingresar el password, es el correspondiente al usuario en el
ldap.
Una vez abierto Synaptic Package Manager, buscar thunderbird
Seleccionar para instalar:
mozilla-thunderbird
y aplicar los cambios.
4.12.2. Instalación en Windows
Con la instalación de Windows, se habrá instalado Outlook como cliente de
mail y será este mismo el que se utilizará.
Datos de Configuración:
Una vez instalado el cliente de mail correspondiente, se deberá crear una
nueva cuenta de correo electrónico con la siguiente configuración.
Nombre y apellido del usuario
Dirección de correo electrónico:
<username>@winit.com.ar
Tipo de servidor entrante: POP
Nombre del servidor entrante: winit.com.ar
Nombre del servidor saliente: winit.com.ar
Nombre de usuario: <username>@winit.com.ar
Nombre de cuenta: Cualquier nombre que la identifique
4.13. Software Específico para Windows
4.14. Putty
Descargar el archivo putty.exe de /extra/software/windows/utilities/putty
Esta aplicación no requiere de instalación, simplemente se debe copiar el
archivo en la ubicación deseada.
-Documentación Confidencial - 13 -
Document Name Software Configuration
WINIT Startup Ambiente Desarrollo Management
1.0
Author
WINIT
4.15. WinSCP
Descargar el archivo winscp382setup.exe de
/extra/software/windows/utilities/winSCP
Seguir los pasos a partir de la ejecución de:
winscp382setup.exe
-Documentación Confidencial - 14 -