Instalacin y configuracin de BASIS BBj en ambiente Linux para utilizarlo con JNLP.

Hace unas semanas me propuse instalar y configurar la suite de BASIS en ambiente Linux,
especficamente Fedora 18 fungiendo como servidor, y un cliente con el mismo ambiente y otro cliente
con Windows 7, con el fin conocer y documentarme bien a fondo como funciona este nuevo ambiente
de programacin de BASIS, me refiero al BBj, y nuevo tambin para mi, ya que lo ltimo que haba
utilizado hace un poco de tiempo atrs, era Visual Pro/5 en ambiente CUI, y en algunos casos a manera
de prueba, hice algunos formularios en ambiente GUI, para ver y entender su funcionalidad. En el caso
de repositorio de datos, me mantuve utilizando los archivos propietarios de este lenguaje, como son los
tipos de archivo Mkeyed, Direct, entre otros, y hace un tiempo atrs quise cambiar el tipo de repositorio
propietario de Vpro/5, e hice la migracin a ambiente de base de datos, especficamente MySQL, todo
quedaba igual, excepto las instrucciones para acceder a los datos, que como sabemos, es un cambio
totalmente radical, me puse eso como propsito y en cierto modo como un reto, y puse manos a la obra
hasta concluir con este cambio unas semanas mas tarde, y les cuento que funciona perfectamente y con
menos esfuerzo de programacin para el acceso a los datos, por las facilidades que sabemos que
ofrece este tipo de plataforma.
En Visual Pro/5, como ya les coment, hace tiempo atrs utilic la parte GUI, pero para soluciones
bsicas muy puntuales, ya que me encontraba un poco tedioso la manipulacin de los controles y
objetos de forma manual, es decir escribiendo el cdigo y la ubicacin de cada uno de los objetos en los
formularios, cosa que ha cambiado radicalmente con la incorporacin del nuevo ambiente de desarrollo
de programacin como es BASIS IDE, que facilita grandemente el desarrollo de los formularios, y la
programacin por objetos.
La versin de BBj que descargu para hacer esta prueba, y es la que nos ocupa para elaborar esta gua,
fue la versin 12.22, disponible en la pagina de BASIS (www.basis.com), ruta: Products -> Downloads
-> Opcin Bbj and Barista y seleccionando: Product Bbj, Revision 12.22 y el Build Time Stamp que
esta versin tenga por defecto al momento de la descarga.

El paquete seleccionado fue: Bbj + Barista + BASIS IDE + Demos.

Una vez descargado el archivo .jar mencionado, tambin procedo a descargar todo lo relativo al
ambiente Java, que aunque este estaba instalado por defecto al momento de instalar Fedora, que es el
Java que se encuentra en los repositorios de Fedora, despus de varios intentos de querer ejecutar los
productos de BASIS, y estos presentar varios inconvenientes, tanto es as, que al inicio, cuando
comenc con este proyecto y despus de haber terminado con la instalacin de los productos de
BASIS, haban algunos que no funcionaban, lo que me oblig a solicitar ayuda a BASIS, (que por
cierto, muy eficientes y conocedores de sus productos), y estos me indicaron que los problemas que
vengo confrontando con sus productos, es que para que funcionen correctamente, necesariamente se
tiene que descargar e instalar el Java directamente de la pgina de Oracle, la ltima versin disponible
o la que ellos recomiendes, de acuerdo a la versin de BBj que vayamos a instalar.

A partir de lo indicado por el rea de soporte de BASIS, fue que proced a descargar desde la pagina de
Oracle, lo indicado por ellos, accediendo para la descarga el enlace siguiente:
http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html,
seleccionando: Linux x86, la versin .rpm.
Nota: Los que tengan instalado Fedora en versin 64 bit, tienen que seleccionar: Linux x64.
Los clientes deben tener instalado al menos, Java JRE para que en estos pueda ejecutarse JNLP.
Aunque el paquete de Java que mencionamos mas arriba, trae consigo JRE por defecto, pueden tomarlo
para instalarlo en los clientes, pero les instalar cosas que no van a utilizar, aunque estas pasaran
desapercibidas.
Este paquete .rpm se debe instalar como usuario root, abriendo Terminal, en la carpeta /usr/java de la
manera siguiente:
sudo rpm -ivh <nombre del paquete Java.rpm>

