Configuring a file store for an existing object storeThis document uses an extended example to show you how to configure a file store for an existing object store by using a file system path or a mount path.

When you create an object store by using createObjectStoreForContent, a database storage area is used by default. However, there are other storage options that are available for creating an object store or for creating additional storage areas. These storage options are described in the Microsoft Word document “Storage area types” (storage_area_types_1.docx).

About this task

By default, when an object store is created using a database storage area, a Default Database Storage Area and a Default Database Storage Policy are created. For the purposes of this document and its example, assume that an object store named NEWDB already exists.

In the following figure, the Storage Areas folder contains the Default Database Storage Area and the Storage Policies folder contains the Default Database Storage Policy. In the figure, Default Database Storage Area is selected and the content of its General tab is displayed:

By comparison, in the following figure, Default Database Storage Policy is selected and the content of its General tab is displayed:

In the example procedure, the following activities are performed:

Create a new file store Update the Default Database Storage Policy with the new file store Remove the Default Database Storage Area from the Default Database Storage Policy Create a document to store in the new file store

Procedure

Create a new file store:

1. Create a directory to host the file store content. If the directory is on another system, mount it on the system where Content Platform Engine is installed. (In this example procedure, a directory named /opt/filestore/ is used to host the content of the file store.)

2. In the tree view, right-click Storage Areas and select New Storage Area, as shown in the following figure:

The New Storage Area tab opens, as shown in the following figure:

3. Ensure that File is selected and then click Next.4. In the Display name field, specify a display name. For example, New File Store Storage

Area, as shown in the following figure:

5. Click Next.6. In the Root directory field, specify the root directory that is hosting the file store content. For

example, /opt/filestore/, as shown in the following figure:

7. In the Directory structure size drop-down list, select either Large or Small, as shown in the following figure:

8. In the Maximum number of elements field and the Maximum size field, accept the default values.

9. In the Deletion method drop-down list, you can select Clear, Destroy, or Purge, but accept the default value Clear as shown in the following figure:

10. In the Encryption method drop-down list, you can select Disabled, AES Counter Mode with 256-bit key, or AES Counter Mode with 128-bit key, as shown in the following figure:

11. Select AES Counter Mode with 128-bit key as shown in the following figure:

Note: The AES Counter Mode with 256-bit key selection does not work correctly, but the AES Counter Mode with 128-bit key selection does works correctly. Although the figures in some of

the following steps show that AES Counter Mode with 256-bit key is selected, use the AES Counter Mode with 128-bit key selection.

12. For the remaining fields and properties, accept the default values, which are shown along with the property tooltips in the following four figures:

Update the Default Database Storage Policy with the new file store:

13. Click Next to see the Storage Policy options. 14. Select the Default Database Storage Policy check box, as shown in the following figure:

15. Click Next to view the Summary, as shown in the following figure:

16. Click Finish to complete the creation of the new file store, which is selected in the following figure:

Remove the Default Database Storage Area from the Default Database Storage Policy:

17. In the tree view, select Default Database Storage Policies.18. In the Associated Storage Areas section, select the Default Database Storage Area check box,

as shown in the following figure:

19. Click the Remove button to remove Default Database Storage Area. This ensures that the Default Database Storage Policy only contains New File Store Storage Area, as shown in the following figure:

Note: No new documents will be added to the Default Database Storage Area, because the

Default Database Storage Policy points to the New File Store Storage Area. However, existing documents that were created in the Default Database Storage Area can still be accessed.

20. Click Save. When the save operation has completed, click the Refresh button.

Create a document to store in the new file store:

21. In the tree view, right-click Root Folder, select New Folder, and create a folder named Test. 22. Right-click the Test folder and select New Document, as shown in the following figure:

23. In the Document title field, specify Doc1 and ensure that the class is Document and that the With content check box is selected, as shown in the following figure:

24. Click Next to display the Add button that is used to add content, as shown in the following figure:

25. Click Add and select a large document that will help you to see where the document was stored, as shown in the following figure:

26. Click Next for all the remaining screens and accept their default values, then click Finish to complete the creation of the document. (Note that when creating documents, the default storage policy is always Default Database Storage Policy, which is the reason why the Default Database Storage Area was removed from the Default Database Storage Policy in earlier steps.)

27. In the tree view, select Storage Areas. In the Storage Areas tab, New File Store Storage Area is displayed, as shown in the following figure:

28. If you look at the document property, you can see that it is stored in New File Store Storage Area, as shown in the following figure:

Note: Any new version of a document that is checked in (for a document that is checked out from a Database Storage Area) is added to the New File Store Storage Area. In other words, if any previous versions of the document are in the Default Database Storage Area, any new versions of the document that are checked in will get stored in the New File Store Storage Area.

You have completed the extended example on how to create and manually configure a new file store for storing content.