Circuito de

Migracin

Excelsis S.A.C.I.G.

Circuito de Migracin Oracle 11g

CONTENIDO
PARTE I. INSTALACION DE HERRAMIENTAS ...................................................................................................................... 2
CONFICURACIONES DEL SISTEMA OPERATIVO ............................................................................................................. 2
INSTALACION DEL WEBLOGIC. ...................................................................................................................................... 4
INSTALACION DE FORMS Y REPORT BUILDER. ............................................................................................................ 10
INSTALAR JDK. ............................................................................................................................................................. 17
CONFIGURACION DEL JAVA. ....................................................................................................................................... 17
PARTE II. PROCESO DE MIGRACION. ............................................................................................................................... 18
CONFIGURACION DEL ASISTENTE DE MIGRACION. .................................................................................................... 18
CONFIGURACION DE RED DE ORACLE......................................................................................................................... 18
EJECUCION DEL ASISTENTE DE MIGRACION(MIGRACION DE LIBRERIAS, MENUES Y FORMULARIOS). ..................... 19
MIGRACION DE REPORTES. ......................................................................................................................................... 22
PARTE III. CONFIGURACION DEL WEBUTIL. .................................................................................................................... 23
CLASES JAVA Y LIBRERIAS. ........................................................................................................................................... 23
IMPLEMENTACION DE WEBUTIL Y RP2RRO EN EL FORMS. ........................................................................................ 23
PARTE IV. CONFIGURACION DEL WEBLOGIC EN TIEMPO DE EJECUCION. ...................................................................... 26
CONFIGURACION DE ENTORNO. ................................................................................................................................. 26
CONFIGURACION WEB. ............................................................................................................................................... 26
LEVANTAR SERVICIOS.................................................................................................................................................. 27
CONFIGURACION DEL SERVIDOR DE REPORTES. ........................................................................................................ 27
URL PARA EL DESPLIEGUE. .......................................................................................................................................... 29
ICONOS. ....................................................................................................................................................................... 30

pg. 1

Circuito de Migracin Oracle 11g

PARTE I. INSTALACION DE HERRAMIENTAS

CONFICURACIONES DEL SISTEMA OPERATIVO
Acceder al archivo Host de Windows y asociar el nombre del equipo a su IP.

*Ubicacin del archivo Host C:\WINDOWS\system32\drivers\etc

Definir memoria virtual.

1.
2.
3.
4.
5.
6.
7.

Propiedades de sistema (Click derecho MiPC/Equipo -> Propiedades).

Pestaa de Opciones avanzadas.
Botn Configuracin de Rendimiento -> Pestaa Opciones avanzadas.
Botn Cambiar Memoria Virtual.
Seleccionar Opcin Tamao personalizado.
Definir Tamao inicial 2046 MB. y Tamao mximo 4092 MB.
Botn Establecer.
pg. 2

Circuito de Migracin Oracle 11g

8. Botn Aceptar.
Desactivar Firewall.

*Tambin desactivar Antivirus.

pg. 3

Circuito de Migracin Oracle 11g

INSTALACION DEL WEBLOGIC.
Ejecutar el Instalador.

Definir Directorio de Instalacin del Middleware.

pg. 4

Circuito de Migracin Oracle 11g

Desactivar Opcin de Recibir actualizaciones de seguridad a travs de My Oracle Support.

Seleccionar Tipo de instalacin Personalizada.

pg. 5

Circuito de Migracin Oracle 11g

Desactivar componentes de Oracle Coherence y Oracle Enterprise Pack for Eclipse.

Seleccin de JDK, marcar ambos.

pg. 6

Circuito de Migracin Oracle 11g

Definir directorio del Weblogic Server.

No instalar como servicio de Windows.

pg. 7

Circuito de Migracin Oracle 11g

Seleccionar Opcin para Todos los Usuarios.

Resumen de la Instalacin.

pg. 8

Circuito de Migracin Oracle 11g

Proceso de Instalacin.

Desactivar el Quickstar y Listo.

pg. 9

Circuito de Migracin Oracle 11g

INSTALACION DE FORMS Y REPORT BUILDER.
Ejecutar Instalador.

Seleccionar Opcin, Omitir Actualizaciones de Software.

pg. 10

Circuito de Migracin Oracle 11g

Seleccionar Opcin Instalar y Configurar.

Comprobar Requisitos.

pg. 11

Circuito de Migracin Oracle 11g

Seleccionar directorio donde se instal el Middleware, Weblogic Server y definir el Home de Oracle,
Instancia de Oracle.

Seleccionar Configuracin para Desarrollo.

pg. 12

Circuito de Migracin Oracle 11g

