UNIX Troubleshooting

Theme: Troubleshoot
Who Is It For? System Administrator

What is it?

Reference for common UNIX system error symbols returned by the Unix Agent, including probable causes and corrective actions for each error condition.

• You need a quick-reference index to locate a specific error symbol by category before reading its full entry.

UNIX error messages

The following table provides help in finding solutions to errors most commonly reported by UNIX system routines. The error messages displayed in the Enterprise Manager, agent log file, and/or agent error file appear as follows:

agent-generated text (ID / errno [SYMBOL] - description)

The numbers ID and errno are not discussed here, but may be requested by SMA Technologies Support. SYMBOL and description are listed in the first column under "Error".

System-generated SYMBOL and description are not specific to any particular system routine, so the "Possible Cause/Fix" needs to be considered in the context in which the UNIX error appears. In most cases involving a resource (e.g., file, directory, socket, etc.), the particular resource is noted in the agent-generated-text portion of the message.

Each error entry below follows the format ID / errno [SYMBOL] - description. The errno number and SYMBOL are the key identifiers to match against your log file. Because errors are context-dependent, review the agent-generated text surrounding the error for the specific resource involved. Check the agent log file for the exact error string before consulting this page.

Note

The description may be presented in a language other than English.

Quick-reference index

Symbol	Category	Description
EAGAIN	Resource errors	Resource temporarily unavailable
EACCES	Permission and access errors	Permission denied
EADDRINUSE	Network and communication errors	Address already in use
EBUSY	File and I/O errors	Device busy
ECONNREFUSED	Network and communication errors	Connection refused
ECONNRESET	Network and communication errors	Connection reset by peer
EEXIST	File and I/O errors	File exists
EFBIG	File and I/O errors	File too large
EHOSTDOWN	Network and communication errors	Host is down
EHOSTUNREACH	Network and communication errors	No route to host
EMFILE	Resource errors	Too many open files
ENAMETOOLONG	File and I/O errors	File name too long
ENETDOWN	Network and communication errors	Network is down
ENETUNREACH	Network and communication errors	Network is unreachable
ENFILE	Resource errors	File table overflow
ENOENT	File and I/O errors	No such file or directory
ENOMEM	Resource errors	Not enough space
ENOSPC	Resource errors	No space left on device
EPERM	Permission and access errors	Not owner
EROFS	Permission and access errors	Read-only file system
ETIMEDOUT	Network and communication errors	Connection timed out
E2BIG	File and I/O errors	Arg list too long

Network and communication errors

EADDRINUSE - Address already in use

• CAUSE: The indicated network resource is already in use.
• FIX: Either determine which process uses one of the agent sockets (e.g., 3100 – 3105) and resolve the conflict, or reinstall the agent with a different <SAM_Socket> (e.g., 5100 instead of the default 3100).
• FIX: Ensure the agent is at or near the end of the system boot-up sequence.

ECONNREFUSED - Connection refused

• CAUSE: No process exists on the remote machine to accept a connection from this machine.
• FIX: Check the Job Details (in the Enterprise Manager) for errors and/or consult the remote machine's System Administrator to determine the cause.

ECONNRESET - Connection reset by peer

• CAUSE: The process on a remote machine is no longer connected. The process probably terminated abnormally.
• FIX: If the error persists, consult the remote machine's System Administrator to determine the cause.

EHOSTDOWN - Host is down

• CAUSE: The agent can't access the network.
• FIX: Consult the remote machine's System Administrator to determine the cause.

EHOSTUNREACH - No route to host

• CAUSE: Part of the network is either down or mis-configured.
• FIX: Consult the System Administrator to determine the cause.

ENETDOWN - Network is down

• CAUSE: The agent can't access the network.
• FIX: Consult the System Administrator to determine the cause.

ENETUNREACH - Network is unreachable

• CAUSE: The agent can't access the network.
• FIX: Consult the System Administrator to determine the cause.

ETIMEDOUT - Connection timed out

• CAUSE: The process on a remote machine is not sending data as expected. Unless the network is experiencing heavy traffic, the process probably terminated abnormally.
• FIX: If the error persists, consult the remote machine's System Administrator to determine the cause.

Permission and access errors

EACCES - Permission denied

• CAUSE: You are not authorized for the access requested for the indicated resource.
• FIX: Check the Job Details (in the Enterprise Manager) for errors and/or consult the System Administrator to determine if access can be granted.

EPERM

• Not owner

• CAUSE: You are not listed as the "owner" of the indicated resource and you cannot be given the access requested.
• FIX: Check the Job Details (in the Enterprise Manager) for errors and/or consult the System Administrator to determine if access can be granted.

EROFS - Read-only file system

• CAUSE: An attempt was made to create new data or to modify existing data on a file system marked as "read-only".
• FIX: Check the Job Details (in the Enterprise Manager) for errors and/or consult the System Administrator to determine if write access may be granted.

File and I/O errors

E2BIG - Arg list too long

• CAUSE: The combined "Start Image" and "Parameters" of the Job.
• FIX: The Job Details field (in the Enterprise Manager) is too long, or there are too many individual items in the combination.

EBUSY - Device busy

CAUSE: The agent cannot access a hardware device. FIX: Re-run the job at a later time. If the error persists, consult the System Administrator to determine the cause.

EEXIST - File exists

• CAUSE: An attempt was made to create a file which already exists on the system.
• FIX: Check the Job Details (in the Enterprise Manager) for errors and/or delete the file.

EFBIG - File too large

• CAUSE: An attempt was made to create a file larger than allowed.
• FIX: Consult the System Administrator to determine if the allowed maximum size of files can be increased.

ENAMETOOLONG - File name too long

• CAUSE: The file name (or a directory name embedded within the pathname) is longer than allowed by the system.
• FIX: Check the Job Details (in the Enterprise Manager) for errors and/or consult the System Administrator to determine if the allowed maximum size of file names can be increased.

ENOENT - No such file or directory

• CAUSE: The indicated file or directory does not exist on the system.
• FIX: Check the Job Details (in the Enterprise Manager) for errors.

Resource errors

EAGAIN - Resource temporarily unavailable

• CAUSE: The agent cannot access a resource.
• FIX: Re-run the job at a later time. If the error persists, consult the System Administrator to determine the cause.

EMFILE - Too many open files

• CAUSE: An attempt was made to open more files than allowed.
• FIX: Consult the System Administrator to determine if the allowed number of open files can be increased.

ENFILE - File table overflow

• CAUSE: The file system appears to be full.
• FIX: Consult the System Administrator to determine the cause.

ENOMEM - Not enough space

• CAUSE: The system is low on memory.
• FIX: Re-run the job at a later time. If the error persists, consult the System Administrator to determine the cause.

ENOSPC - No space left on device

• CAUSE: The device (normally a hard disk) is full.
• FIX: Either remove files or find another device with sufficient space. Re-run the job.