IT360 - Troubleshooting

This section aims to reproduce some of the real life / production environment challenges which IT360 support team encountered in the past with its customers and the resolution offered.

Troubleshooting Tips and Program Messages

General:

  1. Server is Initializing....

  2. Probe Status Differentiation (For Enterprise and MSP Editions)

  3. CPU Usage Data collection is not happening for Servers in WMI mode

  4. Unable to find the added Network device, inspite of getting a 'Success' message, while device addition

  5. Mail Fetching Problem

    1. Problem when processing from Mail Server

      1. Password length is greater than the expected value

      2. Unable to fetch mail, as Plain text Authentication is disabled in the mail server

      3. Encountering error and unable to fetch email, when encrypted mode is enabled on POP, in the mail server
  1. Unable to access the IT360 web client

  2. Unable to fetch Managed Object (Networks module)

  3. Where do I find the log files to be sent to the technical support team for analysis?

ServiceDesk:

Click HERE to view the Troubleshooting tips for IT360 ServiceDesk.


1. Message/Error: "Server is Initializing...."

Possible Cause: If the message 'Server is Initializing...' is displayed for a longer duration, the IT360 Server is experiencing some problem.

Recommended Action:   

  1. Ensure if your machine, in which ManageEngine IT360 is installed meets the Recommended / Minimum System requirements.

  2. Ensure that all the ManageEngine IT360 Services are running. Navigate to 'Administrative Tools -> Services' in Windows Control Panel to perform the check. If not, then try restarting the service(s) once again.

  3. If you were still unable to successfully restart the ManageEngine IT360, follow the steps below to create 'Support Information File';

    1. Open '[IT360 Home]\bin directory' in either command prompt or through Windows explorer.

    2. Execute the file named 'CreateSupportFile.bat'.

    3. Change the directory to '[IT360 Home]'. You will find a folder named '[IT360 Home]\support'.

    4. Email the contents of the folder to it360-eval@manageengine.com, in order to analyze the problem.

[TOP]


2. Topic: Probe Status Differentiation (For Enterprise and MSP Editions)

Related Queries & Explanations:

i. In Central`s 'Admin --> Probe', I could see that the Probe status and the status of all modules are indicated by Green color. What does this mean?

If the Probe status and the status of all modules are indicated by Green color, i.e. in up state (as shown in the screenshot below), then it means that the Probe registration with the Central server is complete, and there exists a proper communication and sync up between the Central and the Probe.

[TOP]

ii. In Central`s 'Admin --> Probe', I could see that only the 'Probe Name' is displayed, the status of the probe is indicated by Red color, and the 'Synching' status is shown as 'In progress'. What does this mean?

If the above said indications are seen (as shown in the screenshot below), then it means that the Probe registration with the Central server is complete, but there exists some issue, such as the Probe Start-up issue or Sync up issue.

[TOP]

iii. In Central`s 'Admin --> Probe', I could see that the screen is empty and no Probe details are displayed. What does this mean?

If no Probe details are displayed, when you go to Central`s 'Admin --> Probe' (as shown in the screenshot below), then it means that the probe registration with the Central server itself has failed.

[TOP]

