The Path of a SAP Consultant

1) Pasos previos.

ATENCION: La versión de NW sobre la que trata este manual NO es compatible con Windows Vista. El instalador se queda colgado en un determinado paso y no es posible pasar de ahí, con lo que obtendremos una instalación frustrada que dejará el ordenador lleno de archivos basura. Se desaconseja completamente el intentarlo.

Lo primero limpiaremos el ordenador de todo rastro de instalaciones previas del NetWeaver así como de cualquier instalación de Java existente.

Respecto a la configuración del ordenador es recomendable, antes de empezar, asegurarnos de que Windows gestiona la memoria virtual (Propiedades del sistema / Opciones avanzadas / Rendimiento / Opciones avanzadas / Cambiar / Tamaño administrado por el sistema), así como tener el mínimo imprescindible de programas abiertos. Vamos a necesitar tanta memoria como tengamos.

La versión de Java debe estar entre las 1.4.2 Update 9 y la 1.4.2 Update 16; la versión 1.5.0 y superiores no están soportadas. En http://java.sun.com/products/archive/ conseguiremos el J2SDK/J2RE 1.4.2 Update 16 y procederemos a su (Absolutamente trivial) instalación. Para terminar registraremos a mano la variable de entorno “JAVA_HOME” siendo su value el path donde acabamos de instalar el JDK. El editor de variables de entorno en Windows se encuentra en las propiedades del sistema / opciones avanzadas / Variables de entorno.

En este momento, con un estado del ordenador limpio y listo para la instalación, crearemos un punto de restauración; es muy importante hacer esto ya que es más que probable que durante el proceso obtengamos algún error y sea necesario volver a un punto estable de la máquina, que puede llegar a corromperse irreversiblemente sin este recurso. Este es un paso que, cuando lo leo en otros manuales, suelo pasar de ello; pero hazme caso, confia en mí… Crea el punto de restauración.

En https://www.sdn.sap.com/irj/sdn, en su sección de downloads, procedemos a descargar los ficheros de instalación del NetWeaver 7.0 SP14 tanto el Java Engine, como Developer Studio. Recomiendo utilizar un gestor de descargas, sobretodo para el Java Engine, de 4Gb. ya que lo más normal es que la conexión se rompa en algún momento, y perdamos la descarga entera, si no vamos grabando la descarga sobre la marcha, como hacen estos programas que nos permiten recuperar el proceso desde el punto en que se quedó.

Debemos dirigirnos a http://java.sun.com/j2se/1.4.2/download.html y descargar el Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 1.4.2, sea lo que sea eso; pronto el instalador del J2EE Engine nos pedirá el fichero ZIP sin descomprimir.

La instalación del DS, resulta trivial y no supone complicación ninguna. Siguiente, siguiente, siguiente…

El Java Engine es otro cantar.

2) La instalación del J2EE Engine.

Debo dejar claro que la instalación de este programa es muy compleja y llena de “pasadizos”, por lo que puede que, dependiendo de la configuración de tu ordenador, te aparezcan o no exactamente las pantallas que describo a continuación.

Hacemos doble click en …\NW05SR3_DEV_WP_1\IM_WINDOWS_I386\sapinst.exe, comenzamos la instalación y efectivamente, el instalador nos pide el fichero ZIP antes mencionado, siempre que los paths a Java estén bien definidos; en caso contrario, nos pedirá que localicemos a mano el JDK de las versiones antes descritas.

A continuación nos pedirá el identificador de nuestro sistema SAP (Que debe ser único y distinto a todos los demás sistemas de la red) y en un siguiente paso, la Master Password; introduciremos por duplicado una password a nuestra elección de un máximo de nueve caracteres. En un paso subsiguiente, puede llegar a pedirnos dos contraseñas más que son para administrador y usuario; recomiendo, a menos que se sea un usuario avanzado, en cuyo caso, no sé qué estás haciendo leyendo esto, que se introduzca siempre la misma contraseña para no tener líos de “quién es quién”…

El siguiente requerimiento es marcarle el directorio que contiene el paquete de instalación de MaxDB, que será …\MAXDB76_NW07\DATA_UNITS\MAXDB_WINDOWS_I386\ . El lugar de destino en nuestro disco local, podemos dejarlo en blanco. No se debe marcar el LABEL.ASC contenido en la carpeta, como parece desear el instalador, sino el mencionado directorio contenedor.

Lo siguiente, el directorio que contiene el UC Kernel NW 7.0 SR3, que será …\NW05SR3_KRNL3\KU_WINDOWS_I386\ y procederemos como en el paso anterior.

El siguiente paso será registrarnos en nuestro SLD (System Landsacape Directory). El Host, es la URL al portal que estamos desarrollando, y el puerto, el puerto de acceso, generalmente el 50000. Los otros dos campos serán nuestro usuario y password en el portal.

En el siguiente paso, podemos revisar todo lo introducido anteriormente así como ajustar algún que otro parámetro. Si deseamos modificar alguno de ellos, lo marcamos y pulsamos REVISE. En caso contrario, dejaremos todo desmarcado, y pulsaremos START.

La instalación está en marcha.

3) Errores habituales y Tips.

3.1) Haber metido un identificador de sistema repetido: El identificador de sistema SAP que nos pide NO es el sistema al que nos queremos conectar. Se trata un un sistema nuevo que el instalador creará y que debe contar con un identificador único.

3.2) El Java Engine no arranca: Este servicio tarda MUCHO en arrancar y el instalador se rinde a los 20 minutos, lo cual puede no ser suficiente. En caso de corroborar que el Engine no arranca “nunca”, debemos proceder como se indica en la nota 802600 con los valores indicados en la nota 723909. Mi configuración actual del server, que me funciona en un equipo con 2Gb. de RAM es la siguiente:

