Antes de poder comenzar a trabajar con Catalis, hay que preparar la base de usuarios. Por el momento, el procedimiento para administrar esta base es manual.

La base de usuarios, así como los archivos auxiliares asociados, se encuentran en el directorio bases/catalis_pack/catalis/users. (En versiones viejas de Catalis, se la puede encontrar en cgi-bin/catalis_pack/catalis/config.)

La información acerca de cada usuario del sistema se almacena en una base Isis, llamada users. Para facilitar su mantenimiento, esta base se crea a partir de un archivo de texto, users.txt, que tiene la estructura que manejan los utilitarios i2id e id2i de Bireme.

Toda modificación del archivo users.txt deberá ser seguida por la ejecución del script users.sh (Linux) o users.bat (Windows), que se ocupa de regenerar tanto la base de datos users como su archivo invertido. Para ello hay que ubicarse en el directorio bases/catalis_pack/catalis/users y ejecutar el comando

./users.sh [en Linux]

users [en Windows]

En users.txt cada usuario está representado por un bloque como este:

!ID 0 usar '!ID 0' al comienzo de cada usuario
!v001!EAR código que identifica al usuario, p.ej. iniciales del nombre
!v002!UNS institución (una sigla u otra denominación breve)
!v003!xxxxxx contraseña
!v004!Ernesto A. Rodríguez nombre y apellido
!v005!baseA^p3 base a la que accede por defecto este usuario
!v005!baseB^p2 \
!v005!baseC^p3 } otras bases a las que puede acceder el usuario
!v005!baseD^p3 /

(El texto en la columna derecha aparece aquí a modo de explicación; en el archivo solamente debe estar la columna izquierda.)

Para crear un nuevo usuario, hay que agregar uno de tales bloques al archivo users.txt.

Aunque no es necesario, se recomienda separar cada bloque del anterior mediante una o más líneas en blanco.

Una vez creada la base de usuarios inicial, las operaciones de mantenimiento típicas consisten en agregar un nuevo usuario y en modificar la lista de bases a las que cada usuario tiene acceso.

Para permitir el acceso de un usuario a una base (p.ej. libros), se debe agregar una línea como esta:

!v005!libros^p2

Para cancelar el acceso a una base, se debe eliminar la línea correspondiente. Para modificar el nivel de acceso, se debe colocar el número apropiado a continuación de ^p.

El número que aparece a continuación de ^p indica el nivel de permiso asignado a ese usuario para esa base:

1: sólo lectura

2: creación de registros, y modificación de los registros propios (es decir, creados por ese usuario)

3: creación y modificación de cualquier registro de la base

Catalis