Sun Management Center Change Manager 1.0.1 Administration Guide


Numbers and Symbols

	`$SI_ROOT`, description of ( )


A

	accessing Monitor Jobs section, browser interface procedure ( )

	accessing Set Up Files section, browser interface procedure ( ) ( )

	accessing Set Up Hosts & Jobs section, browser interface procedure ( )

	accessing View Logs section, browser interface procedure ( )

	adding Change Manager users ( )

	adding managed hosts
		browser interface procedure ( )
		command-line procedure ( )

	agent port, on managed host ( )

	agents
		installing on master system ( )
		Sun Management Center ( )

	archive parameters ( ) ( )

	audit
		description of ( )
		file properties ( )
		software ( )

	audit files
		audit rules file ( )
		folder ( )
		manifest file ( )
		purpose of ( )
		report file ( )

	audit procedures
		auditing managed hosts
			browser interface procedure ( )
			command-line procedure ( )
		building manifests
			browser interface procedure ( )
			command-line procedure ( )
		creating audit rules files
			browser interface procedure ( )
		getting software status
			browser interface procedure ( )
			command-line procedure ( )
		importing audit rules files
			browser interface procedure ( )
			command-line procedure ( )
		importing manifests
			browser interface procedure ( )
			command-line procedure ( )

	audit rule blocks ( ) ( ) ( )

	audit rules file
		attributes ( )
		`.brul` ( )
		`CHECK` statement ( )
		comments and lines that are ignored ( )
		description of ( ) ( )
		example ( )
		format ( )
		`IGNORE` statement ( )
		ordering `CHECK` and `IGNORE` statements ( )
		pattern matching statements ( )
		rule blocks ( )
		subtree specifications ( )
		syntax ( )

	audit tasks
		auditing ( )
		building manifests ( )
		comparing against a baseline manifest ( )
		getting software status ( )

	auditing managed hosts
		browser interface procedure ( )
		command-line procedure ( )

	auditing software configurations
		browser interface task map ( )
		command-line interface task map ( )
		using the browser interface ( )
		using the command-line interface ( )

	authenticating users, command-line procedure ( )


B

	backing up data ( )

	`.bmft`, manifest suffix ( ) ( )

	boot environments
		specifying one or two with shared profile parameters ( )
		using for updates ( )

	browser interface navigation
		bread crumbs ( )
		description of ( )
		drop-down menus ( )
		Help ( )
		issues ( )
		Log Out ( )
		Monitor Jobs tab ( )
		navigating folders and host groups ( )
		navigating wizards ( )
		Set Up Files tab ( )
		Set Up Hosts & Jobs tab ( )
		View Logs tab ( )

	browser interface procedures
		accessing Monitor Jobs section ( )
		accessing Set Up Files section ( ) ( )
		accessing Set Up Hosts & Jobs section ( )
		accessing View Logs section ( )
		adding managed hosts ( )
		auditing managed hosts ( )
		building manifests ( )
		canceling jobs ( )
		changing agent port on managed host ( )
		changing console session timeout ( )
		copying files ( )
		copying managed hosts ( )
		creating audit rules files ( )
		creating folders ( )
		creating host groups ( )
		creating shared profiles ( )
		deleting files and folders ( )
		exporting files ( )
		falling back to previous version ( )
		getting glossary definitions ( ) ( )
		getting help ( )
		getting online help ( )
		getting software status ( )
		importing archives ( )
		importing audit rules files ( )
		importing boot images ( )
		importing manifests ( )
		importing shared profiles ( )
		importing Solaris Flash archives ( )
		logging in ( )
		modifying managed host properties ( )
		moving files and folders ( )
		moving managed hosts and host groups ( )
		navigating folders and host groups ( )
		navigating wizards ( )
		performing initial installation ( )
		purging completed jobs ( )
		rebooting managed hosts ( )
		reinstalling managed hosts ( )
		removing managed hosts and host groups ( )
		renaming file or folder ( )
		renaming managed host or host group ( )
		rescheduling running jobs ( )
		specifying administrative domain ( )
		updating managed hosts ( )
		viewing and modifying file properties ( )
		viewing folder contents ( )
		viewing host group contents ( )
		viewing job log ( )
		viewing job queue ( )
		viewing transaction log ( )

	`.brul`, audit rules file suffix ( ) ( )

	building manifests
		browser interface procedure ( )
		command-line procedure ( )


