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.
Data is not available for the Topic
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: <>()\