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.builder.use.apm | Indica al JBoss que lleve una estadística de la construcción de los cubos. Se agrega la property en el O3Builder.properties -→ o3.builder.use.apm=false | true |
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\
En caso de no existir, debe crearse.
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. | true |
rbac.appPermissions.default.o3 | Define los permisos sobre el producto O3, que involucra, los componentes:
| 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. | 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 | 1 |
o3.tcp.port | Modifica el puerto en el que escucha O3 al report | 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) | true |
<session-timeout>60</session-timeout> | Cambia el timeout de las sesiones web para O3 | 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. | 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
|
| o3report.url | En los archivos: | =http://servidor:8082/o3report |
| o3.countdistinct.mapped.enabled | Método eficiente de cálculo de medidas derivadas con count distinct (Contar Distintos) | true |
false a partir de x version 
7.2.5 en adelanteePortal
| Property | Descripción | Valor por defecto |
|---|---|---|
| eportal.welcome.message | Cambia el mensaje del portlet de bienvenida. | Bienvenido a O3 Enterprise Portal |
| eportal.welcome.link | Cambia el texto del link de ingreso al sistema en el portlet de bienvenida. | 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 | true |
o3bi.reportCast.parameter.filename.parse | En O3Server_custom.properties, Property para que los reportes con salida en Excel se generen con el nombre que viene como parámetro en la programación, y no con el nombre del reporte. | true |