Insertar Contrasea. Default: oracle123

*No se recomienda cambiar el nombre de usuario por defecto.

Desactivar Opcin de Recibir actualizaciones de seguridad a travs de My Oracle Support.

pg. 13

Circuito de Migracin Oracle 11g

Seleccionar elementos de Entorno de Desarrollo de Oracle Forms y Oracle Reports 11gR2.

Seleccionar Opcin, Configuracin Automtica de Puertos.

pg. 14

Circuito de Migracin Oracle 11g

Seleccionar Opcin, No Utilizar valores de Proxy.

Resumen de Instalacin.

pg. 15

Circuito de Migracin Oracle 11g

Proceso de Instalacin.

Consta de 2 partes, la segunda es la Configuracin.

*Esta parte puede tardar algunos minutos o puede tardar bastante ms.
pg. 16

Circuito de Migracin Oracle 11g

Instalacin Terminada.

INSTALAR JDK. *Versin recomendada jdk-6u25.

CONFIGURACION DEL JAVA.
Ingresar a la pestaa Avanzado del panel de control de Java.
Desmarcar la opcin. Activa el Java Plug-in de nueva generacin.
Seleccionar opcin Deshabilitar verificacin en la seccin de Seguridad.

pg. 17

Circuito de Migracin Oracle 11g

PARTE II. PROCESO DE MIGRACION.

CONFIGURACION DEL ASISTENTE DE MIGRACION.
Acceder al archivo frmplsqlconv.bat ubicado en el directorio C:\Oracle\Middleware\asinst_1\bin. En este archivo se
encuentran las variables de entorno que el Asistente de Migracin tomara a momento de su ejecucin.
A la variable FORMS_PATH agregamos el directorio donde se encuentran los programas a ser migrados.
set FORMS_PATH=%FORMS_PATH%;C:\Oracle\Middleware\Oracle_FRHome1\forms;<directoriodefuentes>
Y por debajo definir la variable NLS_LANG que contendr el valor de nuestro juego de caracteres.
REM Set up NLS_LANG
set NLS_LANG=SPANISH_SPAIN.WE8ISO8859P1
*En el ejemplo se ve que se utiliza el characterset WE8ISO8859P1 que tiene menos caracteres que el
W8MSWIN1252, pero al diferencia del ltimo es multiplataforma.
CONFIGURACION DE RED DE ORACLE.
Ejecutar el script Netca ubicado en el directorio C:\Oracle\Middleware\Oracle_FRHome1\bin.

En primer lugar seleccionar opcin Configuracin del Listener y crear uno, que ms tarde servir en el tiempo de
ejecucin para acceder a la aplicacin en modo local. En segundo lugar seleccionar Configuracin del Nombre del
Servicio de Red Local para agregar un servicio de base de datos al cual poder conectar el asistente de migracin, las
herramientas de desarrollo y realizar el despliegue de la aplicacin en modo local.
Estos archivos ya creados se almacenaran en el directorio de configuracin de la instancia de Oracle.
C:\Oracle\Middleware\asinst_1\config

pg. 18

Circuito de Migracin Oracle 11g

EJECUCION DEL ASISTENTE DE MIGRACION(MIGRACION DE LIBRERIAS, MENUES Y FORMULARIOS).
Crear un archivo .bat con el siguiente comando y luego ejecutarlo.
Start C:\Oracle\Middleware\asinst_1\bin\frmplsqlconv.bat mode=wizard

Botn Add Module(s).

pg. 19

Circuito de Migracin Oracle 11g

Seleccionar los programas a migrar.

*Siempre tomar en cuenta que el orden de los programas a ser migrados debe ser en primer lugar libreras, en
segundo lugar mens y en tercer lugar formularios.

Una vez anexados, presionar botn Siguiente.

pg. 20

Circuito de Migracin Oracle 11g

Seleccionar opcin para que se genere un log por cada programa, luego presionar botn de opciones
avanzadas y definir el DESFORMAT por defecto como pdf.

Resumen de Migracin presionar botn Terminar. Introducir usuario/contrasea@basededatos y presionar

Aceptar.

pg. 21

Circuito de Migracin Oracle 11g

Proceso de Migracin

Durante el proceso, va mostrando cada log generado que tambin se encuentran en el directorio de las fuentes,
pero desde aqu ya se puede ver un vistazo rpido si la migracin presento errores.
MIGRACION DE REPORTES.
Ejecutar el Reports Builder.
Recompilar los reportes.

pg. 22

Circuito de Migracin Oracle 11g

PARTE III. CONFIGURACION DEL WEBUTIL.

