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.client.maxYSizeModifica la cantidad de filas máximas que devuelve el server. Se agrega en o3Browser_custom.properties 5000
Dsupport.multiple.screensHabilita 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"

 

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

25.000

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).
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 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.client.maxResultSizeModifica la cantidad de celdas que devuelve el server. Se agrega en O3Server_custom.properties.xxxxx

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

o3.countdistinct.mapped.enabledCambia la forma de cálculo del countdistinct.true
o3.server.startup.checkrulesChequeo de reglas al iniciar el servidor.true
statsHabilta estadísticas de la consulta.false

ePortal

PropertyDescripciónValor 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>\jboss\server\default\deploy\gservereportalthemes\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>\jboss\server\default\deploy\gservereportalthemes\WEB-INF\classes\com\ideasoft\eportal

Ingresar al Sistema
my.places.max.elementsMáxima cantidad de comunidades visibles en el menú de acceso del usuario. Para modificar su valor, se debe agregar la property en el archivo  portal-ext.properties, ubicado en: <03-install>\ jboss\server\default\deploy\liferay.war\WEB-INF\classes y reiniciar el servidor.10

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