UNLOAD APPLICATIONS – DATABASES – LOGOUT SESSIONS / CERRAR APLICACIONES – BASES – SESIONES

English (Español a continuación)

Sometimes, mainly for maintenance activities or for back-ups, it is necessary to limit access to applications or databases.

To control access there are different actions that can be performed at the server, application, database, user or session level.

These actions can be performed through Maxl or from the console:

1.- Server

a) Stop the server:

There are times when it is necessary to stop the server (for example, to perform certain maintenance or back-ups).

Considerations:

  • You must have administrator permissions.
  • This command stops the Essbase server and closes all applications.
  • Before executing it, make sure that all users are disconnected.

From Maxl:

  • alter system shutdown;

From the EAS console:

  • Right click on the server and select «Disconnect».

2.- Applications

a) Upload / download an application

An application starts automatically:

  • When a user starts a database (for example, making a query), as long as the application has the “startup” option enabled (default option).
  • When saving an outline from a database.
  • It also starts if the autostartup option is activated: it means that when the server starts, the applications are started (by default this option is disabled).

An application can also be started / stopped from Maxl or from the EAS console.

From Maxl:

Start an application:

  • alter system load application {all / “application name”};

The options:

  • all: start all applications.
  • «application name»: starts a specific application.

Stop an application:

  • alter system unload application (all / “application name”) [no_force];

The «no_force» option:

  • If activated: if the application has transactions running, the application does not stop.
  • If not activated: the application stops even if it has transactions running. By default, it is disabled.

From the EAS console:

  • In the node «Applications», under the server, right-clicking opens a drop-down with the options «Start all applications» / «Stop all applications».
  • In each individual application, right-clicking opens a drop-down with the options «Start» / «Stop».

b) Enable / disable commands

From Maxl:

Command:

  • alter application «application name» enable commands;

Characteristics:

  • It’s the default option.
  • Allows to cancel the next command.

Command:

  • alter application «application name» disable commands;

Characteristics:

  • This command is used for security purposes to prevent database updates while performing maintenance or application-level updates.
    • You cannot make queries, modify the outline, upload data, run calculations, connect to a database …
  • It affects all users, even the rest of the administrators.
  • It prevents making all kinds of requests to any application database, whether related to data (receiver, calculations …) or others (see information on the database, change the setting of the databases …).
  • It remains in effect as long as the session in which it has been requested is open.
  • Maintenance operations must be carried out within the same session.

c) Enable / disable data updates

From Maxl:

Command:

  • alter application «application name» enable updates;

Characteristics:

  • It’s the default option.
  • Allows to cancel the next command.

Command:

  • alter application «application name» disable updates;

Characteristics:

  • Disables all users from making data update requests to any application database.
    • You can make queries, modify the outline, connect to a database …
    • You cannot upload data, run calculations …
  • It remains in effect as long as the session in which it has been requested is open.
  • It is used when maintenance or updating operations are going to be carried out that require not to modify the data. These operations have to be carried out within the same session in which this instruction has been applied.

d) Enable / disable connections

From Maxl:

Command:

  • alter application «application name» enable connects;

Characteristics:

  • It’s the default option.
  • Allows users with lower permissions than Application Manager to make connections to any application database.
  • Allows to cancel the next command.

Command:

  • alter application «application name» disable connects;

Characteristics:

  • Prevents any user with lower permissions than Application Manager from making connections to the application databases (includes both starting the database and executing ESSCMD SELECT commands).
  • This limitation remains active until the administrator re-enables the connections using the previous instruction.

e) Enable / disable start

From Maxl:

Command:

  • alter application «application name» enable startup;

Characteristics:

  • Start the application.
  • It’s the default option.
  • Allows to cancel the next command.

Command:

  • alter application «application name» disable startup;

Characteristics:

  • Prevents all users from starting the application.
  • If the application is already started, the databases remain operational, but if the application is stopped, it cannot be restarted until this command is disabled by executing the previous command.

3.- Databases

a) Start / Stop database

From Maxl:

To execute these instructions you need at least read permission for the database.

Commands:

  • alter application «application name» load database «database name»;
  • alter application «application name» unload database «database name»;

From the EAS console:

  • Right-clicking on the application opens a drop-down with the options «Start» / «All databases» or «Stop» / «All databases».
  • Right-clicking on a specific database opens a drop-down menu with the options «Start» / «Stop».

b) Enable / disable start

From Maxl:

Commands:

  • alter database «database name» enable startup;

Characteristics:

  • Allows users to start a database, either directly or through a request that involves starting the database.
  • It’s the default option.

Command:

  • alter database «database name» disable startup;