CLASES JAVA Y LIBRERIAS.
Copiar los archivos webutil.pll, webutil.olb, rp2rro.pll en el directorio donde se encuentran las fuentes a
migradas.
Tener en cuenta que los archivos webutil.pll, webutil.olb, rp2rro.pll ya se encuentra en el directorio
C:\Oracle\Middleware\Oracle_FRHome1\forms que por defecto dicho directorio est definido en el
FORMS_PATH, estos archivos deben ser reemplazados por los que se encuentran en el directorio de las
fuentes migradas.
Copiar la clase de java Jacob.jar al directorio C:\Oracle\Middleware\Oracle_FRHome1\forms\java.
Copiar los DLLs de Jacob.
o jacob-1.14.3-x86.dll al directorio C:\Oracle\Middleware\Oracle_FRHome1\forms\webutil\win32.
o jacob-1.14.3-x64.dll al directorio E:\OraclrFrm11.2\webutil112\win64.
IMPLEMENTACION DE WEBUTIL Y RP2RRO EN EL FORMS.
Se debe implementar webutil en el caso que el programa contenga procedimientos, funciones las cuales
necesiten ser procesadas del lado del cliente o cuando se deseen usar las funcionalidades propias que trae consigo la
librera webtil.

Copiar el directorio donde se encuentran las fuentes migradas al inicio de las variables de registro
FORMS_PATH y REPORTS_PATH.

Abrir la librera de objetos para cargarla al Oracle Forms, luego abrir el formulario al cual se le implementara
weblogic.

pg. 23

Circuito de Migracin Oracle 11g

Cargar las libreras webutil.pll y rp2rro.pll segn se requieran.

Acceder a los elementos de la librera de objetos hacindole doble clic sobre la misma y mueve los
elementos de la librera al formulario.

*Los elementos pueden ser copiados o crearlos como subclase, segn se prefiera.
*Todos los elementos del webutil se deben situar al final de cada seccin.

pg. 24

Circuito de Migracin Oracle 11g

Cambiar las unidades de programa text_io por client_text_io, tool_env por client_tool_env y host por
client_host.
Es necesario establecer un estndar en el nombre de los programas y la llamada de nombres de los
programas, definirlos todos en minsculas.
En el caso en que el formulario llame a algn reporte se puede ver que el asistente de migracin ya anexo
algunos parmetros y tambin reemplazo todas las sentencias run_product por rp2rro.r2rro_run_product.

Para definir DESFORMAT, DESNAME, DESTYPE se deben utilizar las funcionalidades de la librera
rp2rro.pll(RP2RRO.SETDESFORMAT, RP2RRO.SETDESNAME, RP2RRO.SETDESTYPE) y ya no se define SCREEN
como DESTYPE ya que esta opcin viene por defecto.
Para definir el servicio de reporte se utiliza la sentencia RP2RRO.SETREPORTSSERVER(NombreDelServicio).
Tambin se pueden definir los puntos anteriores en la paleta de propiedades del elemento RP2RRO en la
seccin de INFORMES.

pg. 25

Circuito de Migracin Oracle 11g

PARTE IV. CONFIGURACION DEL WEBLOGIC EN TIEMPO DE EJECUCION.

CONFIGURACION DE ENTORNO.
Ingresar al directorio
C:\Oracle\Middleware\user_projects\domains\ClassicDomain\config\fmwconfig\servers\AdminServer\appli
cations\formsapp_11.1.2\config
Generar otro archivo de entorno partiendo del existente default.env.
Agregar el directorio en el cual se encuentran las fuentes migradas en la variable FORMS_PATH, y tambin
crear una variable NLS_LANG con el mismo valor utilizado anteriormente.

*Se pueden crear adems otras variables como ORACLE_SID, TWO_TASK para definir la base de dato de
conexin por defecto y FORMS_USERNAME_CASESENSITIVE para definir que el usuario y la clave de
conexin sea sensible a maysculas y minsculas.
CONFIGURACION WEB.
En el mismo directorio editar el archivo formsweb.cfg.
Ir al final del archivo de configuracin, copiar y volver a pegar la seccin de [webutil].
Renombrar la seccin copiada como se desee y agregar otros parmetros como se explica en el ejemplo.
[Prueba]
envFile=prueba.env
form=formularioinicial.fmx
SeparateFrame=true
Width=100%
Heigth=100%
Term= C:\Oracle\Middleware\asinst_1\config\FormsComponent\forms\fmrpcweb.res
pageTitle=Titulodelsistema
WebUtilArchive=frmwebutil.jar,jacob.jar
WebUtilLogging=off
WebUtilLoggingDetail=normal
WebUtilErrorMode=Alert
WebUtilDispatchMonitorInterval=5
WebUtilTrustInternal=true
WebUtilMaxTransferSize=16384
baseHTML=webutilbase.htm
baseHTMLjpi=webutiljpi.htm
archive=frmall.jar
lookAndFeel=oracle

