This chapter describes setup activities to perform before you create cubes. It discusses the following topics:
Setting Up the Web Applications
In order to use DeepSee in a web application, it is necessary to configure that web application so that it is DeepSee-enabled
. Specifically, a web application is DeepSee-enabled if you select the DeepSee
option when you configure the application; this option enables your application to use the %DeepSee
classes. Similarly, if you select the iKnow
option, the application can use the iKnow/DeepSee classes. For details on configuring web applications, see the chapter Applications
in the Caché Security Administration Guide
The application name has an effect on how the application can be accessed; see the table below.
Note that the sample web application /csp/samples
is already configured to provide access to DeepSee and iKnow.
Placing the DeepSee Globals in a Separate Database
When you use DeepSee in a given namespace, that increases the amount of data stored in the database (or databases) used by that namespace. If the source table is large, DeepSee correspondingly stores a large amount of its own data. The DeepSee caches further increase the storage needs. As a consequence, it is generally a good idea to map some of the DeepSee globals to different databases. You can map all the DeepSee globals to a single database or you can define multiple mappings. As an example, the following steps describe how to place all the DeepSee globals in a single separate database:
When you do so, you might consider pre-expanding the database (that is, setting its initial size), to avoid disk fragmentation created by runtime expansion.
Add a global mapping in the namespace that contains the classes that you plan to use with DeepSee. When you do so:
Also see the next section
for more specific mappings you might use.
For the SAMPLES
namespace, this step also
affects where the DeepSee Patients sample is stored. In this case, you can also create an additional mapping for ^DeepSee.Study.*
as in the following example:
Recompile all cube, subject area, and KPI classes in this namespace.
Alternative Mappings for the Globals
In some cases, you might want to separately map the DeepSee and related globals to separate databases. The following table lists the key globals:
This is not a comprehensive list; DeepSee uses additional globals with names that start ^DeepSee
. Globals not listed here typically contain only small amounts of data or are typically defined only briefly.
Adjusting the CSP Timeout Period
The User Portal is based on ZEN and thus respects the CSP session timeout period for the namespace you are working in. The default session timeout period is 15 minutes, which might not be long enough.
To increase the CSP timeout period:
Go to the Management Portal.
in the row for the namespace in which you are using DeepSee.
Change the value of Session Timeout
, which specifies the default timeout period for the CSP session, in seconds.