C

	canceling jobs
		browser interface procedure ( )
		command-line procedure ( )

	Change Manager
		getting started example ( )
		high-level task map ( )
		main features of ( )
		purpose of ( )

	Change Manager agent module
		installing ( )
		installing on master system ( )

	Change Manager audit files
		See audit files

	Change Manager audit software ( )

	Change Manager database table files ( )

	Change Manager deployment files
		See deployment files

	Change Manager deployment technologies ( )
		custom JumpStart ( )
		Solaris Flash installation ( )
		Solaris Live Upgrade ( )

	Change Manager repository ( )
		See also maintaining the repository
		See also repository maintenance procedures
		organizing folders and files in ( ) ( )

	Change Manager security
		See security

	Change Manager server
		definition of ( )
		files stored on ( )
		hardware and software requirements ( )
		purpose of ( )

	Change Manager server installation
		See server installation procedures

	Change Manager system types
		Change Manager server ( )
		managed host ( )
		master system ( )

	Change Manager user access, authorizing ( )

	Change Manager users ( )

	changemgr(1MCM), command-line interface ( ) ( ) ( ) ( )

	changing agent port on managed host
		browser interface procedure ( )
		command-line procedure ( )

	changing console session timeout, procedure ( )

	`CHECK` statement, audit rules file ( )

	cmgetprop(1MCM) ( ) ( )

	`.cmsp`, shared profile suffix ( ) ( )

	command-line interface
		changemgr(1MCM) ( ) ( ) ( ) ( )
		issues ( )

	command-line procedures ( )
		adding managed hosts ( )
		auditing managed hosts ( )
		authenticating users ( )
		building manifests ( )
		canceling jobs ( )
		changing agent port on managed host ( )
		copying managed hosts ( )
		creating folders ( )
		creating host groups ( )
		deleting files and folders ( )
		exporting files ( )
		falling back to previous version ( )
		getting software status ( )
		halting managed hosts ( )
		importing archives ( )
		importing audit rules files ( )
		importing boot images ( )
		importing manifests ( )
		importing shared profiles ( )
		importing Solaris Flash archives ( )
		logging in ( )
		modifying file and folder properties ( )
		modifying host group properties ( )
		modifying managed host properties ( )
		moving files and folders ( )
		moving managed hosts and host groups ( )
		performing initial installation ( )
		purging completed jobs ( )
		rebooting managed hosts ( )
		reinstalling managed hosts ( )
		removing managed hosts and host groups ( )
		renaming file or folder ( )
		renaming managed host or host group ( )
		specifying administrative domain ( ) ( )
		starting interactive session ( )
		updating managed hosts ( )
		viewing file and folder properties ( )
		viewing folder contents ( )
		viewing host group contents ( )
		viewing host group properties ( )
		viewing job status ( )
		viewing managed host properties ( )

	comparison report, file format ( )

	copying files, browser interface procedure ( )

	copying managed hosts
		browser interface procedure ( )
		command-line procedure ( )

	creating audit rules files, browser interface ( )

	creating customizable Solaris Flash archive ( ) ( )

	creating folders
		browser interface procedure ( )
		command-line procedure ( )

	creating host groups
		browser interface procedure ( )
		command-line procedure ( )

	creating shared profiles, browser interface procedure ( )

	creating software stacks, on master system ( )

	creating Solaris Flash archive from master system ( )

	custom JumpStart ( )


D

	data
		backing up ( )
		configuring ( )
		initializing ( )
		restoring ( )
		uninstalling ( )

	database table files ( )

	default file properties ( ) ( )

	default managed host properties ( )

	deleting files and folders
		browser interface procedure ( )
		command-line procedure ( )

	deployment, definition of ( )

	deployment files
		folder ( )
		properties of ( ) ( )
		purpose of ( )
		shared profile ( )
		Solaris boot image ( )
		Solaris Flash archive ( )

	deployment finish scripts ( )

	deployment operations ( )

	deployment procedures
		accessing Set Up Files section
			browser interface procedure ( )
		accessing Set Up Hosts & Jobs section
			browser interface procedure ( )
		adding managed hosts
			browser interface procedure ( )
			command-line procedure ( )
		creating shared profiles
			browser interface procedure ( )
		falling back to previous version
			browser interface procedure ( )
			command-line procedure ( )
		halting managed hosts
			command-line procedure ( )
		importing archives
			browser interface procedure ( )
			command-line procedure ( )
		importing boot images
			browser interface procedure ( )
			command-line procedure ( )
		importing shared profiles
			browser interface procedure ( )
			command-line procedure ( )
		performing initial installation
			browser interface procedure ( )
			command-line procedure ( )
		rebooting managed hosts
			browser interface procedure ( )
			command-line procedure ( )
		reinstalling managed hosts
			browser interface procedure ( )
			command-line procedure ( )
		updating managed hosts
			browser interface procedure ( )
			command-line procedure ( )

	deployment technologies
		See Change Manager deployment technologies

	disk layout parameters ( )

	disk space
		See hardware and software requirements

	downloading Change Manager software from the Sun Download Center ( )

	drop-down menus, browser interface navigation ( )


