This appendix lists problems, warning messages, and error messages that you might see when using Change Manager.
The information for each problem can include three sections:
Description - The description section describes the problem. If necessary, warning messages and error messages are included.
Cause - The cause section, when applicable, describes the reason the problem occurred.
Solution - The solution section describes the steps you must take to correct the problem.
Troubleshooting information is provided for the following problem areas:
For problems that have been discovered since the publication of this book, see the Sun Management Center Change Manager 1.0 Release Notes.
The following troubleshooting issues relate to the installation of Sun Management Center 3.0 and Change Manager 1.0 on the designated Change Manager server.
/usr/sbin/patchadd[177]: PatchArrElem: subscript out of range
This message appears when you run the patchadd -p command on the Solaris 8 2/02 operating environment.
Solution:You can ignore this message.
To avoid seeing this message, add patch 108987-09 to your Solaris 8 2/02 system.
Become superuser.
Download the patch to your system from the SunSolve Patch Portal.
Use the unzip command to expand the patch from the ZIP archive.
# unzip 108987-09.zip |
Change to the patch directory.
# cd 108987-09 |
Install the patch.
# patchadd `pwd`/108987-09 |
This section describes problems using the browser interface and the command-line interface. Problems seen when using both user interfaces are described first.
You attempt to add a new host, and the following message appears:
Managed Host Not Added SNMP request returned error status 6 (no access) snmp://129.153.72.86:164/mod/topology+view-#/entityAdder#0 |
Other similar types of requests might yield a similar error.
Ensure that you are an authorized Sun Management Center domain administrator by ensuring that you are a member of both the esadm and esdomadm groups.
Internal error: unable to establish probe connection
This message appears when you run jobs on a managed host that is a client of more than one Change Manager server.
Solution:Ensure that the managed host is a client of only one Change Manager server.
To change control of a managed host to another Change Manager server, perform the following steps:
Remove the managed host from the current server.
Add the managed host to the new Change Manager server.
Create a shared profile for the managed host.
Run Set Up for Install or changemgr setup for the managed host.
When you import a Solaris boot image, you might see the following error message:
Aug 29 10:03:27 IC_1 - - Failed [Execution failed [import failed: ]] |
This error might indicate that the disk is full.
Check to see if the file system that contains the Change Manager repository is full.
If you import a shared profile in to the repository and the operation fails, you might see the following error message:
Execution failed [import failed: record not found: /archive_name.flar] /templ_name.cmsp: import failed. |
Change Manager validates the archive specified in the shared profile. If the archive is invalid (it does not exist), then the import fails.
Make sure that the Solaris Flash archive exists in the repository before importing the shared profile.
When you perform an import operation, you might see the following error message:
File copy did not run |
This error message might indicate that /tmp is full.
Free space in /tmp to make room for the file you want to import.
The following troubleshooting issues relate to the browser interface.
You provide the correct Change Manager URL, but you are unable to reach the login page. Following is the correct form of the URL:
https://server_name.domain:6789/changemgr |
Try restarting the web server by typing:
# /usr/sadm/bin/smcwebserver restart |
You type a valid Change Manager user name and password on the Change Manager login page, but the login attempt fails.
Try restarting the Sun Management Center server by typing:
# /opt/SUNWsymon/sbin/es-restart -A |
You provide a valid Solaris user name and password, but are unable to start the Change Manager application.
Ensure that you are an authorized Sun Management Center user by inspecting the file /var/opt/SUNWsymon/cfg/esusers.
To access all areas of Change Manager, you need to be an authorized Sun Management Center domain administrator. Ensure that you are a member of both the esadm and esdomadm groups.
You provide the correct Change Manager URL, but the following error message appears in a dialog box:
document contained no data. |
Verify that the URL is correct.
The following example shows the correct form of the Change Manager URL:
https://server_name.domain:6789/changemgr |
Ensure that the URL begins with https, not http.
If the URL is correct, try restarting the web server by typing:
# /usr/sadm/bin/smcwebserver restart |
The server's certificate has an invalid signature. You will not be able to connect to this site securely.
Restart the Netscape Communicator, then access the page again.
When a large number of host groups, namely, 200, are manipulated, the browser interface might behave unpredictably. This situation occurs when creating large numbers of host groups or renaming a host group that contains a large number of host groups.
Avoid creating a topology hierarchy with large numbers of host groups.
If the browser interface becomes unusable, restart the Sun Management Center server and the web server by running:
# /opt/SUNWsymon/sbin/es-restart -S # /usr/sadm/bin/smcwebserver restart |
If restarting the Sun Management Center server and web server fails, you might want to reinitialize the Sun Management Center database.
Reinitializing the database removes all the topology and Change Manager data from the Change Manager server. So, use this only as a last resort.
Remove the data and recreate the Sun Management Center database.
# /opt/SUNWsymon/sbin/es-setup -F |
Recreate the Change Manager database.
# /opt/SUNWsymon/sbin/es-setup -p ichange |
The browser interface cannot display the contents of directories that are not publically readable. This problem prevents the file browser from accessing private directories even though the user has appropriate permissions.
Directly specify files in such a directory by supplying a full path name to the file.
The following troubleshooting issues relate to the command-line interface.
You cannot use the command-line interface to create a shared profile.
To create a shared profile, do one of the following:
Create a shared profile by using the browser interface, see How to Create a Shared Profile (Web Browser).
Import an existing shared profile to the repository:
Create a shared profile outside of the repository. The shared profile is a text file that contains the parameters and parameter values described in Parameters Used by Shared Profiles and Host Properties.
Import the shared profile to the repository. See How to Import Shared Profiles to the Change Manager Repository (Command Line).
After the shared profile is in the repository, you can modify property values by using the changemgr fileset command. See How to Modify File or Folder Properties (Command Line).
The following troubleshooting issues relate to the deployment of software to managed hosts.
If the installation program detects an invalid parameter or parameter value in a shared profile or in host properties, the hands-off installation terminates. Then, the interactive installation program launches so you can correct the problem or otherwise continue with the installation.
This scenario occurs if you provide an invalid parameter value. For information about custom JumpStart keywords, see "Preconfiguring System Configuration Information (Tasks)" in Solaris 9 Installation Guide.
The custom JumpStart keywords correspond to the Change Manager parameters, but the names are different. The Change Manager parameters begin with the base_config_ string, but the content part of the string matches closely to the custom JumpStart keyword names. To see a description of the Change Manager parameters, see Chapter 10, Creating Shared Profiles and Host Properties (Reference).
The installation program detects the parameter problem, but cannot correct it. The custom JumpStart installation cannot continue, so it launches the interactive installation program.
To correct the problem, review the parameters and parameter values for the managed host that failed to perform the custom JumpStart installation.
Ensure that the parameters and parameter values are correct. See Chapter 10, Creating Shared Profiles and Host Properties (Reference) for a description of the parameters specified in shared profiles and by host properties.
Be careful when copying the encrypted root password from /etc/shadow to the shared profile. Do not include the colon (:) field delimiters as part of the base_config_sysidcfg_rootpw property value.
If you find the problem and correct it, restart the initial installation.
If you do not find the problem, review the parameters and parameter values in the shared profile or in the host properties.
If you are installing only one managed host, you might continue with the interactive installation. This solution is not advisable unless you are installing just one managed host with a simple software stack.
While loading the bootstrap, the managed host hangs. You can tell when the bootstrap is being loaded because of the hex count to 24000.
This problem might occur more often when the network is heavily loaded.
An in.tftpd bug causes this intermittent failure. As a result of this bug, the transfer hangs.
Reset the hanged managed host. Try the network boot again.
The network boot of your managed host might fail with an error message such as:
Panic: unable to mount file systems |
If such a message appears, then your managed host is probably being served by more than one network boot server.
You must first identify all network boot servers on which your managed host is registered, other than the Change Manager server.
Use the hostconfig(1M) command to identify the network boot servers on which your managed host is a client.
Perform the following steps to determine whether your managed host is a client of more than one network boot server:
Remove your managed host from the Change Manager server from which you want to boot.
Use the browser interface or the command-line interface to remove your managed host from the Change Manager topology.
Log in to the boot server as superuser.
Change to the Tools directory of the Solaris boot image associated with the Solaris version you want to install.
Run the rm_install_client command to remove the entries for your managed host from the /etc/bootparams file.
# ./rm_install_server hostname |
Run the hostconfig command to determine whether your managed host is a client of another network boot server.
$ hostconfig -p bootparams -f hostname -n -v |
See if the hostconfig command identifies a network boot server for your managed host.
If an IP address appears in square brackets on the first line of output, your managed host is a client of another boot server. The IP address represents the boot server.
From [192.153.72.132]: hostname = host1 ypdomain = yourCompany.COM router = 192.153.72.1 |
If no IP address appears, then your managed host is not a client of a boot server. Go to Step 7.
Determine the name of the boot server specified by the IP address.
If you use the NIS naming service, for example, use ypmatch(1) to associate the IP address with the host name of the boot server.
$ ypmatch 192.153.72.132 hosts.byaddr 129.153.72.132 cmserver |
Repeat Step 1b to Step 4 to remove your managed host entries from the /etc/bootparams file on the boot server.
Repeat Steps 2-4 to find additional boot servers.
When no more boot servers are indicated by the hostconfig command, add your managed host to the Change Manager topology of the Change Manager server. Set up the files for installation. Then, restart the boot net - install from your managed host's console.
When the last reference to a managed host is removed from the Change Manager topology, the custom JumpStart data is not deleted.
The /etc/bootparams file still contains entries corresponding to the managed hosts.
The /var/opt/ichange/jsdata/hostname directories still contain boot environment information and custom JumpStart configuration files.
Extraneous /etc/bootparams entries for a managed host can cause problems. For example, if more than one Change Manager server has the same managed host registered, each server answers the call from that managed host. This situation produces excess traffic and unknown results on the managed host.
Manually clean up the following files on the Change Manager server:
Find a Solaris miniroot, which might be located in the Change Manager repository under /var/opt/ichange/root. Change directory to the Tools subdirectory, for example, /var/opt/ichange/root/s9.miniroot/Solaris_9/Tools. Then, as superuser, type:
# ./rm_install_client hostname |
Delete the host-specific directories from the /var/opt/ichange/jsdata directory.