As part of the VMware Telco Cloud Service Assurance 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. Examples follow:
The original versions of the Global Manager configuration files on UNIX are installed to /opt/InCharge/SAM/smarts/conf/ics
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. For example:
A modified dxa-sam.conf file on UNIX should be saved to /opt/InCharge/SAM/smarts/local/conf/ics
VMware Telco Cloud Service Assurance 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, the software then searches appropriate nonlocal directories.
To facilitate proper file editing, VMware, Inc. provides the sm_edit utility with every product. 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.
To invoke the s m_edit utility from the command line, specify the path and the name of the file to edit under BASEDIR/smarts. If multiple products are running on the same host, invoke sm_edit from the bin directory of the product with the files to edit.
To edit the configuration file for the Global Manager, invoke the sm_edit utility as follows:
# /opt/InCharge/SAM/smarts/bin>sm_edit conf/ics/dxa-sam.conf
In this example, the sm_edit utility automatically creates a local copy of the dxa-sam.conf file in the /opt/InCharge/SAM/smarts/local/conf/ics 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 System Administration Guide provides additional information about the sm_edit utility.