HowTo O3 Properties

¿Dónde se definen las properties?

Los distintos componentes leen un conjunto de propiedades de configuración (properties) al momento de comenzar la ejecución. Para cada componente existen uno o varios archivos donde se definien las properties. El caso más corriente es que exista un solo archivo asociado a cada componente creado por la propia instalación de O3. Los archivos de configuración generados por la instalación tienen el nombre formado de la siguiente manera:

O3<nombre_componente>.properties

Por ejemplo: O3Browser.properties, O3Designer.properties, O3Builder.properties, etc

La ubicación por defecto de estos archivos es en la raíz de la instalación de O3. Pero también pueden encontrarse en el HOME del usuario (p.e. Documents and Settings\username). Además a veces se utilizan variantes en los nombres de los archvios para dejar en claro que son generados por el usuario, por ejemplo O3Browser_custom.properties

Es importante entonces conocer el orden en que se leen estos archivos, lo que podemos observar en el log al iniciar un componente. A continuación se muestra como ejemplo para observar el orden de lectura, la ejecución del O3Browser:

Loading Application properties file from: C:\Ideasoft\o3bi\O3Browser.properties
Loading Custom Application properties file from: C:\Ideasoft\o3bi\O3Browser_custom.properties
Loading User properties file from: C:\Documents and Settings/user1/O3Browser_user.properties
Loading Configuration from : C:\Documents and Settings\user1/O3Browser.properties

En el caso del O3Browser,  también se lee al final, el archivo de configuración o3connect.properties ubicado en el home del usuario

A continuación se describen las properties más usadas.

O3 Builder y O3 Designer

Property	Descripción	Valor por defecto
ideasoft.o3.designer.previewRecords	Cantidad de tuplas en la Vista Previa del Designer	13
ideasoft.o3.designer.assistTimeOut	Time out para el botón de Asistencia del Designer	10000
ideasoft.o3.designer.testTimeOut	Time out para el botón de test del Designer	10000
ideasoft.o3.designer.autoFillTimeOut	Time out para el botón de autoFill	10000
ideasoft.o3.recycledNodeName	Permite cambiar la etiqueta del nodo Recycled	Recycled
ideasoft.o3.fillerNodeName	Permite cambiar la etiqueta de los nodos Filler. Válido para dimensiones Formato y Arista	Filler
ideasoft.o3.fillerNodePropagateName	Indica que los nodos Filler toman la misma etiqueta que sus padres. Válido para dimensiones Formato y Arista	false
o3.sql.useSystemProp	Habilita o deshabilita el uso del System Properties para la conexión JDBC	true
o3.sql.useTransactionReadUncommited	Fuerza o no TransactionIsolation de la conexión SQL a Connection.TRANSACTION_READ_UNCOMMITTED	false
gclient.server.port	Puerto de conexión al repositorio remoto. En versión 4 y posteriores se sustituye por las Opciones de Conexión	4447
gclient.server.host	Nombre del host para repositorio remoto. En versión 4 y posteriores se sustituye por las Opciones de Conexión	localhost
gclient.server.name	Siempre lleva el mismo valor	O3Server
gclient.singleSignOn	Evita pedir loguin por cada nueva conexión. Solo para versión 4 y posteriores	true
o3.client.maxYSize	Modifica la cantidad de filas máximas que devuelve el server. Se agrega en o3Browser_custom.properties	5000
Dsupport.multiple.screens	Habilita o deshabilita el uso de múltiples monitores. Se agrega en los archivos bat o sh.	true
Djava.io.tmpdir	Para cambiar el directorio temporal donde se construyen los cubos, Se agrega la property en el builder.bat ---> set PROPERTIES=%PROPERTIES% -Djava.io.tmpdir=e:\tmp o builder.sh ---> PROPERTIES="$PROPERTIES -Djava.io.tmpdir=opt/tmp"
o3bi.role.admin.default	Indica cuál es el rol por defecto para las actividades de administración de O3 Debe modificarse en caso de eliminar el rol Administrators asignado en toda instalación de O3 por defecto	Administrators

O3 Browser