su - `rpm -ivh <nombre del paquete Java.rpm>`

La opcin que mas le convenga, pero deben de recordar que tienen que ir a la carpeta /usr/java/ para
que el comando rpm lo instale en esta ruta, (aunque no es obligatorio), pero si es recomendable porque
en esta ruta es que normalmente y por defecto es instalado. El comando rpm automticamente realiza la
actualizacin de los enlaces: default y latest que se encuentran es esta carpeta, es decir que los re-dirige
hacia la carpeta/versin Java recin instalada.
Terminada esta instalacin, procedemos a instalar el paquete que anteriormente habamos descargado
de BASIS, (recuerden que todo se debe de ejecutar como usuario root), y con la opcin de ejecutar
como root que usualmente utilizan. Vamos a la carpeta donde lo descargamos, le colocamos todos los
permisos al archivo .jar, y lo ejecutamos con la instruccin siguiente:
./<nombre del paquete Bbj>
En caso de que tenga problemas ejecutndolo en el formato indicado mas arriba, puede utilizar este
otro formato:
java -jar ./<nombre del paquete Bbj>
La primera pantalla que aparece luego de ejecutar uno de los comandos antes mencionados, es la
siguiente:

Primera pantalla

Pueden seleccionar el idioma que deseen, de la lista que tiene disponible la pantalla; por defecto dej el
Ingles. Sobre la otra opcin: Response File, no vamos a entrar en detalles, ya que no es parte de este
documento, djelo tal cual aparece, y pulse el botn Next, para ir a la prxima pantalla.
Segunda pantalla

Pulsar Next, para ir a la prxima pantalla.

Tercera pantalla

Como esta pantalla sale con el Radio Button seleccionado, para poder continuar deben seleccionar: I
ACCEPT..., para poder continuar.
Cuarta pantalla

Dejamos por defecto la carpeta que muestra la pantalla. Recuerden en estamos instalando como usuario
root, en caso de que est instalando con otro usuario, al dejar esta carpeta por defecto, (al menos que
este usuario posea todos los permisos para acceder a ella), no podr continuar con la instalacin, porque
le saldr un aviso indicndole que no tiene los permisos necesarios para escribir en ella.
Quinta pantalla

En esta pantalla es que vamos a seleccionar la ruta donde instalamos Java, que normalmente el
instalador trae por defecto la ruta que se encuentra en la pantalla, lo nico que tenemos que hacer, es
cerciorarnos que corresponde con la ruta donde instalamos Java. Una vez comprobado, procedemos a
darle Next. Nota: En caso de que no muestre por defecto la ruta de instalacin de Java, pues hay que
proceder a buscarla con el botn: Browse.

Sexta pantalla

Para el caso que nos ocupa, dejamos todo como se muestra en esta pantalla, y precedemos a seleccionar
Next.

Sptima pantalla

Esta pantalla se muestran todos los componentes que el instalador va a proceder a instalar por defecto
de una instalacin: Typical, como la dejamos en la pantalla anterior. En esta pantalla se muestra que la
opcin: Make installation available in Web Start, se encuentra marcada, pero por defecto, el instalador
la trae desmarcada, por lo que bajo ninguna circunstancia deben dejarla sin marcar, porque al no
instalar Web Start, cuando ejecuten Enterprise Manager (EM), obligatorio para configurar JNLP, esta
opcin no estar disponible, o mejor dicho no aparecer en el EM, por lo que deben estar bien atentos
para no dejar de marcar este checkbox, para que no les pase lo que me pas a mi, que tuve que
reinstalar totalmente desde cero..
Tan pronto seleccionen: Next, la instalacin arranca con el proceso habitual de los instaladores, como
se muestra en la pantalla a continuacin.

Octava pantalla

Tan pronto concluye esta parte de la instalacin, aparece la prxima pantalla.

Novena pantalla

Continuar pulsando Next.

Dcima pantalla

Completar todos los campos que solicita este formulario, para poder continuar con la instalacin. Y se
procede a pulsar Next, para pasar a la prxima pantalla.