E

	`/etc/ichange.d` ( )

	example, getting started ( )

	exporting files ( )
		browser interface procedure ( )
		command-line procedure ( )


F

	falling back to previous version
		browser interface procedure ( )
		command-line procedure ( )

	file attributes, role in auditing ( )

	file formats
		archive parameters file ( )
		audit rules file ( )
		comparison report ( )
		manifest ( )

	file name suffixes
		`.bmft` ( ) ( )
		`.brul` ( ) ( )
		`.cmsp` ( ) ( )
		`.flar` ( ) ( )
		`.miniroot` ( ) ( )
		`.txt` ( ) ( )

	file naming conventions ( )

	file properties
		default ( ) ( )

	files
		See audit files
		See audit rules file
		See deployment files
		See manifest file

	finish scripts
		`$SI_ROOT` ( )
		`cmgetprop` ( )
		environment variables ( )
		example ( )
		location of ( )
		using to process `ic_cfgparams` ( )
		using two or more ( )

	`.flar`, Solaris Flash archive suffix ( ) ( )

	flar(1MCM) ( ) ( )

	flash_archive(4CM) ( )

	folder, description of ( )

	folder contents ( ) ( )


G

	generating security keys, password ( )

	getting glossary definitions online, procedure ( )

	getting online help, procedure ( )

	getting software status
		browser interface procedure ( )
		command-line procedure ( )

	getting started example ( )

	glossary, online ( )


H

	halting managed hosts, command-line procedure ( )

	hardware and software integration, definition of ( )

	hardware and software requirements
		Change Manager server ( )
		master system ( )

	hardware differences, addressing ( )

	Help
		online ( ) ( )

	host groups, definition of ( )

	host properties
		definition of ( ) ( )
		for customizing software stack installations ( )
		parameters ( ) ( )


I

	`ic_cfgparams` ( )

	ichange.cfg(4CM) ( ) ( )

	`IGNORE` statement, audit rules file ( )

	importing archives
		browser interface procedure ( )
		command-line procedure ( )

	importing audit rules files
		browser interface procedure ( )
		command-line procedure ( )

	importing boot images
		browser interface procedure ( )
		command-line procedure ( )

	importing manifests
		browser interface procedure ( )
		command-line procedure ( )

	importing shared profiles
		browser interface procedure ( )
		command-line procedure ( )

	importing Solaris Flash archives
		browser interface procedure ( )
		command-line procedure ( )

	initializing data ( )

	installation, types of ( )

	installing agents, task map ( )

	installing agents on master system, procedure ( )

	installing Change Manager server
		See server installation procedures

	installing Solaris Flash archives
		browser interface task map ( )
		command-line interface task map ( )
		using the browser interface ( )
		using the command-line interface ( )

	interactive session, starting, command-line procedure ( )

	interruptable jobs ( ) ( )


J

	job, definition of ( )

	job ID, definition of ( )

	job log ( ) ( )

	job monitoring procedures
		See also monitoring jobs
		accessing Monitor Jobs section
			browser interface procedure ( )
		accessing View Logs section
			browser interface procedure ( )
		canceling jobs
			browser interface procedure ( )
			command-line procedure ( )
		purging completed jobs
			browser interface procedure ( )
			command-line procedure ( )
		rescheduling running jobs
			browser interface procedure ( )
		viewing job log
			browser interface procedure ( )
		viewing job queue
			browser interface procedure ( )
		viewing job status
			command-line procedure ( )
		viewing transaction log
			browser interface procedure ( )

	job queue ( ) ( )

	job status ( )

	job status values ( )


L

	live update ( )
		browser interface procedure ( )
		using fallback feature ( )
		using Solaris Live Upgrade ( )

	log
		job ( ) ( )
		transaction ( ) ( )

	Log Out ( )

	logging in to user interface
		browser interface procedure ( )
		command-line procedure ( )


