View source for How to Migración RT 3.6.6 to 4.01

[[File:Placeholder|right|300px]]

=='''Migracion rt 3.6.6 a 4.0'''==


==='''PreRequisitos, ''''''Ambiente BD con mysql'''===
Se necesitara un espacio para manipular los datos, este corresponde al doble del peso del Backup



==='''Instalaciones Previas'''===


 Actualizacion sistema Operativo
 
 Apt-get update
 
 Apt-get upgrade


'''Instalacion APACHE'''

Apache 2.X http://apache.org

*Para instalar hacer:
 apt-cache search Apache2
 
 una vez muestre las versions disponibles
 
 
 apt-get install apache2

*Editar archive configuracion


 ubicado en: <span lang="ES-TRAD" style="font-size:9.0pt;font-family: "Courier New";color:black">/etc/apache2/apache2.conf</span>
 
 
 incorporando la siguiente línea    '''LimitRequestLine 5000'''
*Esta sirve para <span lang="ES-TRAD" style="font-family:"Arial","sans-serif"; color:#222222">Directiva permite que el administrador del servidor para reducir o aumentar el límite en el tamaño permitido de un cliente </span>


*

Reiniciar apache, probar funcionamiento escribiendo la url de la maquina en el navegador
'''''Instalacion MOD_PERL'''''
 apt-cache search mod_perl
 
 
 apt-get install <span lang="EN-US" style="font-size: 9.0pt;font-family:"Courier New";color:black;mso-ansi-language:EN-US">libapache2-mod-perl2
 </span>
 
 <span lang="EN-US" style="font-size:9.0pt;font-family:"Courier New";color:black;mso-ansi-language: EN-US">Reiniciar apache
 </span>
 
 Service apache2 restart
'''Instalacion mysql cliente'''
 apt-cache search mysql
 
 
 
 
 una vez muestre las versions disponibles
 
 
 apt-get install mysql-client
 
 
 ''' '''
'''Instalacion PERL'''

