22.1 Planning a Basic Library

An initial basic library was created along with the first post office when you set up your GroupWise system. That initial basic library is available for immediate use. However, you might want to change the location where documents are stored, as described in Section 22.1.4, Deciding Where to Store Documents. You can also create additional basic libraries as needed.

This section provides the information you need in order to set up a new basic library. Section 22.7.1, Basic Library Worksheet lists all the information you need as you set up a basic library. You should print the worksheet and fill it out as you complete the tasks listed below:

After you have completed the tasks and filled out the worksheet, you are ready to continue with Section 22.2, Setting Up a Basic Library.

22.1.1 Selecting the Post Office That the Library Will Belong To

If you are creating a basic library for each post office in your GroupWise system, print a copy of Section 22.7.1, Basic Library Worksheet for each post office.

If users in several post offices will store documents in the same basic library, you must decide which post office should own the library. A library can never be reassigned to a different post office, so you should choose the owning post office carefully. You should consider which users will use the library most frequently and where you might want to create additional libraries in the future.


Under Item 3: Post Office, specify the name of the post office that will own the new basic library.

22.1.2 Determining the Context for the Library Object

Generally, you should create the Library object in the same context as its post office. You cannot move a Library object after you have created it.


Under Item 1: eDirectory Container, specify the container for the Library object.

22.1.3 Choosing the Library Name

When you create the Library object, you must give the library a name. This is the name that is displayed in ConsoleOne.

After you have specified the library’s name and created the Library object, the name cannot be changed. Therefore, if you have or will have other libraries, you should pick a name that uniquely identifies the library. For example, use the name to identify the post office it is assigned to.

Do not use any of the following invalid characters in the library’s name:

ASCII characters 0-31

Comma ,

Asterisk *

Double quote "

At sign @

Extended ASCII characters that are graphical or typographical symbols; accented characters in the extended range can be used

Backslash \

Parentheses ( )

Braces { }

Period .

Colon :

Slash /

By default, the library name that users see in the GroupWise client is the same as the Library object name. However, you can change the display name if you want it to be different from the Library object name.


Under Item 2: Library Name, specify the Library object name.

Under Item 7: Library Description, provide a brief description of the planned use for the library.

Under Item 8: Display Name, specify the library name you want users to see in the GroupWise client, if it is different from the Library object name.

22.1.4 Deciding Where to Store Documents

You can store documents at the post office in the post_office\gwdms\library\docs subdirectory of the post office. You can later add document storage areas outside the post office if DMS usage grows. However, the documents stored at the post office can never be moved.

A document storage area has the same internal directory structure that is used to store documents at the post office, but it can be located anywhere in your system. Document storage areas can be moved easily, so it is easy to expand your document storage capacity when you store documents in document storage areas rather than at the post office.

You might want to set up a document storage area on the same server where the POA runs so as not to increase network traffic. The POA can index and serve documents to users most efficiently if the document storage area is located locally.


Under Item 4: Store Documents at the Post Office?, mark Yes or No. (No is recommended for permanent document storage).

To define a document storage area, you must know its direct access path. For example, a UNC path specifies the absolute location of the document storage directory.


For example:


NOTE:On Linux, ConsoleOne interprets a UNC path so that the first item in the UNC path is the Linux server hostname, followed by a Linux path to the document storage area.


If you entered No for Item 4, specify the direct access path under Item 6: Document Storage Area Path.

Under Item 5: Document Storage Area Description, enter a useful description of the document storage area. (This description is displayed only in ConsoleOne.)

If you need to add a document storage area to the initial library that was created with the first post office in your GroupWise system, use the Storage Areas properties page of the Library object in ConsoleOne to provide the direct access path, as described in Adding a Document Storage Area.