Property	Descripción	Valor por defecto
o3.client.maxYSize	Modifica la cantidad de filas máximas que devuelve el server. Se agrega en O3Browser_custom.properties	5000
o3.client.maxXSize	Modifica la cantidad de columnas máximas que devuelve el server. Se agrega en O3Browser_custom.properties	50
o3.matrixWarning.force.suppress	Ver descripción para cubos publicados en el servidor	false

O3 Server

Información útil

El archivo O3Server_custom.properties ubicado en:O3_INSTALL_DIR\

Property	Descripción	Valor por defecto
ideasoft.o3.cache.maxsize	Tamaño máximo de la cache de cada cubo medido en bloques	1000
ideasoft.themes.defaultTheme	Define el theme a utilizar en O3 Web (blue, red, green)	Red
o3.monitorPeriod	Cantidad de tuplas procesadas entre logs	5000
ideasoft.o3.pool.totalMaxCache	Tamaño máximo medido en bloques de la cache de cubos. La suma de los tamaños de cache de todos los cubos abiertos del servidor nunca supera esta cantidad	250000
istore.permission.default	Define permisos generales sobre el repositorio remoto, istore. Esto es, permisos para que se puedan visualizar, leer o grabar los modelos, reglas, expresiones, acciones, etc. Cuando el valor de esta property es Verdadero, quedan visibles todos los componentes de análisis que se creen, para los distintos roles. Si el valor es Falso, entonces, deben ser autorizados explícitamente. Se define en el archivo O3Server_custom.properties	true
rbac.appPermissions.default.o3	Define los permisos sobre el producto O3, que involucra, los componentes: vistas BIClient	true
rbac.appPermissions.default.o3.views	Define los permisos sobre el componente Vistas. Esto es, permisos para que se puedan grabar vistas privadas, públicas o de rol	true
rbac.appPermissions.default.o3.biclient	Define los permisos sobre todos los componentes de BI Client. Esto es, permisos para que se puedan visualizar, leer o grabar: consultas Ad-Hoc, Runtime, Library, Nomenclature, etc	true
o3.views.defaultRestriction	Restricción de que cada vista solo puede ser eliminada por el usuario que la creó. Se define en el archivo O3Server_custom.properties	owner
-DBuilderQueue_maxSession	Se modifica en el jboss.lax/jboss.sh. Define la cantidad maxima de procesos que serán consumidos de la cola de procesos. Esto es para cuando usamos el proceso de construcción autamática	1
o3.client.maxYSize	Modifica la cantidad de filas máximas que devuelve el server. Se agrega en O3Server_custom.properties Esta configuración se lee por consulta o por sesión, por lo que no es necesario reiniciar JBoss luego de modificar su valor, salvo que se esté utilizando por primera vez el O3Server_custom.properties (es decir, que se esté creando dicho archivo). Si se supera la cantidad por default, aparece diálogo que permite retroceder, ir a la vista inicial del cubo, ejecutar consulta tope o pasar a modo paginado.	5000
o3.client.maxXSize	Modifica la cantidad de columnas máximas que devuelve el server. Se agrega en O3Server_custom.properties. Esta configuración se lee por consulta o por sesión, por lo que no es necesario reiniciar JBoss luego de modificar su valor, salvo que se esté utilizando por primera vez el O3Server_custom.properties (es decir, que se esté creando dicho archivo).	500
o3.lazyreport.maxXSize	Modifica la cantidad máxima de columnas en el modo reporte (modo paginado).	50
o3.client.maxResultSize	Modifica la cantidad de celdas que devuelve el server. Se agrega en O3Server_custom.properties.	500000
o3.force.restrictions.ranking	Hace que se aplique rankings automaticos sin que el usuario lo indique expresamente (cuando el valor es true). Se agrega en O3Server_custom.properties	false
o3.default.graphType	Hace que por defecto se abra en formato grilla si vale 0 se agrega en O3Server_custom.properties	1
o3.tcp.port	Modifica el puerto en el que escucha O3 al report se agrega en O3Server_custom.properties	7777
o3.accept.without.roles	Si se especifica la siguiente propiedad en false, la licencia concurrente toma a todos los usuarios como si pertenecieran al rol bi-* . Esto es para no tener que agregar a todos los usuarios uno a uno (o por ejemplo, porque es una licencia ilimitada) Se agrega en O3Server_custom.properties	true
<session-timeout>60</session-timeout>	Cambia el timeout de las sesiones web para O3 se modifica en <o3>/jboss/standalone/deployments/o3-server.ear/o3web.war/WEB-INF/web.xml el valor es en minutos	60
o3.config.dataBase	Cambia la definición de la configuración de O3Server para que se guarde en base de datos en lugar de utilizar el archivo O3Server.cfg(cuando el valor es true). Se agrega en O3Server_custom.properties	false
rbac.users.limit	Modifica la cantidad de usuarios a mostrar en la lista desplegable de usuarios. Se agrega en AdmServerApp.properties	100
o3.metadata.cache.enabled	Indica si se activa la metadata restringida para los clientes	False
o3.memberCache.size	Máxima cantidad de elementos a disponer en el cliente por cubo	20000
o3.metadata.client.maxChildren	La cantidad máxima de hijos de un elemento que se transmiten al cliente. Si hay más hijos en el servidor, en el árbol de dimensiones presentado al usuario se indica mediante un "Más elementos ..." al final de los elementos desplegados.	500
o3portal.waitcube.time	Tiempo máximo expresado en milisegundos destinado a la apertura de vistas de O3	30000
o3.reportMode.initial	Establece el modo paginado por defecto. Está property se controla solo cuando se abren cubos.	false
sync.data.scheduler.runAtStartup	Establece si se realiza la sincronización del O3Server.cfg hacia la base exist. Los cubos publicados, están en exist. Se debe encender la property por primera vez si se está realizando una migración	true hasta la version 6.3.2
ideasoft.o3.client.validate.dimensions	Si se valida al abrir un cubo en o3web, si tiene o no dimensiones vacias. Se agrego como control por compatibilidad hacia atras a la version 5.3	true
ideasoft.o3.concurrentQueries	Cantidad de consultas concurrentes maximas que soporta el servidor.	5 (hasta 7.2.3 incl, 20 a partir de ahi)
o3.matrixWarning.force.suppress	Si es true, el comportamiento es como en versiones anteriores. Se fuerza la supresión de ceros y Nans. Esto quiere decir que hay cruces de medidas/ dimensiones que no están en el cubo (no se ven aunque visualicemos Ceros y Nans) Si es false, el comportamiento el correspondiente cruce se existe en el cubo, y por tanto se visualiza al solicitar Ceros o Nans.	false 7.2.5 en adelante

ePortal

Property	Descripción	Valor por defecto
eportal.welcome.message	Cambia el mensaje del portlet de bienvenida. Hay que modificar el archivo welcome.properties o welcome_es.properties (dependiendo del idioma) ubicado en: <03-install>\liferay\tomcat\webapps\o3-liferay-theme\WEB-INF\classes\com\ideasoft\eportal	Bienvenido a O3 Enterprise Portal
eportal.welcome.link	Cambia el texto del link de ingreso al sistema en el portlet de bienvenida. Hay que modificar el archivo welcome.properties o welcome_es.properties (dependiendo del idioma) ubicado en: <03-install>\liferay\tomcat\webapps\o3-liferay-theme\WEB-INF\classes\com\ideasoft\eportal	Ingresar al Sistema
auth.pipeline.enable.liferay.check	Agregar en "portal-ext.properties". Se debe setear esta propiedad en "false" para evitar la doble validación del password del usuario (en LDAP y también en la base de datos de Liferay). Si su valor es "false" valida solamente en LDAP.	Valor por omisión: "true"
eportal.url	Link desde O3 Web a O3 Enterprise Portal	http://{localhost.name}:${liferay.port}/eportal

Varios

Property	Descripción	Valor por defecto
allowEmptyPasswords	Determina si se admiten passwords nulas cuando autenticamos contra un LDAP Hay que modificar el archivo <o3>/config/rbac/JndiConfiguration-*.properties	true