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

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 Definirse en el archivo GServer_custom.properties ubicado en:O3_INSTALL_DIR\jboss\server\default\ideasoft-o3	true
-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	5000
o3.client.maxXSize	Modifica la cantidad de columnas máximas que devuelve el server se agrega en GServer_custom.properties	500
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