Characteristics:

  • Prevents all users from starting a database, either directly or through a request that involves starting the database.

4.- Users / Sessions / Requests

To end sessions or to end a request you must have administrator permissions (if it is at the server level) or Application Manager (if it is at the application level).

  • You can only end sessions or requests for users with permissions equal to or lower than yours.

Concepts:

  • Session: is the time that elapses between the login and the logout of a user.
  • Request – This is a query sent to the Essbase server by a user or another process (for example, a calculation, a database restructure).

From Maxl:

Command:

  • alter system logout session <SESSION-SPEC> [force];

With this command you can end the session of a user.

<SESSION SPEC>: offers different possibilities:

  • all (ends all active sessions).
  • “session-id” (closes a specific session identified by its ID number; this number can be consulted in the console by viewing the active sessions).
  • by user «user name» { / on application «application name» / on database «database name»} (closes all sessions of a specific user, either on the entire server, either in a specific application, or in a given database).
  • on application «application name» (closes all sessions of all users in a given application).
  • on database «database name» (closes all sessions of all users in a given database).

The “force” parameter can be activated:

  • If it is not activated and there is a transaction running, Essbase waits for it to complete to close that session.
  • If it is activated and there is a transaction running, Essbase waits to bring it to a point where it is safe to finish, then performs a rolled back and ends the session.

Also through Maxl requests can be terminated (the user’s session remains active):

Command:

  • alter system kill request <SESSION-SPEC>;

<SESSION SPEC>: offers different possibilities:

  • all – Terminate all current requests at the server level.
  • «session-id»; terminates a specific request identified by the session ID number (it can be consulted in the console by displaying the current sessions).
  • by user «username»: terminates all requests from a user at the server level.
  • on application «application name»: terminates all requests in a given application.
  • on database «database name»: terminates all requests in a given database.

From the EAS console:

To consult the sessions: right click on the server; select «Edit» and then «Sessions». The window that opens shows all active sessions, providing the following information:

  • User
  • Session ID number
  • Connection time
  • Application
  • Database
  • Connection duration
  • Request
  • Request time
  • Origin of the connection
  • Connection IP
  • Request status

Depending on the permissions that one has, it shows the following information:

  • With Administrator permission shows the active sessions of all users on the server.
  • With Application Manager permission displays the information above but limited to the applications for which you have permission.

This window offers us the following options:

We can select a specific session and:

  • Log off: the session is disconnected.
  • Kill: the request that is being executed in that session is terminated but the user is not disconnected from the session.

The above option can be combined with the following options:

  • Selected user.
  • All users.
  • All instances of the user.

And also the last two options above can be combined with the following options:

  • On the selected server.
  • In the selected application.
  • In the selected database.

We can also activate the option «Use force» (by default it is deactivated).

  • With this option the process is finished without waiting for it to finish.

After selecting the determined option, click on «Apply».

Español

En ocasiones, principalmente por actividades de mantenimiento o para realizar back-ups, es necesario limitar el acceso a aplicaciones o a base de datos.

Para controlar los accesos hay distintas acciones que se pueden realizar a nivel de servidor, aplicación, base de datos, usuarios o sesiones.

Estas acciones se pueden realizar a través de Maxl o desde la consola:

1.- Servidor

a) Detener el servidor:

Hay veces que es necesario detener el servidor (por ejemplo, para realizar ciertas labores de mantenimiento o back-ups).

Consideraciones:

  • Hay que tener permisos de administrador.
  • Este comando detiene el servidor Essbase y cierra todas las aplicaciones.
  • Antes de ejecutarlo hay que asegurarse de que todos los usuarios están desconectados.

Desde Maxl:

  • alter system shutdown;

Desde la consola EAS:

  • Hacer click con el botón derecho sobre el servidor y seleccionar “Desconectar”.

2.- Aplicaciones

a) Cargar / descargar una aplicación

Una aplicación se inicia de forma automática:

  • Cuando un usuario inicia una base de datos (por ejemplo, haciendo una consulta), siempre que la aplicación tenga habilitada la opción “startup” (opción por defecto).
  • Cuando se guarda un outline de una base de datos.
  • También se inicia si se tiene activada la opción autostartup: implica que cuando se inicia el servidor se inician las aplicaciones (por defecto esta opción está deshabilitada).

También se puede iniciar / detener una aplicación desde el Maxl o desde la consola EAS.

Desde Maxl:

Iniciar una aplicación:

  • alter system load application {all / “nombre aplicación”};

Las opciones:

  • all: inicia todas las aplicaciones.
  • “nombre aplicación”: inicia una aplicación determinada.

Detener una aplicación:

  • alter system unload application (all / “nombre aplicación”) [no_force];

