Datastore Users Guide The DataStore storage system

Back to > Overview > Users Guide

The DataStore storage system

1. A bit about users

Accessing the DataStore can make as registered user or as guest (anonymous). To be an registered user you must ask from DataStore system administrator. Accessing the DataStore as guest, you can use as username: guest and password: guest. You can use a secure communication if you have a JSSE java packages or you already had a trusted user (your public key already registered and signed)

2. Directories like subtrees

The filesystem directory term in the DataStore means subtree

2.1. Subtree types

The subtrees can have different storage types. The type is depend the format of document which will be stored. The type can be:

• free - the document will be stored without parsing for elements, the information in tags cannot be searched. Can stored every type of document (ex: HTML, TXT, XML).
• free_tag - the document will be stored without parsing for elements, the information in tags will be searchable. Can store every type of document (ex: HTML, TXT, XML).
• flexible - the document will be parsed and must be well formatted, the DTD file will be created automatically on server. Can store only XML documents.
• strict - the document will be parsed, must be well formatted and valid XML document, the DTD file must exists on the server. The location of the DTD file is same as the location (subtree) of the stored document. The document root element must be same as the name of the DTD file.

2.2. Creating subtrees

When you create one directory with the smtree command using the -create option, your created subtree type will have a default tree type. The type of default is one of the four tree types and can be set only by the DataStore system administrator.

After creating the subtree the user will have full access (read, write) other users from that group will have only the read access.

The tree type can be changed with the smtree command using the -chtype option.

3. Change the owner and mode

The accepted modes for the subtrees and the documents is: read, write. If you have permission you can change the subtrees and documents mode using the smchmod command with options: u (user) o (other) g (group) a (all) + (set) - (unset) r (read) w (write)

4. Commands that can be used

• smchmod, smchown - full permissions, targets can be only users
• smtree, smquery - full permissions, targets can be users, groups
• smuser, smgroup - needs root privilages, can use only the -list option