Skip to main content
Sign Out

Welcome to Dell

My Account
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
Sign In Create an Account Dell Financial Services Premier Sign In Partner Program Sign In
Contact Us

Your Dell.com Carts

PowerProtect Data Manager 19.17 Oracle RMAN User Guide

PDF

Installation and update requirements for pre-scripts and post-scripts

Before you can use a pre-script or post-script with a backup, you must enable the script usage on the host. By default, the script usage is disabled on the host.

During the application agent installation on Linux or UNIX, you can enable the script usage on the host by responding to an installer prompt. During the installation on Windows, you can select the Allow centralized scripting checkbox in the installation wizard window Configure Installation Options. The installation topic provides more details.

For example, you can respond to the following prompt during the installation on Linux or UNIX: 

Do you want to enable pre-scripts and post-scripts? (y/n) y

On Linux or UNIX, you can optionally use the command option --scriptsEnabled=True when you run the installation script install.sh. This option directly enables the use of pre-scripts and post-scripts on the host, without the installer displaying the prompt: 

install.sh --scriptsEnabled=True

The command option --scriptsEnabled=False disables the use of pre-scripts and post-scripts on the host.

The installation or update process sets the scriptsEnabled parameter in the config.yml file in the directory /opt/dpsapps/agentsvc on Linux or UNIX and C:\Program Files\DPSAPPS\AgentService on Windows. By default, the parameter value is set to false after an update. When the parameter value is set to true, the use of pre-scripts and post-scripts is enabled on the host: 

scriptsEnabled = true

After an application agent installation or update, you can modify the parameter setting in the config.yml file. Modify the parameter by running the following command with the appropriate --scriptsEnabled option setting to enable or disable the script usage on the host:

  • On Linux or UNIX: register.sh scriptsEnabled={true|false}
  • On Windows: register.bat scriptsEnabled={true|false}
NOTE:
  • Depending on settings during installation, the PowerProtect agent service might be installed as a nonprivileged (nonroot) user. In that case, the agent service does not have the permission to run script commands as a privileged user. If a pre-script or post-script includes commands that require privileged user permissions, you must provide the required user credentials at the time of the script upload.
  • Installing the agent service under a nonprivileged account limits the ability of the agent service to inappropriately access and control the application-agent host.

After the application agent is registered with PowerProtect Data Manager, you can use the PowerProtect Data Manager UI to verify that the host is enabled for script usage. In the UI, select Infrastructure > Application Agents and check that Yes appears in the Script Enabled column for the particular host.

Review the following topic that describes how to upload the pre-scripts and post-scripts to the PowerProtect Data Manager server.

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\