This chapter describes how to set preferences to control Sun Update Connection – Enterprise operations.
The preferences for the dependency manager can be viewed and edited only by the admin user.
This chapter covers the following topics:
The following procedures explain how to access, edit, apply, and share changes among multiple hosts.
You can view and change the way the console behaves. You can view and change preferences for any agent application that is installed on a managed host, and then propagate the changes to other hosts.
If you have the admin user password, you can change the preferences for the dependency manager.
You can also set preferences for the Sun Update Connection – Enterprise server from the preferences of each of the applications. You can change the directories where downloads from the servers are kept and the protocol for the applications to communicate with each other.
Log into the console.
If you want to access the dependency manager parameters, log in as the admin user.
Do one of the following:
The Preferences window opens.
Console Preferences let you control how the Sun Update Connection – Enterprise GUI operates, where files are to be stored, how it communicates with the system dependency server, and advanced background job options.
In the Preferences window, select the Console radio button.
The preferences for the console are accessible by default.
Make the changes that you want.
If you want to change various preferences in different categories of the selected entity, you can browse between the categories without clicking Submit every time. Your changes are remembered.
These parameters determine file upload and download times and let you set the path name of the web browser.
File timeout. Specifies the time limit in seconds for a file to upload to or download from a remote host (see Opening Host Files).
Take into account local network traffic and physical distance when changing this value.
Path. Specifies the path to the web browser that Sun Update Connection – Enterprise opens from the Component Information window.
To find the path of the current browser, in a terminal window, type which browser.
Browser. Specifies the browser that Sun Update Connection – Enterprise opens.
These parameters are fine-tuning for running and monitoring jobs.
Max items in a job. Specifies the warning limit for a job that is created in the Inventory Comparison window. The unit is the task items in a job.
If no value is specified, the user is warned that job might be too big to succeed.
Prerequisite details. Specifies whether to to show data in the Host Progress window that is found by local probes.
This preference is deselected by default to save on resources.
Status window refresh interval. Specifies the time interval in seconds between data adjustment of jobs status in the Jobs panel.
These parameters are the path names and sizes for the console logs.
Error log file name. Specifies the full path name of the error log of the console application.
Error log size. Specifies the size limit in kbytes of the error log. If no value is specified, the log is deleted.
Job log file name. Specifies the full path name of the job log.
Job log size. Specifies the size limit in kbytes of the job log. If no value is specified, the log is deleted.
Host preferences manage how each agent handles Sun Update Connection – Enterprise jobs and logs, and how Sun Update Connection – Enterprise recognizes the host.
You may view the preferences of only one host at a time.
The host must be online and the agent must be connected to the SDS.
The agent must not be busy at the time with an Sun Update Connection – Enterprise job.
In the Preferences window, select the Host radio button.
The Host Selection window opens.
Select a single host and then click OK.
Wait while the Preference values of the selected agent are uploaded to the console.
Preference values can be uploaded only if the agent is not busy with another command.
Make the changes that you want.
If you want to change various preferences in different categories of the selected entity, you can browse between the categories without clicking Submit every time. Your changes are remembered.
You can change the preferences of one host, and apply those changes to multiple hosts. For example, if you want all managed hosts in one group to be configured for a new port, you can make the change once, and then share the new port number with all the other hosts in the group.
Make the changes you want, submit them, restart the agent, and wait for changes to be uploaded.
Open the Preferences window again select the original host.
Click Select target hosts.
The Select Hosts window opens.
Add multiple hosts to the Selected Hosts list and then click OK.
The preferences that you changed in the original host are copied to the selected hosts.
You can choose to share preferences with offline hosts. Their preferences are updated when they come online.
The following parameters offer various options for a specific host.
Listening port. Specifies the port on which to listen for the dependency manager.
Clean-up after instal. Specifies whether to delete no-longer needed RPM files after component is installed to save disk space.
These preferences point to the log files and set limits on their sizes. These logs are kept on the remote host.
Error log size. Specifies the size in kbytes of the error log for this agent.
NCO log file size. Specifies the size in kbytes of the log for local components installed on this managed host.
Job log size – Specifies the size in kbytes of the job log for this agent.
Resolve log file size. Specifies the size in kbytes of the log for each job action and for alternative job solutions.
Error log file name. Specifies the full path name of the error log.
NCO log file name. Specifies the full path name of the NCO log.
Job log file name. Specifies the full path name of the job log.
Resolve log file name. Specifies the full path name of the resolve log.
The following parameters describe how Solaris packages are installed on Solaris machines. When you install the Sun Update Connection – Enterprise Agent on a Solaris machine, the path name of the Solaris admin file is /opt/local/uce/agent/config_files/admin. This file holds the answers for package deployment. You can change these parameters in the Preferences -> Host -> PKGs window, to change the parameters individually for a specific host, or you can point Sun Update Connection – Enterprise to your own customized Solaris admin file.
Mail address. Specifies the address to which notification emails are sent when PKGs are installed.
Package install basedir. Specifies the base directory where relocatable packages are to be installed.
Partial. Specifies one of the following if a package is partially installed on this managed host.
nocheck. Do not check for partially installed packages.
quit. Do not install the package if it is already partially installed.
RunLevel. Specifies one of the following if the system status is not correct for the installation or uninstallation of a package.
nocheck. Do not check the run level.
quit. Do not install or uninstall if run level requirement is not met.
Install depend. Specifies one of the following if other packages depend on the one being installed.
nocheck. Do not check for dependencies.
quit. Do not install a package if its dependencies are not met.
Remove depend. Specifies one of the following if other packages depend on the one that you want to uninstall.
nocheck. Do not check for dependencies.
quit. Do not uninstall a package that is needed by others.
Check space. Specifies one of the following if the disk space of this managed host does not meet the installation requirements of the package.
Setuid flags. Specifies one of the following if a package should enable the setuid flag or the setgid flag after installation. These flags are used in Solaris programming for security.
nocheck. Do not check for the setuid executable or the setgid executable.
quit. Do not install the package if it will turn on these flags.
nochange. Install the package but override the flags.
Check conflicts. Specify one of the following if the installation of a package will overwrite a file that is provided by another package that has been installed and will create a conflict between files.
nocheck. Do not check for conflicts and force the installation.
quit. Do not install the package if file conflicts are detected.
nochange. Install the package but do not install the conflicting files.
Action scripts. Specify one of the following if the installation of a package provides an action script that contains possible security impacts.
nocheck. Do not check for security impact of action scripts.
quit. Do not install the package if its action scripts could negatively impact security.
Custom Admin file full path name. Specify the path name of a customized Solaris admin file. If no path is specified, use the default.
The Dependency Manager Preferences control how the current Dependency Manager (DM) works with consoles and agents.
You must be logged in as the admin user to access these Preferences.
In the Preferences window, select the Dependency Manager radio button.
Wait while the values of the DM preferences are uploaded to the console from the SDS machine.
Make the changes that you want.
If you want to change various preferences in different categories of the selected entity, you can browse between the categories without clicking Submit every time. Your changes are remembered.
The DM acts as a server to the agents and to the console. These parameters determine connection behavior for the DM – Console and the DM – Agent.
Idle Console timeout. Specifies the time limit in seconds before an idle console automatically logs out.
Force change password. Automatically opens the Change Password window when a user first logs in to create a private password. This behavior is the default.
Auto-saved inventories limit. Specifies the limit of the number of automatically saved inventories to be kept for comparisons and rollback. If no value is specified, older stored inventories are deleted.
All agents read-only. Protects all hosts from change by executing all jobs done in simulate mode. This paramter is only applicable to certain testing environments..
Pause Scheduled Jobs. Pauses all scheduled jobs while this checkbox is selected. Use this parameter before updating agents to ensure the application update is not interrupted by a job.
When you clear this checkbox, scheduled jobs whose time to run has passed are run immediately
These parameters give the path names and sizes for the DM logs on the SDS machine.
Error log size. Specifies the size limit in kbytes of the error log. If no value specified, the log is deleted.
Job log size. Specifies the size limit in kbytes of the job log. If no value is specified, the log is deleted.
Error log file name. Specifies the full path name of the error log of the DM application.
Job log file name. Specifies the full path name of the job log of the DM application.
After changing the values of preference parameters of an application, submit the changes and restart the application.
In this procedure you submit the changes you made and restart the target application.
In the Preferences window, click Submit.
The Preferences Confirmation window opens.
If you want to make sure the changes are applied immediately, check the Restart/Logout option.
In the Preferences Confirmation window, click Submit.
The window closes.
Some setting changes are applied immediately. Some changes are applied only after restart. If you want to continue working and have the changes applied later, leave the Restart/Logout option in the Preferences Confirmation window deselected.
To restart the application later, use one of the following from the command line:
Agent – /etc/init.d/uce_agent restart
Console – uce_console
dependency manager – /etc/init.d/uce_engine restart