Undcima pantalla

Aqu se marca el checkbox: Requesting a 30-day evaluation license, porque este viene por defecto
desmarcado, y como en esta caso lo que estamos es haciendo una instalacin de prueba, lo marcamos.
En caso de que sea una instalacin definitiva, pues se le deja tal cual viene por defecto, y se precede a
pulsar Next.
Duodcima pantalla

Pulsar Next.

Dcimo tercera pantalla

Esta pantalla es solo de manera informativa, pulsar OK para continuar con la instalacin.
Dcimo cuarta pantalla

Pulsar Next.

Dcimo quinta pantalla

Pulsar Next.
Dcimo sexta pantalla

Pulsar Next.

Dcimo sptima pantalla

Pulsar Next.
Dcimo octava pantalla

Llegamos a la pantalla final de la instalacin, y solo nos resta Pulsar Finish. Por lo que queda concluida
la instalacin de BBj con la opcin WebStart mas IDE, para pasar a la parte de ajuste pos-instalacin.

Pos-instalacin.
-

Una vez concluyamos con la instalacin del Bbj, tenemos que verificar en el archivo
/etc/mime.types si en su contenido tiene la linea siguiente:
type=application/x-java-jnlp-file desc="Java Web Start" exts="jnlp"
si no la tiene, hay que proceder a inclursela, editando este archivo con el editor de texto que
usualmente utiliza.

Como hemos ingresado al sistema con un usuario normal, o sea que no es root, al ejecutar
alguno de los sub-productos de BASIS, en este caso especfico BASIS IDE, a la carpeta
/usr/local/basis se tiene que cambiar el propietario con que instalamos, que en este caso fue
root, a nuestro usuario normal con que hemos ingresado, para que al momento de ejecutarlo,
tenga todos los permiso en los archivos que componen esta herramienta. Esto lo tienen que
hacer con el usuario root. Pueden usar la instruccin siguiente o una equivalente a la misma:
sudo chown -R usuario:grupo_usuario *
Al cambiar estos permisos, mas adelante nos permitir acceder a los archivos .jar que necesita
JNLP.

Ir a la carpeta donde instalamos BASIS, (usualmente en /usr/local/basis), y debajo de esta,

