Use this window to define new ObjectServer files or edit existing
file details. You can specify a pool of files to write to, and a size at which
rollover to the next file should occur. You can also specify a single file
with a finite, or unlimited, file size.
Complete this window as follows:
- Name
- Type a unique name for the ObjectServer file; for example, a name that
provides some meaning about its usage. Note that this is not the file name
as it will be created on the file system; to specify this, use the Full
File Path field. If you are editing a file, you cannot change
the name.
Tip: When creating
ObjectServer objects, their names must begin with an uppercase or
lowercase letter, followed by uppercase or lowercase letters, numbers,
or underscore (_) characters, up to 40 characters in length. User,
group, and role names can be any text string up to 64 characters in
length and can include spaces. Names of ObjectServer objects are
case-sensitive.
- Full File Path
- Type the full path and file name of the physical file; for example, /opt/netcool/omnibus/log/status.log.
Note: A
number is automatically appended to the file name on the file system.
- Enabled
- Select this check box to activate the ObjectServer file. If not activated,
the file will exist on the file system, but cannot be written to. You can
specify the ObjectServer file information and then activate the file at a
later time.
- Unlimited File Size
- Select this check box if you want information to be written to a single
file with an unlimited size. If you choose this setting, the Max.
Size and Max. Files fields are not displayed
in the window.
- When this check box is clear, information can be written to a single file,
or to a pool of files that will each be written to in turn when a specified
maximum size is reached. If you choose this setting, you must specify associated
values in the Max. Size and Max. Files fields.
- Truncate
- Click this button to clear any information that has been written to the
physical file. This does not delete the file. In situations where there is
more than one physical file in a set, only the file that is currently being
written to on the file system is truncated.
Note: This button is
visible only when you are editing file details.
- Max. Size
- Specify the maximum ObjectServer file size and then select a unit of measurement.
The minimum file size is 1 KB and the maximum file size is 4 GB.
Note: The
operating system may place further restrictions on the maximum size of a single
file.
- Max. Files
- Specify the maximum number of ObjectServer files to create.
Saving your file details
After
creating or editing the file details, you can save or cancel the changes made
by clicking the relevant button as follows:
- OK
- Click this button to save the file details and close the window. New file
details are added to the Log Files pane.
- Cancel
- Click this button to close the window without saving your changes.