La opción “no_force”:

  • Si se activa: si la aplicación tiene transacciones ejecutándose la aplicación no se detiene.
  • Si no se activa: la aplicación se detiene aunque tenga transacciones ejecutándose. Por defecto está desactivada.

Desde la consola EAS:

  • En el nudo “Aplicaciones”, debajo del servidor, haciendo click con el botón derecho se abre un desplegable con las opciones “Iniciar todas las aplicaciones” / “Detener todas las aplicaciones”.
  • En cada aplicación individual, haciendo click con el botón derecho se abre un desplegable con las opciones “Iniciar” / “Detener”.

b) Habilitar / deshabilitar comandos

Desde Maxl:

Comando:

  • alter application “nombre aplicación” enable commands;

Características:

  • Es la opción por defecto.
  • Permite anular el siguiente comando.

Comando:

  • alter application “nombre aplicación” disable commands;

Características:

  • Este comando se utiliza a efectos de seguridad para prevenir actualizaciones de la base de datos mientras se realizan operaciones de mantenimiento o actualizaciones a nivel de aplicación.
    • No se pueden realizar consultas, modificar el outline, subir datos, ejecutar cálculos, conectarse a una base de datos…
  • Afecta a todos los usuarios, incluso al resto de administradores.
  • Impide realizar todo tipo de solicitudes a cualquier base de datos de una aplicación, ya sean relativas a dato (receiver, cálculos…) u otras (ver información de la base, cambiar los parámetros (setting) de las bases…).
  • Se mantiene en efecto mientras se mantenga abierta la sesión en la que se ha solicitado.
  • Las operaciones de mantenimiento se deben realizar dentro de esa misma sesión.

c) Habilitar / deshabilitar actualizaciones de datos

Desde Maxl:

Comando:

  • alter application “nombre aplicación” enable updates;

Características:

  • Es la opción por defecto.
  • Permite anular el siguiente comando.

Comando:

  • alter application “nombre aplicación” disable updates;

Características:

  • Deshabilita a todos los usuarios a realizar solicitudes de actualización de datos a cualquier base de datos de la aplicación.
    • Se pueden realizar consultas, modificar el outline, conectarse a una base de datos…
    • No se pueden subir datos, ejecutar cálculos…
  • Se mantiene en efecto mientras se mantenga abierta la sesión en la que se ha solicitado.
  • Se utiliza cuando se van a realizar operaciones de mantenimiento o de actualización que exijan no modificar los datos. Estas operaciones se tienen que realizar dentro de la misma sesión en la que se ha aplicado esta instrucción.

d) Habilitar / deshabilitar conexiones

Desde Maxl:

Comando:

  • alter application “nombre aplicación” enable connects;

Características:

  • Es la opción por defecto.
  • Permite a los usuarios con permisos inferiores a los de Application Manager hacer conexiones con cualquier base de datos de la aplicación.
  • Permite anular el siguiente comando.

Comando:

  • alter application “nombre aplicación” disable connects;

Características:

  • Impide a cualquier usuario con permisos inferiores a los de Application Manager hacer conexiones con las bases de datos de la aplicación (incluye tanto iniciar la base como ejecutar comandos ESSCMD SELECT).
  • Esta limitación se mantiene activa hasta que el administrador vuelva a habilitar las conexiones mediante la instrucción anterior.

e) Habilitar / deshabilitar iniciar

Desde Maxl:

Comando:

  • alter application “nombre aplicación” enable startup;

Características:

  • Permite iniciar la aplicación.
  • Es la opción por defecto.
  • Permite anular el siguiente comando.

Comando:

  • alter application “nombre aplicación” disable startup;

Características:

  • Previene a todos los usuarios de iniciar la aplicación.
  • Si la aplicación ya está iniciada las bases siguen operativas, pero si se detiene la aplicación no se puede reiniciar mientras no se desactive este comando ejecutando el comando anterior.

3.- Bases de datos

a) Iniciar / Detener base de datos

Desde Maxl:

Para ejecutar estas instrucciones hace falta al menos permiso de lectura de la base de datos.

Comandos:

  • alter application “nombre aplicación” load database “nombre base de datos”;
  • alter application “nombre aplicación” unload database “nombre base de datos”;

Desde la consola EAS:

  • Haciendo click con el botón derecho sobre la aplicación se abre un desplegable con las opciones “Iniciar”/ “Todas las bases de datos” o “Detener”/ “Todas las bases de datos”.
  • Haciendo click con el botón derecho sobre una base de datos determinada se abre un desplegable con las opciones “Iniciar” / “Detener”.

b) Habilitar / deshabilitar iniciar