vamos a /ide/bin, y buscamos el archivo: runide.sh, lo abre con el editor de su preferencia, y
busca la lnea:
#unset GNOME_DESKTOP_SESSION_ID
le quitamos el carcter (#) de comentario, y la linea debe de quedar as:
unset GNOME_DESKTOP_SESSION_ID
proceder a grabarlo y salir.

Activar el servicio de Apache y tener en cuenta que cuando este sea activado, el mismo quede
listo para que se active automticamente cada vez que encienda o reinicie el servidor.

Acceder al Firewall para abrir los puertos 80 y/o 443, y que queden configurados igual que
como hicimos con Apache, que se ejecute automticamente. Ademas de los puertos 80 y 443,
tambien se requiere abrir los puertos 2003 y 2103, que son los puertos de Thin Client y Secure
Thin Client respectivamente, que estn definidos por defecto en el EM, ruta: Server Information
-> Pestaa: Servers -> Opcion: Thin Client Servers, y debajo de esta opcin hay dos opciones
mas que son: Thin Client: 2003 y Secure Thin Client:2103, que son los puertos a que nos
referimos. La diferencia entre estos dos tipos de clientes, es que el Secure por defecto trae
deshabilitada la consola, eso es para que en caso de que un programa que se encuentre en modo
de ejecucin, por alguna razn ocurra un error, y el erro no est controlado por programacin,
termine la ejecucin y salga a modo de consola en el usuario donde se est ejecutando. Ver

imagen mas abajo.

Una vez hecho esto, ejecutamos el EM, para configurar la aplicacin que queremos levantar
desde los clientes. La ruta para acceder a esta opcin es: JNLP Configuration, y en la parte
inferior de la pantalla, aparece el botn: New JNLP Application, pulsarlo para ingresar la
informacin necesaria para configuracin de la aplicacin. Ver imagen siguiente.

Solo vamos a mostrar los campos que son obligatorios para poder levantar la aplicacin, estos
son: Application Name, dentro del cuadro que se encuentra justo a la derecha, llamado
Application Summary. Automticamente el EM configura el campo: Application Link, con el
nombre que se escribi en el campo: Aplication Name. Los ltimos tres campos son solo
informativos, los cuales sern mostrado al momento que el cliente ejecuta el enlace que se
descarga a travs del navegador, en la pantalla inicial. Ver imagen mas abajo.

Una vez colocado el nombre de la aplicacin, pulsamos click en la opcin: application-desc, la

cual consiste en la parte mas importante para la definicin de ejecucin de la aplicacin, y en
esta pantalla vamos a llenar los campos que se encuentran dentro dentro del cuadro que se
encuentra justo a la derecha, llamado: BBj Arguments.
Configuration File, es el campo donde se le describe la ruta donde reside el archivo
config.bbx que va a utilizar BBj.
Remote Host, en este se le configura la direccin IP del servidor o PC donde reside la
aplicacin, y por ende, desde donde se va a levantar.
Remote Port, como habamos mencionado anteriormente cuando mencionamos el tema
del Firewall, aqu de debe de utilizar el numero de puerto que desee, dependiendo del
tipo de cliente que va a utilizar, o sea: Thin o Secure Thin. Si desea utilizar Thin, pues se
le coloca el puerto 2003, y si decide utilizar Secure Thin, el puerto 2103. En la imagen
utilizamos este ltimo.
Secure Client, se utiliza para evitar que en la PC del cliente, en caso de que un programa
se interrumpa por algn error o de manera intencional, no puedan ver el cdigo del
programa que se interrupi.
Working Directory, es la ruta donde se encuentra todos los programas de la aplicacin.

Program and Arguments, es donde se le describe el nombre del programa que va a iniciar
la aplicacin, se puede escribir unicamente el nombre del programa, y si se desea se le
pueden agregar argumentos, en caso de que el programa de inicio lo requiera. Ver
imagen siguiente.

Configurar archivo /etc/hosts.equiv en el servidor, para indicarle los clientes y sus usuarios que
pueden ingresar en el servidor. Mas abajo un ejemplo del archivo que fue configurado para esta
prueba.
+
+
192.168.1.109 jperez
192.168.1.105 nobody
+
jperez
+
nobody
para una mejor idea de como funciona este archivo, favor de buscar documentacin del mismo.

Hasta este punto, todo lo que se ha instalado y configurado ha sido en la parte del servidor, o la PC que
est fungiendo como tal, por lo que es tiempo para que pasemos a la parte del cliente, que es la parte
mas sencilla y rpida.
En el cliente se tiene que tener instalado el ambiente run-time de Java, (jre), para que la aplicacin
pueda levantar. Una vez instalado jre, ejecutamos el navegador que normalmente utilizamos, que en el

caso nuestro, utilizamos el Google Chrome.

En el rea del navegador destinada para escribir la URL, le escribimos el contenido del campo:
Application Link.
Tan pronto pulsemos la tecla Enter, el navegador debe de presentar la descarga de un archivo, el cual va
a tener el mismo nombre que pusimos en el campo: Application Name, con extensin .jnlp.
Recomendamos que el mismo sea descargado en el Escritorio, para que comprueben inmediatamente su
descarga.
Una vez descargado, el icono debe de aparecer en el escritorio con el smbolo de Java; de ahora en
adelante, ya queda todo configurado y podemos ejecutar la aplicacin a travs del icono. En caso de
que accidentalmente elimine el icono del escritorio, solo tiene que repetir el proceso de descarga a
travs de su navegador, tal cual explicamos en el prrafo anterior.
Al momento de la ejecucin, se mostrar una ventana que despliega una serie de archivos con
extensin .jar, necesarios para iniciar la aplicacin que acabamos de configurar. Tan pronto termine con
esta descarga, el programa que se configur como el programa de arraque inicial de la aplicacin, debe
de presentarse en la pantalla.
!Listo y que disfruten su aplicacin ejecutndose a travs de Java Network Launching Protocol
(JNLP)!.
Espero que esta gua le haya servido de ayuda, y realizado la configuracin sin ningn inconveniente.