Searching the Help
To search for information in the Help, type a word or phrase in the Search box. When you enter a group of words, OR is inferred. You can use Boolean operators to refine your search.
Results returned are case insensitive. However, results ranking takes case into account and assigns higher scores to case matches. Therefore, a search for "cats" followed by a search for "Cats" would return the same number of Help topics, but the order in which the topics are listed would be different.
Search for | Example | Results |
---|---|---|
A single word | cat
|
Topics that contain the word "cat". You will also find its grammatical variations, such as "cats". |
A phrase. You can specify that the search results contain a specific phrase. |
"cat food" (quotation marks) |
Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase. |
Search for | Operator | Example |
---|---|---|
Two or more words in the same topic |
|
|
Either word in a topic |
|
|
Topics that do not contain a specific word or phrase |
|
|
Topics that contain one string and do not contain another | ^ (caret) |
cat ^ mouse
|
A combination of search types | ( ) parentheses |
|
Web Services Data Access Engine configuration parameters
This section discusses how to change Web Services Data Access Engine system configuration parameters using the SA Client or by editing the configuration file.
You must restart the Web Services Data Access Engine after changing any system configuration parameters.
- Changing a system configuration parameter
- Web Services Data Access Engine configuration file
- Increasing the Web Services Data Access Engine maximum heap memory allocation
Changing a system configuration parameter
This section describes how to change some of the system configuration parameters with the SA Client. Other parameters can only be changed by editing a configuration file as described in Web Services Data Access Engine configuration file.
To change a system configuration parameter for the Web Services Data Access Engine in the SA Client:
- Select the Administration tab in the SA Client.
- From the navigation pane select System Configuration > Configuration Parameters. This displays the SA components, facilities, and realms that have system configuration parameters.
- From the list of SA components, select Web Services Data Access Engine. This displays the system configuration parameters for this component.
- Locate and modify the system configuration parameters you want to change.
- Select Revert to discard your changes or the Save button to save your changes.
- Restart the Web Services Data Access Engine with the following command:
/etc/init.d/opsware-sas restart twist
Web Services Data Access Engine configuration file
The Web Services Data Access Engine configuration file includes properties that affect the server side of the SA Web Services API 2.2. (These properties are not displayed in the SA Client.) The fully qualified name of the configuration file is as follows:
/etc/opt/opsware/twist/twist.conf
During an upgrade of SA, the twist.conf
file is replaced, but the twist_custom.conf
file is preserved. When you upgrade to a new version of SA, to retain the configuration settings, you must edit the twist_custom.conf file. The properties in twist_custom.conf
override those specified in twist.conf
. The UNIX twist
user must have write access to the twist_custom.conf
file.
To change a property defined in the configuration file:
- Edit the
twist.conf
file with a text editor. - Save the changed file.
- Restart the Web Services Data Access Engine on the server.
You must belong to the Administrators group (admin) to modify the twist.conf
file. Once the file is changed, the Web Services Data Access Engine must be restarted to apply the changes.
The following table lists the properties of the configuration file that affect the SA Web Services API 2.2. Several of these properties are related to the cache (sliding window) of server events. SA maintains a sliding window (with a default size of two hours) of events describing changes to SA objects. This window makes enables software developers to update a client-side cache of objects without having to retrieve all of the objects. For more information, see the API documentation for EventCacheService
.
Property |
Default |
Description |
---|---|---|
|
|
An integer value that sets the debug level for the SA Web Services API on the server side. Allowed values: 0 - basic info |
|
|
The country Internationalization parameter for the Localizer utility. Currently only the US code is supported. |
|
|
Sets the language Internationalization parameter for the Localizer utility. Currently only the en code is supported. |
|
|
In minutes, the size of the sliding window maintaining the server event cache. |
|
|
In minutes, the sliding scope for the window maintaining the server event cache. |
|
|
In minutes, the safety buffer for the sliding window maintaining the server event cache. |
|
30 |
In minutes, the minimum size of the sliding window that maintains the server event cache. |
|
|
In minutes, the maximum size of the sliding window that maintains the server event cache. |
Increasing the Web Services Data Access Engine maximum heap memory allocation
As data size in a multimaster mesh grows, you may find that you must increase the maximum heap memory allocation for the Web Services Data Access Engine (twist
). The default value is 1280Mb. To do so, perform the following tasks:
- Using a text editor, open the file:
/etc/opt/opsware/twist/twist_custom.conf
- Modify the following entry to the required allocation:
twist.mxMem=<memory size>
where memory size corresponds to
-Xmx<memory size>
.For example:
twist.mxMem=2048m
would give the Web Services Data Access Engine a maximum of 2048 megabytes of heap memory. This change is preserved even after an upgrade. If you leave this
twist_custom.conf
parameter blank, the default value (1280m) specified intwist.sh
is used.
We welcome your comments!
To open the configured email client on this computer, open an email window.
Otherwise, copy the information below to a web mail client, and send this email to hpe_sa_docs@hpe.com.
Help Topic ID:
Product:
Topic Title:
Feedback: