System information

47
Deploying Parallels Mac Client
Example:
$ sudo ./InstallAgentUnattended.sh http://myhost.local:8761/files/pma_agent.dmg
myname mypass mydomain
If you receive the "Permission denied" error when executing the script, run the following
command to set the file permissions and then execute the script again:
$ chmod 755 InstallAgentUnattended.sh
If you wish, you can hard code the URL, user/password, and the domain parameter values in the
script, so you (or your Mac users) don't have to enter them in the command line. To hard code the
parameter values, open the script in an editor and change the values of the input parameters from
$1, $2, $3, $4 to the desired values. The parameter names in the script are self-explanatory. Once
the script is ready, give it to your Mac users, so they can execute it on their Macs, or use Apple
Remote Desktop to execute it on Macs remotely.
When the script runs on a Mac, it displays the information in the console about the processes that
it's running. When the script completes executing, it returns a numeric code. To see the return
code, run the following command after the scrip finished executing:
$ echo $?
The "0" code returned by the above command indicates that the Mac client has been installed and
registered properly. Any other code indicates a failure (you can also read the last messages in the
console to get an idea of what went wrong).
Configuring Mac OS X Firewall
When the client software is installed on a Mac, the firewall in Mac OS X must be configured to allow
client network communications. When the client is installed on a Mac manually, the Mac user will
be asked if pma_agent.app should be allowed to accept incoming connections. The user can
answer "Allow" or "Deny". The same message is displayed to a Mac user when the client push
installation is performed by network discovery. If the user answers "Deny", the client will have to be
added to the firewall exception list later as described below.
To add the client to the firewall exception list:
1 From the Apple menu, select System Preferences. The System Preferences dialog opens.
2 Select Security & Privacy and then click the Firewall tab.
3 If the firewall is running, the green light indicator will be "on" and its label will read "Firewall: On".
4 Click Advanced. The advanced firewall setting dialog opens.
5 Click the + icon. The Mac directory tree dialog opens.
6 In the directory tree, navigate to the /Library/Parallels folder and select the
pma_agent.app file.
7 Click Add and then click OK.
8 Close the System Preferences window.