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 |
|
- Application Configuration concepts
- Application Configuration objects
- Configuration templates and script templates
- Value sets
- Value Set Editor
- Running scripts with Application Configurations
- Push Application Configurations to servers
- Application Configuration compliance
- Application Configuration audits
- Application Configurations in software policies
Run scripts with Application Configurations
You can add scripts to an Application Configuration that are executed before or after the configuration values are copied to the target server.
For example, you might want to add a Pre-install script that stops an application and a Post-install script that restarts the application after configuration changes have been made. If an error occurs during the push or post-install script, you can run a Post-error script.
Or you might need a Data-manipulation script to handle non-text configuration data. If you are configuring an IIS server, you can use a Data-manipulation script to read the metabase information into a flat file. When the information in the flat file gets parsed with the configuration template, you can run a Post-install script to write the updated information back to the metabase information.
Caution When pushing an application configuration that contains a JScript or VBScript pre-install, post-install or post-error script, the push may succeed even if the script fails. In these cases, the push ignores the script errors. The application configuration does not detect the script failure and allows the push to complete without errors. If you plan to use these types of scripts, you must make sure that the scripts are free of errors and ensure the script returns a non-zero exit status by invoking WScript.Quit(<status>).
Types of Application Configuration scripts
The following table lists the types of scripts you can use in application configuration objects. The script type specifies when the script is invoked. You can define at most one of each script type. If you define a script but do not specify one of these types, that script will be treated like a configuration template. That is, it will be pushed to the server but not executed.
Script type |
Description |
---|---|
Data-manipulation |
Runs before any pre-install script and serves the purpose of parsing a non-text configuration file to make it parseable by the CML template. The data-manipulation script is also useful when you only want to scan and import an existing file managed by the application configuration. If this script fails, the application configuration is not pushed to the server. |
Pre-install |
Runs before an actual push occurs. For example, a pre-install script could stop an application or service. If this script fails, the application configuration is not pushed to the server. |
Post-install |
Runs after the actual push occurs. For example, a post-install script could restart a service after a push. |
Post-error |
Runs only if the push fails or if the post-install script fails. For example, a post-error script could restore a backed-up file. |
To specify the script type:
- In the SA Client, open the application configuration object that contains the template.
- Select the Configuration Values view to display the templates contained in the application configuration object.
- Select the template and right-click to display the menu.
- Select the script type, listed in the above table.
- Select the File > Save menu.
See also Create a template from a script.
The above table lists the types of scripts you can use in application configuration objects. This type specifies the syntax and execution environment of the script.
Script source type |
Description |
---|---|
Windows .BAT script |
Windows batch command files. |
Windows .JS script |
Javascript files running on Windows. |
Windows .CMD script |
Windows batch command files. |
Windows .VBS script |
Windows Visual Basic script. |
Windows .WSF script |
Windows script file. |
Windows .PY script |
Python file running on Windows. |
Unix .SH script |
Unix shell scripts. |
Other Unix scripts |
Any other scripts that run on Unix. |
To specify the script type:
- In the SA Client, open the template.
- Select the Properties view.
- In the Type field, select the script type, listed in the above table.
- Select the File > Save menu.
See also Create a template from a script.
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: