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 obervar mirando 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\O3\O3Browser.properties
Loading Custom Application properties file from: C:\Ideasoft\O3\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 cofiguració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	1099
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 Server

Información útil

El archivo GServer_custom.properties ubicado en:O3_INSTALL_DIR\jboss\server\default\ideasoft-o3

Property	Descripción	Valor por defecto
ideasoft.o3.cache.maxsize	Tamaño máximo de la cache de cada cubo medido en bloques	1000
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	25000
istore.permission.default	Define si los componentes almacenados en el repositorio remoto (istore) quedan visibles por defecto para los distintos roles. Para que deban ser autorizados explícitamente, debe asignarse valor false Se define en el archivo GServer_custom.properties	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 GServer_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 GServer_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 GServer_custom.properties (es decir, que se esté creando dicho archivo)	5000
o3.client.maxXSize	Modifica la cantidad de columnas máximas que devuelve el server. Se agrega en GServer_custom.properties. Ver comentario en property anterior	500
o3.lazyreport.maxXSize	Modifica la cantidad máxima de columnas en el modo reporte	50
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 GServer_custom.properties	false
o3.default.graphType	Hace que por defecto se abra en formato grilla si vale 0 se agrega en GServer_custom.properties	1
o3.tcp.port	Modifica el puerto en el que escucha O3 al report se agrega en GServer_custom.properties	7777
o3.accept.without.roles	Si se especifica la siguiente propiedad se hace que una licencia concurrente tome a todos los usuarios como si pertenecieran al rol bi-* se agrega en jboss/server/default/ideasoft-o3/GServer_custom.properties	true
<session-timeout>60</session-timeout>	Cambia el timeout de las sesiones web para O3 se modifica en <o3>/jboss/server/default/deploy/gserver/0o3.ear/o3portal.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 GServer_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 dimensión	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

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>/jboss/server/default/ideasoft-o3/config/rbac/JndiConfiguration-*.properties	true