Desde Maxl:

Comandos:

  • alter database “nombre base de datos” enable startup;

Características:

  • Permite a los usuarios iniciar una base de datos, bien directamente, bien mediante una solicitud que conlleve iniciar la base de datos.
  • Es la opción por defecto.

Comando:

  • alter database “nombre base de datos” disable startup;

Características:

  • Impide a todos los usuarios iniciar una base de datos, bien directamente, bien mediante una solicitud que conlleve iniciar la base de datos.

4.- Usuarios / Sesiones / Solicitudes

Para finalizar sesiones o para terminar una transacción hay que tener permisos de administrador (si es a nivel servidor) o Application Manager (si es a nivel de aplicación).

  • Sólo se pueden finalizar sesiones o solicitudes para usuarios con permisos iguales o inferiores al tuyo.

Conceptos:

  • Sesión: es el tiempo que transcurre entre el login y el logout de un usuario.
  • Solicitud: es una petición enviada al servidor de Essbase por un usuario o por otro proceso (por ejemplo, un cálculo, una reestructuración de una base de datos).

Desde Maxl:

Comando:

  • alter system logout session <SESSION-SPEC> [force];

Con este comando se puede finalizar la sesión de un usuario.

<SESSION SPEC>: ofrece distintas posibilidades:

  • all (finaliza todas las sesiones activas).
  • “sesión-id” (cierra una sesión determinada identificada por su número ID; este número se puede consultar en la consola viendo las sesiones activas).
  • by user “nombre usuario” {  / on application “nombre aplicación” / on database “nombre base de datos”} (cierra todas las sesiones de un usuario determinado, bien en todo el servidor, bien en una aplicación determinada, bien en una base de datos determinada).
  • on application “nombre aplicación” (cierra todas las sesiones de todos los usuarios en una aplicación determinada).
  • on database “nombre base de datos” (cierra todas las sesiones de todos los usuarios en una base de datos determinada).

El parámetro “force” se puede activar:

  • Si no se activa y hay una transacción que se está ejecutando, Essbase espera a que finalice para cerrar esa sesión.
  • Si se activa y hay una transacción que se está ejecutando, Essbase espera a llevarla a un punto en el que es segura su finalización para a continuación realizar un rolled back y finalizar la sesión.

También a través de Maxl se pueden finalizar solicitudes (la sesión del usuario se mantiene activa):

Comando:

  • alter system kill request <SESSION-SPEC>;

<SESSION SPEC>: ofrece distintas posibilidades:

  • all: termina todas las solicitudes actuales a nivel de servidor.
  • “sesión-id”; termina una solicitud determinada identificada por el número ID de la sesión (se puede consultar en la consola desplegando las sesiones actuales).
  • by user “nombre usuario”: termina todas las solicitudes de un usuario a nivel de servidor.
  • on application “nombre aplicación”: termina todas las solicitudes en una determinada aplicación.
  • on database “nombre base de datos”: termina todas las solicitudes en una determinada base de datos.

Desde la consola EAS:

Para consultar las sesiones: hacer click con el botón derecho sobre el servidor; se selecciona “Editar” y luego “Sesiones”. La ventana que se abre muestras todas las sesiones activas, facilitando la siguiente información:

  • Usuario
  • Nº ID de la sesión
  • Hora de conexión
  • Aplicación
  • Base de datos
  • Tiempo de conexión
  • Solicitud
  • Hora de solicitud
  • Origen de la conexión
  • IP de conexión
  • Estado de solicitud

En función de los permisos que uno tiene muestra la siguiente información:

  • Con permiso de Administrador muestra las sesiones activas de todos los usuarios en el servidor.
  • Con permiso de Application Manager muestra la información anterior pero limitada a las aplicaciones de la que se tiene permiso.

Esta ventana nos ofrece las siguientes opciones:

Podemos seleccionar una sesión determinada y:

  • Cerrar sesión (log off): se desconecta la sesión.
  • Terminar (kil): se finaliza la solicitud que se está ejecutando en esa sesión pero no se desconecta al usuario de la sesión.

La opción anterior se puede combinar con las siguientes opciones:

  • Usuario seleccionado.
  • Todos los usuarios.
  • Todas las instancias del usuario.

Y también las dos últimas opciones anteriores se pueden combinar con las siguientes opciones:

  • En el servidor seleccionado.
  • En la aplicación seleccionada.
  • En la base de datos seleccionada.

También podemos activar la opción “Usar fuerza” (por defecto está desactivada).

  • Con esta opción se finaliza el proceso sin esperar a que finalice.

Después de seleccionar la opción determinada hay que hacer click en “Aplicar”.