iv. In Central`s 'Admin --> Probe', I could see that the Probe status and the status of all modules are indicated by Red color. What does this mean?

If the Probe status and the status of all modules are indicated by Red color, i.e. in down state (as shown in the screenshot below), the probe registration with the Central server is complete, there exists a proper communication and sync up between the Central and the Probe, but the Probe is down.

[TOP]


3. Symptom: Unable to receive/send Emails from/to Servicedesk

Possible Cause: The email settings might have failed, due to Authentication issue.

Recommended Action:

  1. Reset the password for the Servicedesk credentials (servicedesk).

  2. Update the above change in Servicedesk email settings.

[TOP]


4. Symptom: Unable to see the discovered devices under CMDB tab of Service Desk

Possible Cause: This could be due to any License Violation. Please check the License page to confirm this.

Recommended Action: If so, procure the license with the desired asset count. For more information, contact <it360-support@manageengine.com>.

[TOP]


5. Symptom: CPU Usage Data collection is not happening for Servers in WMI mode

Possible Cause: Admin privilege might not be available for WMI, or Process monitoring might not be working.

Recommended Action: Please execute the below troubleshooting steps to find out whether the CPU is responding via WMI;

[TOP]


6. Symptom: Unable to find the added Network device, inspite of getting a 'Success' message, while device addition

Possible Cause: The reason could be due to the presence of any other category of network device, with the same IP address. In this case, you will end up with the scenario, mentioned above.

Recommended Action: Remove the conflicting device and re-add the new device.

[TOP]


7. Topic: Mail Fetching Problem

  1. Symptom: Problem when processing from Mail Server

  1. Error/Symptom: 1 "Password length is greater than the expected value"

Error trace in logs:

'Error when processing. SO RETURNING...|com.adventnet.authentication.PasswordException: Length of the new password is greater than expected value of : 100
For any Mail fetching issue, check for the string "SO RETURNING"'
.. Few lines above or below the line, which contains this string, should give more information on the error trace.

Possible Cause::

When a mail comes in, ServiceDesk Plus will try to create a new user with the user name and password, same as the email address. In this case, since the email address is very long, it cannot be added to the database and throws the error message; 'Length of the new password is greater than expected value of :100'

  1. Error/Symptom: 2 "Unable to fetch mail, as Plain text Authentication is disabled in the mail server"

Error trace in logs:

javax.mail.MessagingException: No login methods supported!;

nested exception is:

com.sun.mail.iap.ProtocolException: No login methods supported!|

Recommended Action:

Enable plain text login in Microsoft Exchange server and follow the step given below, to configure the IMAP service, in order to use the Plain Text Login;

  1. Open Exchange Management Shell from 'Start -> Programs -> Microsoft Exchange 2007'.

  2. Enter the following in the shell: 'set-POPsettings – logintype plaintextlogin'

  3. Hit 'Enter'.

  4. From the Services panel, restart the Microsoft Exchange Information Store service.

Information required for analysis: Support Tab --> Support Files

  1. Error/Symptom: 3 "Encountering error and unable to fetch email, when encrypted mode is enabled on POP, in the mail server"

Error trace in logs: javax.mail.AuthenticationFailedException: Command is not valid in this state.

Recommended Action:

Reset the password format on the exchange server, to the Normal format. This can be done by running a query on the exchange server shell. Then, follow the steps below to configure the IMAP service to use Plain Text Login:

  1. Open Exchange Management Shell from 'Start -> Programs -> Microsoft Exchange 2007'.

  2. Enter the following in the shell: 'set-POPsettings – logintype plaintextlogin'

  3. Hit 'Enter'.

  4. From the Services panel, restart the Microsoft Exchange Information Store service.

Information required for analysis: 'Support Tab --> Support File'

[TOP]


8. Unable to access the IT360 web client

Possibility 1:

Symptom: When I reboot IT360 [server], I can see that the IT360 related services are running in the services window. However, I am unable to access the IT360 web client.

Analysis: On analysing the wrapper.log file, a server shutdown was noticed. Subsequently, when IT360 services were started, the Applications Service module did not start. Also, on analysing the StartUpLogs_err*.txt file, a MS SQL DB Connection was refused to the Applications Service module.

Also, MS SQL is installed in the same machine where IT360 [Central Server or Probe, as applicable] is installed.

Possible Cause: Application Service may have started much earlier than the MS SQL DB and hence did not find a DB Connection.

Recommended Solution: A delayed start of IT360 solves the problem. This is achieved as follows:

Go to services.msc, select 'ManageEngine IT360 Central' service [or, 'ManageEngine IT360 Probe' service, as applicable], right click and select Properties. Change the 'Startup type' to 'Automatic (delayed start)'. Click OK.

This ensures that the IT360 services are started later than the MS SQL service. You may restart IT360 now. You should be able to access the IT360 web client.

[TOP]


9. Message/Error: "Unable to fetch Managed Object for......"

Possible Cause: If the message 'Unable to fetch Managed Object for......' is displayed while clicking a device under the Networks tab, it means that the database has crashed.

Recommended Action:

When this error occurs, follow the below steps to resolve the problem:

  1. Login to IT360 console as an Administrator.

  2. Navigate to "Admin -> General -> User Management".

  3. Edit any detail of the concerned user (who encountered the problem).

  4. Click Update.

  5. Log out and re-login using the same credentials.

  6. Now, navigate to the snapshot page and check the device details.

[TOP]

10. Where do I find the log files to be sent to the technical support team for analysis?

  1. Fetch the log files from the ManageEngine/IT360/logs directory.

  2. If the logs folder is less than 100 MB, ZIP it and upload to the ManageEngine Upload site: (http://bonitas.zohocorp.com/upload/index.jsp?to=it360-support@manageengine.com).
    Do mention your Request ID (if you have one) in the Reason box and your email address in the Email ID box, before uploading the file.

  3. If the logs folder is 100 MB or larger, then ZIP it and upload to the site: http://bonitas2.zohocorp.com.

  4. Once you have uploaded the file, contact it360-support@manageengine.com, along with the Request ID .



Copyright © 2014, ZOHO Corp. All Rights Reserved.