M

	maintaining the repository
		See also repository maintenance procedures
		browser interface task map ( )
		command-line interface task map ( )
		using the browser interface ( )
		using the command-line interface ( )

	maintaining the topology
		See also topology maintenance procedures
		browser interface task map ( )
		command-line interface task map ( )
		using the browser interface ( )
		using the command-line interface ( )

	managed host communication, installing and configuring agents ( )

	managed hosts
		default properties ( )
		definition of ( ) ( ) ( )
		hardware and software requirements ( )
		parameters ( )
		purpose of ( )

	manifest file
		`.bmft` ( )
		description of ( ) ( )
		entries ( )
		example ( )
		format ( )
		quoting syntax ( )

	master system
		boot environment configuration ( )
		choosing ( )
		definition of ( ) ( )
		hardware and software requirements ( )
		providing runtime data ( )
		purpose of ( )
		restrictions ( )
		supported architecture ( )
		unconfiguring applications ( )

	memory
		See hardware and software requirements

	menus ( )

	`.miniroot`, Solaris boot image suffix ( ) ( )

	modifying file and folder properties, command-line procedure ( )

	modifying host group properties, command-line procedure ( )

	modifying managed host properties
		browser interface procedure ( )
		command-line procedure ( )

	Monitor Jobs section, accessing ( )

	Monitor Jobs tab ( )

	monitoring jobs ( )
		See also job monitoring procedures
		browser interface task map ( )
		command-line interface task map ( )
		using the browser interface ( )
		using the command-line interface ( )
		using the job log ( )
		using the job queue ( )
		using the transaction log ( )

	moving files and folders
		browser interface procedure ( )
		command-line procedure ( )

	moving managed hosts and host groups
		browser interface procedure ( )
		command-line procedure ( )


N

	navigating browser interface
		See browser interface navigation

	navigating folders and host groups, browser interface navigation ( )

	navigating wizards, browser interface navigation ( )


P

	parameters
		archive ( ) ( )
		for disk layout ( )
		for host properties ( )
		for shared profiles ( ) ( )
		for system configuration ( )
		managed host properties ( )
		minimum set for software deployment ( )

	password, used to generating security keys ( )

	performing initial installation
		browser interface procedure ( )
		command-line procedure ( )

	port, agent ( )

	procedures
		See browser interface procedures
		See command-line procedures

	purging completed jobs
		browser interface procedure ( )
		command-line procedure ( )


Q

	queue
		job ( ) ( )


R

	rebooting managed hosts
		browser interface procedure ( )
		command-line procedure ( )

	reinitializing Change Manager database setup ( ) ( )

	reinstalling managed hosts
		browser interface procedure ( )
		command-line procedure ( )

	reinstalling software ( )

	removing managed hosts and host groups
		browser interface procedure ( )
		command-line procedure ( )

	renaming file or folder
		browser interface procedure ( )
		command-line procedure ( )

	renaming managed host or host group
		browser interface procedure ( )
		command-line procedure ( )

	report file ( )

	repository maintenance procedures
		See also maintaining the repository
		accessing Set Up Files section
			browser interface procedure ( )
		copying files
			browser interface procedure ( )
		creating folders
			browser interface procedure ( )
			command-line procedure ( )
		deleting files and folders
			browser interface procedure ( )
			command-line procedure ( )
		exporting files
			browser interface procedure ( )
			command-line procedure ( )
		modifying file and folder properties
			command-line procedure ( )
		moving files and folders
			browser interface procedure ( )
			command-line procedure ( )
		renaming file or folder
			browser interface procedure ( )
			command-line procedure ( )
		viewing and modifying file properties
			browser interface procedure ( )
		viewing file and folder properties
			command-line procedure ( )
		viewing folder contents
			browser interface procedure ( )
			command-line procedure ( )

	rescheduling running jobs, browser interface procedure ( )

	restoring data ( )