Instalación de Perl 5.8.3. o posterior se descarga de [http://www.perl.com www.perl.com]


Consultar si está instalado con:

 perl-v
Para instalar hacer:

 apt-cache search Perl
Una vez muestre las versions disponibles

 apt-get install [nombre paquete]

'''Comienzo Migracion Servicio RT'''
Antes de comenzar la migración el servicio Apache deberá ser detenido, junto con el servicio de correo electrónico. Esto para asegurar que no llegaran nuevos datos a la BD mientras se respalden los datos del sistema.
Para detener los servicios podemos ejecutar los siguientes comandos:
 [ /etc/init.d/apache2 stop ]
 
 [ /etc/init.d/postfix stop ]
 
 
 NOTA''':'''lasinstrucciones de éste documento deben hacerse con perfil de administrador(sudo), lo anterior se puede realizar anteponiendo la instrucción sudo e
 incorporando la contraseña del usuario, o digitando sudo –s y contraseña.



==='''Regularizacion Base de Datos Produccion'''===


Durante el laboratorio se detectaron algunos registros que contienen caracteres que generan problemas en la etapa de actualización de esquema en la BD del sistema.
*Realizar revisión del campo “Name” de la tabla Users, para los usuarios que contengan la letra “ñ”.<span class="Apple-tab-span" style="white-space: pre; "> </span>Para detectar los registros utilizaremos la <span class="Apple-tab-span" style="white-space: pre; "> </span>siguiente query:
 [SELECT * FROM Users U where U.Name like "%ñ%";]
*Regularizar los campos detectados.
*Realizar revisión del campo Name de la tabla Users, para los usuarios que contengan acentos.Para detectar los registros utilizaremos la siguiente <span class="Apple-tab-span" style="white-space: pre; "> </span>query:
 [SELECT * FROM Users U where U.Name like "%á%" or U.Name like "%é%" or U.Name like "%í%" or U.Name like "%ó%" or U.Name like "%ú%";]
*Regularizar los campos detectados.


==='''Software y Estructura de Directorio'''===
Para más seguridad en la migración, deberemos descargar la aplicación RT 4.0.1 y realizar una instalación limpia de ella.
Para lo anterior ocuparemos el siguiente comando:

 [WGET  http://download.bestpractical.com/pub/rt/release/rt-4.0.1.tar.gz]
 
 [Tar -xvf 'path']



==='''Respaldo Base de Datos de Produccion'''===
El primer paso para comenzar con la migración del sistema RT 3.6.6 a la version RT 4.0.1, es el respaldo de la base de datos de producción y restaurarla en el nuevo ambiente.
*El backup se deberá realizar con el siguiente comando:
 [mysqldump -u root -p -h direccion_ip_host --skip-extended-insert --default-character-set=binary --databases rtdb_name --add-drop-database  | gzip > /datos/dump.sql.gz]
*Luego editamos el archivo de backup , cambiando el nombre de la base de datos, en el caso que desee cambiar el nombre de la Bse de datos, en este caso rtdb es el nomnre antiguo y rt4 es el nombre nuevo
 [cat /datos/dump/dump.sql |sed 's/rtdb/rt4/g' > /datos/dump/dumprt4.sql]
*Luego Restauramos el backup realizado desde la Base de datos de producción en el Nuevo ambiente:
 [mysql -u root -p'password' rtdb < /datos/dump.sql]



==='''Instalacion Limpia RT4.01'''===


se debe instalar compilador GCC
 apt-get install gcc
Realizaremos una instalación limpia de RT 4.0.1 , para la cual seguiremos los siguientes pasos:
*Crear directorio para rt4
 [mkdir /usr/local/rt4]
*Ejecutar ./configure para instalación limpia de RT 4.0.1
 [Apt-get install gcc (Compilador)]
 
 [./configure --prefix=/usr/local/rt4]
*Ejecutar config Cpan
 [/usr/bin/perl -MCPAN -e shell]
*Actualizamos CPAN
 [install Bundle::CPAN]
*Una vez actualizado CPAN , ejecutamos
 [reload cpan]
 
 [reload index]
 
 Nota: Presionar si a todo
 
 [./configure --enable-graphviz --enable-gd]
*Revisar dependencia que faltan, con el comando
 [Make testdeps ]
*Instalar dependencias que faltan
 [Make fixdeps]
 
 NOTA: Las dependencias que no se instalan en forma automática las debemos instalar de forma manual.
*Instalación manual de dependencias faltantes
 [Apt-get install  libnet-smtp-ssl-perl]
 
 [Apt-get install libdatetime-locale-perl]
 
 [Apt-get install libhtml-mason-perl]
 
 [Apt-get install libxml-rss-perl]
 
 [Apt-get install liblog-dispatch-perl]
 
 [Apt-get install libcgi-application-basic-plugin-bundle-perl]
 
 [Apt-get install liblog-dispatch-filerotate-perl]
 
 [Apt-get install libgd-graph3d-perl]
 
 [Apt-get install libgraphviz-perl]
*Luego revisamos que no queden dependencias pendientes.
[Make fixdeps]

*Crear carpeta para log

 [Mkdir /var/log/rt]


*Dar Permisos

 Chmod –R 775 /var/log/rt
*Ejecutar compilación
 [Make install]




==='''Actualizacion Esquema Base de Datos'''===


Los siguientes pasos deberemos realizarlos cuidadosamente porque podrían implicar perdida de datos en nuestra BD, se recomienda realizar backup
Para la actualización del esquema, ejecutaremos el siguiente procedimiento:
*Copiar directorio upgrade desde el fuente (instalador rt 4.0.1) hacia la nueva instalación en la siguiente ruta antes creada
 [cp /rt-4.0.1/etc/upgrade (Ruta instalador) hacia  /usr/local/rt4/etc/upgrade/]
*Copiar contenido del antiguo RT_SiteConfig.pm al nuevo RT_SiteConfig.pm en la instalación de RT4
*Configurar los parámetros en el archivo RT_SiteConfig.pm ,para acceder a la base de datos rt4.
*Ejecutar comando desde la siguiente ruta /usr/local/rt4
 [./rt-setup-database   --prompt-for-dba-password --action upgrade]
'''NOTA: Este comando solicitara ingresar los siguientes parámetros cada vez que se ejecute'''
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar versión Rt origen :  3.6.6 
 
 Ingresar versión Rt Destino : 3.7.1
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.7.1
 
 Ingresar versión Rt Destino : 3.7.10
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.7.10 
 
 Ingresar versión Rt Destino : 3.7.19
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.7.19 
 
 Ingresar versión Rt Destino : 3.7.81
 
 ------------------------------------------------------------------------------
*Ejecutar upgrade de schema BD desde la carpeta del instalador
 [Cd /home/sparada/rt-4.0.1]
 
 [perl etc/upgrade/upgrade-mysql-schema.pl db user pass > queries.sql]
*El comando anterior generara un archivo “queries.sql”, el cual deberemos revisar, si está todo bien pasamos al siguiente paso.
*Ejecutar
 [mysql -urt_user -p'pasword' rt4 < queries.sql]
*Ejecutar limpieza membergroups (se aplica en la versión 3.7.87)
 [perl -I /usr/local/rt4/local/lib -I /usr/local/rt4/lib /home/sparada/rt-4.0.1/etc/upgrade/shrink_cgm_table.pl]
*Upgrade extension ical
 [/usr/local/rt4/etc/upgrade/3.8-ical-extension ]
*Continuar Actualización
 [ cd /usr/local/rt4]
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.7.87
 
 Ingresar versión Rt Destino : 3.8.0
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.8.0
 
 Ingresar versión Rt Destino : 3.8.1
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.8.1
 
 Ingresar versión Rt Destino : 3.8.2
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.8.2
 
 Ingresar versión Rt Destino : 3.8.3
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.8.3
 
 Ingresar versión Rt Destino : 3.8.4
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.8.4
 
 Ingresar versión Rt Destino : 3.8.5
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.8.5
 
 Ingresar versión Rt Destino : 3.8.6
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.8.6
 
 Ingresar versión Rt Destino : 3.8.8
 
 ------------------------------------------------------------------------------
*Actualización para contraseñas Vulnerables, ejecutar
 [cd/home/sparada/rt-4.0.1]
 
 [perl etc/upgrade/vulnerable-passwords --fix to upgrade]
*Eliminación de transacciones innecesarias, sin perder funcionalidad
 [cd  /home/sparada/rt-4.0.1/]
 
 [perl -I /usr/local/rt4/lib -I /usr/local/rt4/lib etc/upgrade/shrink_transactions_table.pl]
*Continuar Actualización
 [ cd /usr/local/rt4]
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.8.8
 
 Ingresar versión Rt Destino : 3.8.9
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.8.9
 
 Ingresar versión Rt Destino : 3.9.1
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.9.1
 
 Ingresar versión Rt Destino : 3.9.2
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.9.2
 
 Ingresar versión Rt Destino : 3.9.3
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.9.3
 
 Ingresar versión Rt Destino : 3.9.5
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.9.5
 
 Ingresar versión Rt Destino : 3.9.6
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.9.6
 
 Ingresar versión Rt Destino : 3.9.7
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  3.8.8
 
 Ingresar versión Rt Destino : 4.0.0rc2
 
 ------------------------------------------------------------------------------
*Soluciona registros duplicados.
 [/usr/local/rt4/sbin/rt-validator --check --resolve]
 
 ------------------------------------------------------------------------------
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  4.0.0rc2
 
 Ingresar versión Rt Destino : 4.0.0rc4
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  4.0.0rc4
 
 Ingresar versión Rt Destino : 4.0.0rc7
 
 ------------------------------------------------------------------------------
 
 ./rt-setup-database   --prompt-for-dba-password --action upgrade
 
 Ingresar Password base datos
 
 Ingresar versión Rt origen :  4.0.0rc7
 
 Ingresar versión Rt Destino : 4.0.1
 
 ------------------------------------------------------------------------------
'''NOTA: En este paso ya tenemos nuestro rt 3.6.6 actiualizado a RT4.01'''
Ahora deberemos subir el el servidor apache y el servidor de correo

'''Configuracion Apache'''



Para este laboratorio se creó la siguiente configuración apache, el servidor de desarrollo test.cl
 ------------------------------------------------------------------------------
 
 DocumentRoot /usr/local/rt4/share/html
 
 Alias /NoAuth/images/ /usr/local/rt4/share/html/NoAuth/images/
 
 <Directory "/usr/local/rt4/share/html">
 
     Options Indexes FollowSymLinks
 
     AllowOverride None
 
     Order allow,deny
 
     Allow from all
 
     satisfy any
 
     AddDefaultCharset UTF-8
 
     SetHandler modperl
 
     PerlResponseHandler Plack::Handler::Apache2
 
     PerlSetVar psgi_app /usr/local/rt4/sbin/rt-server
 
 </Directory>
 
 ------------------------------------------------------------------------------



==='''Subida de Servicio'''===


Finalmente subimos nuestros servicios
 [ /etc/init.d/apache2 start ]
 
 [ /etc/init.d/postfix start ]
Y por fin tenemos nuestro RT 4.01 !!! , funcionando .
'''espero les sea de utilidad'''

'''proseba@gmail.com'''

'''sparada@uc.cl'''