pg. 26

Circuito de Migracin Oracle 11g

LEVANTAR SERVICIOS.
Crear un archivo boot.properties en el directorio
C:\Oracle\Middleware\user_projects\domains\ClassicDomain\servers\AdminServer\security debe contener
el nombre de usuario y contrasea de la siguiente forma.

*La funcin del archivo es indicar el usuario y contrasea cada vez que se levantan los servicios del Weblogic.
*El archivo se encripta luego de la primera vez que se levantan los servicios.
Crear un archivo .bat con el cual se ejecutaran los servicios del Node Manager y el Weblogic. Escribir en el
los comandos:
start C:\Oracle\Middleware\wlserver_10.3\server\bin\startNodeManager.cmd
start C:\Oracle\Middleware\user_projects\domains\ClassicDomain\bin\startWebLogic.cmd
exit

CONFIGURACION DEL SERVIDOR DE REPORTES.

Crear el servicio del Servidor de Reportes con la siguiente sintaxis.
opmnctl.bat createcomponent -adminUsername <1> -adminHost <2> -adminPort <3> -oracleHome <4>
-oracleInstance <5> -instanceName <6> -componentName <7> -componentType <8>
1. Usuario del weblogic.
2. Equipo donde se aloja el weblogic y donde se creara el servicio de reportes.
3. Puerto del weblogic.
4. Directorio donde se encuentra el home de Oracle.
5. Directorio donde se -encuentra la instancia de Oracle.
6. Nombre de la instancia de Oracle.
7. Nombre que se le da al servicio de reportes.
8. Tipo de componente.

pg. 27

Circuito de Migracin Oracle 11g

Con el comando opmnctl.bat status se puede ver el estado de los servicios de reportes.

Comandos para subir y bajar sevicios de reportes.

o Levantar todos los servicios: opmnctl.bat startall
o Bajar todos los servicios: opmnctl.bat stopall
o Levantar un solo servicio: opmnctl.bat startproc ias-component=NombreDelServicio
o Bajar un solo servicio: opmnctl.bat stopproc ias-component=NomdeDelServicio

Aadir el directorio donde se encuentran las fuentes migradas en la variable REPORTS_PATH del archivo
reports.bat que se encuentra en el directorio C:\Oracle\Middleware\asinst_1\config\reports\bin. Tambin
se pueden agregar ms variables en el archivo, como NLS_LANG y NLS_DATE_FORMAT.

pg. 28

Circuito de Migracin Oracle 11g

Agregar la linea <webcommandaccess>L2</webcommandaccess> bajo da de <inprocess>yes</inprocess> en
el archivo rwservlet.properties que se encuentra en el directorio
C:\Oracle\Middleware\user_projects\domains\ClassicDomain\config\fmwconfig\servers\AdminServer\appli
cations\reports_11.1.2\configuration.

URL PARA EL DESPLIEGUE.

Se compone de la siguiente manera.
<hostweblogic>:<puertoasignado>/forms/frmservlet?config=<configuracionelegida>
Por ejemplo.
MigracionPC:8888/forms/frmservlet?config=prueba

pg. 29

Circuito de Migracin Oracle 11g

ICONOS.
Convertir los archivos .ico a .gif.
Copiar los archivos .gif al directorio donse se encuentra el ejecutable jar.exe
C:\Oracle\Middleware\Oracle_FRHome1\jdk\bin

En la ventana de comando de Windows ejecutar la siguiente sintaxis para generar un archivo jar que
contenga los iconos.

Eliminar los archivos .gif del directorio C:\Oracle\Middleware\Oracle_FRHome1\jdk\bin.

Mover el archivo creado al directorio C:\Oracle\Middleware\Oracle_FRHome1\forms\java.

pg. 30

Circuito de Migracin Oracle 11g

En el archivos de configuracin web formsweb.cfg
(C:\Oracle\Middleware\user_projects\domains\ClassicDomain\config\fmwconfig\servers\AdminServer\appl
ications\formsapp_11.1.2\config\formsweb.cfg) agregar el nombre del archive .jar que contiene los iconos al
parmetro archive.

En el archivo de configuracin de entorno creado anteriormente prueba.env

(C:\Oracle\Middleware\user_projects\domains\ClassicDomain\config\fmwconfig\servers\AdminServer\appl
ications\formsapp_11.1.2\config\prueba.env) aadir el directorio completo del archivo appicons.jar a
la variable de entorno CLASSPATH.

pg. 31