-Djava.security.policy=./java.policy
-Djava.security.egd=file:/dev/urandom
-Dorg.omg.CORBA.ORBClass=com.sap.engine.system.ORBProxy
-Dorg.omg.CORBA.ORBSingletonClass=com.sap.engine.system.ORBSingletonProxy
-Djavax.rmi.CORBA.PortableRemoteObjectClass=com.sap.engine.system.PortableRemoteObjectProxy
-Dorg.xml.sax.driver=com.sap.engine.lib.xml.parser.SAXParser
-verbose:gc
-Xmx1024m
-Xms1024m
-Djco.jarm=1
-XX:PermSize=256m
-XX:MaxPermSize=256m
-XX:NewSize=160m
-XX:MaxNewSize=160m
-Xdebug
-XX:SurvivorRatio=2
-XX:TargetSurvivorRatio=90
-XX:+PrintGCTimeStamps
-XX:+UseTLAB
-XX:SoftRefLRUPolicyMSPerMB=1
-Dsun.io.useCanonCaches=false
-Djava.awt.headless=true
-Xss2m
-XX:+UseParNewGC
-Drdbms.driverLocation=C:/sapdb/programs/runtime/jar/sapdbc.jar

3.3) ADVERTENCIA: En caso de error durante el proceso, no intentes borrar a mano los ficheros intermedios y temporales “enquistados”. Si lo intentas, tendrás que hacer uso del punto de restauración que antes hemos creado, ya que el tinglado de ficheros que el instalador hace es irreversible de forma manual. Lo mejor es volver a intentar la instalación, arreglando lo que sea necesario para que continue. Sólo en caso de no ser capaz de continuar y ante errores incomprensibles o tan genéricos que no dicen nada, se debe volver a intentar una instalación nueva introduciendo los mismos parámetros que introdujimos la vez anterior, para que todo sea reescrito. Si esto no funciona… Usa tu punto de restauración (Ese que hiciste, porque me hiciste caso, verdad??) y volvamos a empezar. En caso de que aún así quieras intentar por el motivo que sea un borrado manual, utiliza primero la herramienta Registry Clean Tool y luego procede a borrar las carpetas (Que consideres) adecuadas.

3.4) El instalador te falla al intentar continuar una instalación anterior porque no puede leer un fichero llamado Keydb.xml?? Ve al directorio C:\Archivos de programa\sapinst_instdir\NW04S\SYSTEM\DEVWP\MAXDB y abre el fichero keydb.X.xml, siendo X el mayor número disponible; copia su contenido al keydb.xml; reinicia el ordenador y reintenta la instalación.

3.5) Recomiendo que cuando nos encontremos con un problema (Cosa que ocurrirá), tratemos siempre de continuar la instalación previa, tras arreglar los fallos causantes del anterior fracaso, y nunca intentar una nueva, ya que el consumo de disco de forma inútil puede dispararse de forma “grave”.

4) Pasos “especiales”.

Import Java Dump: Puede tardar MUCHO… Pero nada es eterno; vigila la ventana de log para confirmar que sigue activo y en caso de que el log no escriba en “mucho tiempo” (Dos términos muy relativos)… Try again según el protocolo descrito en el punto 3.3.

Start Java Engine: Tarda mucho, pero puede que tarde… Por siempre. En caso de que en una media hora no haya arrancado el Engine, revisar lo dicho en el punto 3.2.

Configure CAF: Puede fallar debido a que el Engine se esté reiniciando a causa del paso anterior. Esperar a que el server se termine de cargar y sólo entonces, pulsar RETRY.

5) J2EE Migration & Third-Party Integration.

Para asegurarnos la completa compatibilidad con todos los tipos de ficheros que podamos necesitar, debemos instalar el plugin J2EE Migration & Third-Party Integration, que podremos encontrar, en el momento de escribir estas líneas, aquí; la descarga directa es esta y el manual, este.

Para Instalarlo:

Extrae los ficheros com.sap.j2ee.migration.kit_<version>.jar y com.sap.j2ee.migration.kit.<platform>_<version>.jar en el directorio %DEVELOPER-STUDIO-HOME%/plugins.

Reinicia/Inicia el NW Developer Studio.

Ahora, al seleccionar “File/Import” tendremos tres nuevos tipos de módulo: Bea Ejb Module, Bea Java Module y Bea Web Module.

6) Configuración del DS.

Para configurar el Developer Studio para desarrollar Java Web Dynpros, seguiremos los siguientes pasos:

6.1) Window->Preferences->
-) Workbench->Workspace: Directory=C:\workspace
-) Java->Editor: Show line numbers.
-) Java Development Infrastructure->Development configuration: Root Folder=C:\.dtc
-) SAP J2EE Engine: SAP J2EE Engine is installed on local host. Pulsar Browse y seleccionar la instancia NDI. (Si no tienes este apartado en las opciones, no tienes el NW for Java, sino otra versión, busca la adecuada en https://www.sdn.sap.com/irj/sdn/nw-downloads).

6.2) Perpectivas:
-) Web Dynpro
-) J2EE Development
-) Web Services
-) Dictionary
-) Development Configurations

6.3) Comprobar que todo está en verde en el panel del J2EE Engine en la perspectiva Web Dynpro.

6.4) Reiniciar el NetWeaver y comprobar que los directorios antes introducidos se han creado; en caso contrario, reiniciar de nuevo.

———

Bibliografía:

SAP-JA312: Advanced Web Dynpro for Java.
Notes: 80260, 723909.
Thread: 161020.