S

	scripts
		See finish scripts

	security ( )
		browser to user interface ( )
		Change Manager data storage ( )
		initial installations using `bootparams` ( )
		initial installations using RARP ( )
		initial installations using TFTP ( )
		NFS access by managed hosts ( )
		secure communication channels ( )
		secure file transfer channels ( )
		secure file transfers ( )
		Sun Management Center probe connection ( )
		Sun Management Center SNMP control ( )
		terminal access ( )
		user interfaces to Change Manager ( )
		users as security risks ( )

	server
		See Change Manager server

	server installation procedures ( )
		downloading Change Manager software from the Sun Download Center ( )
		high-level task map ( )
		installing Change Manager server software ( )
		issues ( )
		regenerating security keys ( )
		reinitializing Change Manager database setup ( ) ( )
		uninstalling Change Manager server software ( ) ( )
		upgrading Change Manager server software ( )

	Set Up Files section
		accessing ( ) ( )

	Set Up Files tab ( )

	Set Up Hosts & Jobs section
		accessing ( ) ( )

	Set Up Hosts & Jobs tab ( )

	shared profile parameters
		for disk layout ( )
		for system configuration ( )

	shared profiles
		`.cmsp` ( )
		definition of ( ) ( )
		description of ( )
		for customizing software stack installations ( )
		relationship with host properties ( )

	software, downloading ( )

	software deployment
		See also Change Manager deployment technologies
		See also deployment files
		See also deployment procedures
		definition of ( )
		finish scripts ( )
		issues ( )
		operations ( )
		using software stacks ( )

	software requirements
		Change Manager server ( )
		master system ( )

	software stack, on master system ( )

	software stacks
		as Solaris Flash archives ( ) ( )
		creating on master system ( )
		creating Solaris Flash archive ( )
		creating to support all hardware ( )
		definition of ( )
		providing runtime data ( )
		unconfiguring applications ( )
		using deployment finish scripts ( )

	Solaris boot image ( ) ( ) ( )

	Solaris Flash archive
		creating customizable ( ) ( )
		creating from master system ( )
		definition of ( )
		description of ( )
		`.flar` ( )

	Solaris Flash installation ( )

	Solaris Flash technology, limitations for applications ( )

	Solaris Live Upgrade
		proper use of with Change Manager ( )
		role of boot environments ( )
		using to create boot environments ( )

	specifying administrative domain
		browser interface procedure ( )
		command-line procedure ( )

	starting interactive session, command-line procedure ( )

	status
		job ( )
		values for job ( )

	subtree specifications, audit rules file ( )

	suffixes
		See file name suffixes

	Sun Management Center agents ( )

	Sun Management Center topology ( ) ( )
		See also maintaining the topology
		See also topology maintenance procedures
		organizing managed hosts and host groups ( )

	`SUNWCXall`, installing on master system ( )

	sysid parameters ( )

	system types
		Change Manager server ( )
		managed host ( )
		master system ( )


T

	topology maintenance procedures
		See also maintaining the topology
		copying managed hosts
			browser interface procedure ( )
			command-line procedure ( )
		creating host groups
			browser interface procedure ( )
			command-line procedure ( )
		modifying host group properties
			command-line procedure ( )
		modifying managed host properties
			browser interface procedure ( )
			command-line procedure ( )
		moving managed hosts and host groups
			browser interface procedure ( )
			command-line procedure ( )
		removing managed hosts and host groups
			browser interface procedure ( )
			command-line procedure ( )
		renaming managed host or host group
			browser interface procedure ( )
			command-line procedure ( )
		specifying administrative domain
			browser interface procedure ( )
			command-line procedure ( )
		viewing host group contents
			browser interface procedure ( )
			command-line procedure ( )
		viewing host group properties
			command-line procedure ( )
		viewing managed host contents
			command-line procedure ( )

	topology object types ( )

	topology properties, default ( )

	transaction log ( ) ( )

	troubleshooting
		browser interface issues ( )
		Change Manager server installation issues ( )
		Change Manager user interface issues ( )
		command-line interface issues ( )
		general user interface issues ( )
		software deployment issues ( )

	`.txt`, report file suffix ( ) ( )


U

	unconfiguring applications ( )

	uninstalling Change Manager server software ( ) ( ) ( )

	update
		See live update

	updating managed hosts
		browser interface procedure ( )
		command-line procedure ( )
		using fallback feature ( )
		using Solaris Live Upgrade ( )

	upgrading Change Manager server software ( )

	user authorization, procedure ( )

	user interface issues
		Change Manager ( )
		general ( )

	users, Change Manager ( )


V

	View Logs section, accessing ( )

	View Logs tab ( )

	viewing and modifying file properties ( )
		browser interface procedure ( )

	viewing file and folder properties, command-line procedure ( )

	viewing folder contents
		See also maintaining the repository
		browser interface procedure ( )
		command-line procedure ( )

	viewing host group contents
		browser interface procedure ( )
		command-line procedure ( )

	viewing host group properties, command-line procedure ( )

	viewing job log, browser interface procedure ( )

	viewing job queue, browser interface procedure ( )

	viewing job status, command-line procedure ( )

	viewing managed host properties, command-line procedure ( )

	viewing transaction log, browser interface procedure ( )


W

	wizards, navigating ( )