As part of the Smarts deployment and configuration process, you need to modify certain files. User modifiable files include configuration files, rule set files, templates, and files (such as seed files, and security configuration files) that contain encrypted passwords. Original versions of these files are installed into appropriate subdirectories under the BASEDIR/smarts/ directory.

Original versions of files should not be altered. If a file requires modification, it must be stored as a local copy of the file in BASEDIR/smarts/local or one of its subdirectories.

Example 1 --- Modify serverConnect.conf

In UNIX:
  • The original version of the server connect (serverConnect.conf) security configuration file on UNIX is installed to:/opt/InCharge7/SAM/smarts/conf
  • A modified serverConnect.conf security configuration file on UNIX should besaved to:/opt/InCharge7/SAM/smarts/local/conf

Smarts software is designed to first search for user modifiable files in BASEDIR/smarts/local or one of its subdirectories. If a modified version of a file is not found in the local area, Smarts software then searches appropriate nonlocal directories.

To facilitate proper file editing, Corporation provides the sm_edit utility with every Smarts product suite. When used to modify an original version of a file, this utility automatically creates a local copy of the file and places it in the appropriate location under BASEDIR/smarts/local. This ensures that the original version of the file remains unchanged. You can invoke sm_edit from the command line. Optionally, you can configure Windows so that sm_edit is automatically invoked when user-modifiable files are double-clicked in Windows Explorer.

To invoke the sm_edit utility from the command line, specify the path and the name of the file to edit under BASEDIR/smarts. If multiple Smarts products are running on the same host, invoke sm_edit from the bin directory of the product suite with the files to edit.

Example 2 --- Edit a configuration file

To edit the configuration file for connecting to a server (serverConnect.conf), invoke the sm_edit utility as follows:

/opt/InCharge7/SAM/smarts/bin>sm_edit conf/serverConnect.conf

In this example, the sm_edit utility automatically creates a local copy of the serverConnect.conf file in the /opt/InCharge7/SAM/smarts/local/conf directory and opens the file in a text editor. If a local version of the file already exists, the sm_edit utility opens the local version in a text editor. In addition, sm_edit creates any necessary subdirectories.

The Smarts System Administration Guide provides additional information about the sm_edit utility.