{"id":13104,"date":"2015-12-22T17:22:03","date_gmt":"2015-12-23T01:22:03","guid":{"rendered":"http:\/\/clartechsolutions.com\/?p=13104"},"modified":"2023-03-01T01:48:01","modified_gmt":"2023-03-01T01:48:01","slug":"desplegar-apex-en-un-servidor-glassfish","status":"publish","type":"post","link":"https:\/\/kiusi.com\/en\/desplegar-apex-en-un-servidor-glassfish\/","title":{"rendered":"Desplegar APEX en un Servidor GlassFish"},"content":{"rendered":"

Existen tres tipos de Web Listener <\/strong>que podemos elegir para instalar Apex, el cual \u201cOracle REST Data Services\u201d es el preferido, antes denominado \u201cOracle Application Express Listener\u201d. Los otros dos Web Listener son Oracle HTTP Server y el Embedded PL\/SQL Gateway.<\/p>\n

El Web Listener permite la comunicaci\u00f3n entre el browser y los objetos de la base de datos:<\/p>\n

\"\"<\/p>\n

La instalaci\u00f3n de APEX con la configuraci\u00f3n del Embedded PL\/SQL Gateway es recomendado solo para desarrollo y para que APEX se ejecute con el Oracle REST Data Services es necesario elegir alg\u00fan servidor web que pueda desplegar J2EE, entre las opciones tenemos: Oracle WebLogic Server, Oracle GlassFish Server y Apache Tomcat.<\/p>\n

Tambi\u00e9n se puede instalar el Oracle REST Data Services en modo Standalone pero esta configuraci\u00f3n esta solo soportado para entornos de desarrollo.<\/p>\n

En este art\u00edculo veremos c\u00f3mo desplegar Oracle APEX en un Servidor GlassFish, usando la opci\u00f3n Open Source ya que usando la versi\u00f3n Oracle GlassFish Server tiene un costo de licencia asociado.<\/p>\n

Para completar los pasos descriptos en este art\u00edculo asumimos que tenemos instalado Oracle APEX en un Sistema Operativo Windows, corriendo en el Puerto 8080 usando la configuraci\u00f3n Embedded PL\/SQL Gateway.<\/p>\n

Descargar e Instalar el JDK<\/strong><\/h3>\n

Ingresamos a la p\u00e1gina de Oracle para descargar el JDK.<\/p>\n

http:\/\/www.oracle.com\/technetwork\/java\/javase\/downloads\/index.html<\/a><\/p>\n

Hacemos clic en el icono de Java, aceptamos el acuerdo de licencia, y seleccionamos el que corresponda a nuestro S.O., en mi caso descargar\u00e9 el de 32bits. (Windows x86: jdk-8u65-windows-i586.exe) en el escritorio y luego instalamos el JDK siguiendo el asistente.<\/p>\n

Vamos a configurar la variable de entorno en Windows para poder ejecutar el JAVA sin tener que escribir toda la ruta donde se encuentra el ejecutable.<\/p>\n

Configurar la variable JAVA_HOME en Windows<\/strong><\/h3>\n
    \n
  1. Hacemos clic con el bot\u00f3n derecho del mouse sobre el \u00edcono My Computer<\/strong> en nuestro escritorio y seleccionamos Properties<\/strong><\/li>\n
  2. Hacemos clic en el enlace Advanced system settings<\/strong><\/li>\n
  3. Hacemos clic en el bot\u00f3n Environment Variables<\/strong><\/li>\n
  4. En el recuadro System Variables<\/strong>, hacemos clic en el bot\u00f3n New<\/strong><\/li>\n
  5. Ingresamos el nombre de la variable como JAVA_HOME<\/strong><\/li>\n<\/ol>\n
      \n
    1. Ingresamos el valor de la variable como el path de instalaci\u00f3n para el Java Development Kit [Si<\/em> el directorio de instalaci\u00f3n de Java contiene un espacio en el nombre de la ruta, se debe utilizar el nombre de la ruta m\u00e1s corta (por ejemplo: <\/em>C:\\Progra~1\\Java\\jdk1.8.0_65<\/em>).]<\/em><\/li>\n
    2. Hacemos clic en OK<\/strong><\/li>\n
    3. En el recuadro System Variables<\/strong>, seleccionamos la variable Path y hacemos clic en el bot\u00f3n Edit<\/strong><\/li>\n
    4. Nos posicionamos al final de la lista de valores de la variable y agregamos ;%JAVA_HOME%\\bin
      \n\"\"
      \n<\/em><\/strong><\/li>\n
    5. Hacemos clic en OK<\/strong><\/li>\n
    6. Cerramos todas las ventanas modales.<\/li>\n<\/ol>\n

      Deshabilitar el Oracle XML DB Protocol Server<\/strong><\/h3>\n

      Como lo mencion\u00e9 antes, la instalaci\u00f3n que tengo hecha de Apex es usando el Embedded PL\/SQL Gateway y para usar el Oracle REST Data Services, necesitamos deshabilitar el Oracle XML DB Protocol Server.<\/p>\n

      Ingresamos a una ventana de comandos del SQL con credenciales de SYS as DBA e ingresamos la siguiente instrucci\u00f3n:<\/p>\n

      SQL> EXEC DBMS_XDB.SETHTTPPORT(0);<\/pre>\n
      Cambiar el Password de la cuenta APEX_PUBLIC_USER<\/strong><\/h3>\n
      Ingresamos a una ventana de comandos SQL con las credenciales de SYS as DBA e ingresamos las siguientes sentencias SQL.<\/p>\n
      SQL> ALTER USER APEX_PUBLIC_USER IDENTIFIED BY nueva_password;<\/pre>\n
      Con la siguiente consulta vemos el estatus de la cuenta reci\u00e9n alterada en OPEN<\/p>\n
      SQL> select username, account_status from dba_users;<\/pre>\n
      Nota: <\/strong>Debemos tener presente que por defecto en el profile de la base de datos Oracle 11g el par\u00e1metro PASSWORD_LIFE_TIME est\u00e1 configurado en 180.  Si estamos usando La base de Datos Oracle 11g con Oracle Application Express, esto es causa de que el password de APEX_PUBLIC_USER expire a los 180 d\u00edas. Como resultado nuestra instancia de Oracle Application Express comenzar\u00e1 a ser inutilizable hasta que no cambiemos la password.<\/p>\n
      Configurar RESTful Services<\/strong><\/h3>\n
      Abrimos una ventana de comandos SQL y nos conectamos con las credenciales de SYS as DBA y ejecutamos el siguiente script:<\/p>\n
      SQL> @C:\\apex\\apex_rest_config.sql<\/pre>\n
      Nota:<\/strong> Indicamos la ruta donde tenemos la instalaci\u00f3n de APEX.<\/p>\n
      Ingresamos las contrase\u00f1as para los usuarios: APEX_LISTENER y APEX_REST_PUBLIC_USER y cerramos la ventana.<\/p>\n
      Descargar e Instalar el Servidor GlassFish Open Source Edition<\/strong><\/h3>\n
      Ingresamos al siguiente link para descargar GlassFish Server: https:\/\/glassfish.java.net<\/a><\/p>\n
      Hacemos clic en Download<\/strong><\/p>\n
      Paso 0:<\/strong> Pre-requisito, tener instalado JDK 7 o superior para instalar GlassFish 4.1.1 (Instalado el JDK 8 u60 y configurado anteriormente)<\/p>\n
      Paso 1:<\/strong> Descargar Java EE 7 Full Platform  glassfish-4.1.1.zip<\/strong> en nuestro escritorio.<\/p>\n
      Paso 2:<\/strong> Copiamos la carpeta zip en el C: y la descomprimimos. Al realizar esta operaci\u00f3n se instala el servidor con un dominio predefinido, llamado domain1<\/strong>.<\/p>\n
      Paso 3:<\/strong> Iniciar GlassFish<\/p>\n
      Abrimos una ventana de comandos CMD y nos posicionamos en el directorio \u00e0 C:\/glassfish4\/bin\/<\/p>\n
      Ingresamos el siguiente comando para iniciar el servidor: asadmin start-domain<\/strong><\/p>\n
      \"\"<\/p>\n
      Al abrir el navegador web e ingresar en la barra de direcciones http:\/\/localhost:8080\/<\/a> podemos ver que el Servidor est\u00e1 actualmente iniciado.<\/p>\n
      Para ingresar a la consola de administraci\u00f3n del servidor, en la barra de direcciones del navegador ingresamos: http:\/\/localhost:4848\/<\/a><\/p>\n
      \"\"<\/p>\n
      Configurar usuarios y roles en GlassFish<\/strong><\/h3>\n
      Una vez dentro de la consola de administraci\u00f3n de GlassFish podremos ver a la izquierda un men\u00fa lateral.<\/p>\n
      Nos dirigimos a Configurations > default-config > Security<\/em> y se muestra la pantalla de seguridad.<\/p>\n
      Marcamos con un check para habilitar la opci\u00f3n Default Principal To Role Mapping <\/strong>y guardamos haciendo clic en el bot\u00f3n Save.<\/strong><\/p>\n
      Posteriormente vamos a Configurations > default-config > Security > Realms > file<\/em> y hacemos clic en el bot\u00f3n de Manager Users<\/strong> donde vamos a crear un usuario admin y otro usuario manager para el Oracle REST Data Services.<\/p>\n
      Primero creamos el usuario admin con la siguiente configuraci\u00f3n: <\/strong><\/p>\n