33
1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub. We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback. ___________________________ ___________________ Abstract This guide helps you troubleshoot issues with the OneFS web administration interface for your Isilon cluster. March 19, 2019 EMC ISILON CUSTOMER TROUBLESHOOTING GUIDE TROUBLESHOOT ISSUES WITH THE ONEFS WEB ADMINISTRATION INTERFACE OneFS 7.2 - 8.X

EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

  • Upload
    others

  • View
    103

  • Download
    1

Embed Size (px)

Citation preview

Page 1: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Abstract This guide helps you troubleshoot issues with the OneFS web administration interface for your Isilon cluster.

March 19, 2019

EMC ISILON CUSTOMER TROUBLESHOOTING GUIDE

TROUBLESHOOT ISSUES WITH THE ONEFS WEB ADMINISTRATION INTERFACE

OneFS 7.2 - 8.X

Page 2: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

2 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Contents and overview

Page 3 Before you begin

Appendix A If you need further assistance

Page 4 Start troubleshooting

Page 5 Routing

Page 6 Cannot access the login page

Page 13 "Permission denied" errors

Note Follow all of these steps, in order, until you reach a resolution.

1. Follow these steps.

2. Perform troubleshooting steps in order.

3. Appendixes

Appendix B How to use this flowchart

Page 14 Apache directory ownership

Page 15 Cannot log in with the admin account

Page 22 Not all pages are displayed correctly

Page 23 Issues with the Dashboard page

Page 24 The statistics are not displayed

Appendix C Example output

Appendix D Example errors

Appendix E Example errors

Page 3: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

3 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Configure screen logging through SSH

We recommend that you configure screen logging to log all session input and output during your troubleshooting session. This log file can be shared with Isilon Technical Support, if you require assistance at any point during troubleshooting.

Note: The screen session capability does not work in OneFS 7.1.0.6 and 7.1.1.2. If you are running either of these versions, you can configure logging by using your local SSH client's logging feature.

1. Open an SSH connection to the cluster and log in by using the root account.

Note: If the cluster is in compliance mode, use the compadmin account to log in. All compadmin commands must be preceded by the sudo prefix.

2. Change the directory to / i f s/ dat a/ I si l on_Suppor t by running the following command:

cd / i f s/ dat a/ I si l on_Suppor t

3. Run the following command to capture all input and output from the session:

scr een - L

This will create a file named scr eenl og. 0 that will be appended to during your session.

4. Perform troubleshooting.

Before you begin

CAUTION!If the node, subnet, or pool that you are working on goes down during the course of troubleshooting and you do not have any other way to connect to the cluster, you could experience data unavailability.

Therefore, make sure that you have more than one way to connect to the cluster before you start this troubleshooting process. The best method is to have a serial console connection available. This way, if you are unable to connect through the network, you will still be able to connect to the cluster physically.

For specific requirements and instructions for making a physical connection to the cluster, see article 304071 on the EMC Online Support site.

Before you begin troubleshooting, confirm that you can connect through either another subnet or pool, or that you have physical access to the cluster.

Page 4: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

4 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Start troubleshooting

Start

IntroductionStart troubleshooting here. For an overview of the conventions used in this flowchart, see Appendix B: How to use this flowchart.

If you have not done so already, log in to the cluster and configure screen logging through SSH, as described on page 3.

Review the Isilon Supportability and Compatibility Guide and confirm that you

are using a supported browser.

Are you able to access the login page

of the OneFS Web Administration

interface?

Go to Page 6No

Yes

Go to Page 5

Page 5: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

5 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Routing

Do you receive the following error when trying to log in to

the web administration interface:"You don't have any assigned privileges. It

appears you have no assigned access privileges to the Web interface. Contact your

system administrator if you feel you have received this message in error."

Page 5

You could have arrived here from:

- Page 4 - Start troubleshooting

Are you able to log in as

admin?

No

Go to Page 16No

Do all pages display

correctly?

Yes

Go to Page 23No

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

Yes

Refer toFor directions on assigning privileges to the web administration interface, refer to the OneFS Web Administration Guide for your version of OneFS.

Yes

Page 6: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

6 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot access the login page

Page 6

You could have arrived here from:

- Page 4 - Start troubleshooting

Try to access the web administration interface using either:

- An IP address from a static pool on each node OR- The SmartConnect service IP address (SSIP)

Can you access the login page?

Try to establish an SSH connection to the cluster using the same IP address that you used above.

No

Are you able to connect by SSH?

Go to Page 7

No

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in

Appendix A.

Yes

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in

Appendix A.

Yes

Page 7: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

7 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot access the login page (2)

Page 7

You could have arrived here from:

- Page 6 - Cannot access the login page

Run the following commands to verify that the authentication services on the cluster are enabled:

i si ser vi ces - a l wsmi si ser vi ces - a aut h

Example output:Ser vi ce ' l wsm' i s enabl ed.

Are the authentication

services enabled?

Go to Page 8Yes

To enable the services, run the following command for the applicable service:

isi ser vi ces - a l wsm enabl ei si ser vi ces - a aut h enabl e

No

Page 8: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

8 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot access the login page (3)

Page 8

You could have arrived here from:

- Page 7 - Cannot access the login page (2)

Verify that authentication services are running by running the following command:

i si _f or _ar r ay - sX ' pgr ep l sass | wc - l '

See the note box on this page for example output.

In the output, do all nodes show

output of 1?

Example outputcl ust er - 1# i si _f or _ar r ay - sX ' pgr ep l sass | wc - l 'cl ust er - 1: 1cl ust er - 2: 1cl ust er - 3: 1

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

No

Yes

Go to Page 9

Page 9: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

9 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot access the login page (4)

Page 9

You could have arrived here from:

- Page 8 - Cannot access the login page (3)

Verify that the web administration interface service is enabled by running the following

command:

i si ser vi ces i si _webui

Example output:Ser vi ce ' i si _webui ' i s enabl ed.

Is the web administration

interface service enabled?

Enable the service by running the following command:

i si ser vi ces - a i si _webui enabl e

No

Go to Page 10Yes

Return to Page 4

Verify that the apache service is enabled:

i si ser vi ces apache2

Example output:Ser vi ce ' apache2' i s enabl ed.

Copy the output into the case notes.

Is the apache service

enabled?

Enable the apache service:

i si ser vi ces - a apache2 enabl eNo

Yes

Page 10: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

10 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot access the login page (5)

Page 10

You could have arrived here from:

- Page 9 - Cannot access the login page (4)

Check whether the webui _webwar e process is running by running the following command:

ps - auxww | gr ep webui

In the output, check to see if there is a line that contains the following text:/ usr / l i bexec/ i si l on/ i si _webui _d . / Launch. py Thr eadedAppSer ver - i / var / r un/ webui _webwar e. pi d - d / usr / l ocal / www/ webki t - o / var / l og/ webui _webwar e. l og

Is that line present? Yes

Try to restart the process by running the following command:

/ usr / l ocal / sbi n/ webui _webwar e_ct l r est ar t

No

Go to Page 11

Return to Page 4

Page 11: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

11 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot access the login page (6)

Page 11

You could have arrived here from:

- Page 10 - Cannot access the login page (5)

Run the following command:

ps - auxww| gr ep ht t pd| gr ep - v gr ep

See Appendix C for example output.

Are those lines present in the

output?

Go to Page 12

Yes

Try to manually start the services by running one or both of the following commands for the lines that are missing from

the output:

/ usr / l ocal / apache2/ bi n/ ht t pd - k st ar t

Or

/ usr / l ocal / apache2/ bi n/ ht t pd - f / usr / l ocal / apache2/ conf / webui _ht t pd. conf - k

st ar t

See Appendix C for example output.

No

Does the output indicate that a specific PID is already

running?

No

Refer to: OneFS: Process httpd of service apache2 has failed to restart after multiple attempts, article 454094

Yes

__________

__________

Page 12: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

12 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot access the login page (7)

Page 12

You could have arrived here from:

- Page 11 - Cannot access the login page (6)

Run the following command:

i si _f or _ar r ay - sX ' net st at - an | gr ep 8080'

In the output, check to see if there is a line that contains the following text:

t cp46 0 0 * . 8080 * . * LI STEN

Is that line present in the

output?

Refer toOneFS: Process httpd of service isi_webui has failed to restart after multiple attempts, article 499006

No

Go to Page 13

Yes

No

When trying to log into the web administration interface, do you receive a

permission denied or a 403 error?

Yes Go to Page 14

Page 13: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

13 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot access the login page (8)

Page 13

You could have arrived here from:

- Page 12 - Cannot access the login page (7)

Are you receiving one of the errors listed in the note box on this

page?

Potential error messages- 500 Internal Server Error- An error has occurred in the web

application. This may be a temporary condition; try clicking the Back button to return to the previous page. If the problem persists or is a serious issue, save this page as HTML source and contact technical support.

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

No

Run the following command to restart the webui service:

/ usr / l ocal / sbi n/ webui _webwar e_ct l r est ar t

Yes

Try to log in to the web administration interface again.

Were you able to log in?

End troubleshooting

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

Yes

No

Page 14: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

14 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

"Permission denied" errors

Page 14

You could have arrived here from:

- Page 12 - Cannot access the login page (7)

Check for permission denied errors by running the following command:

gr ep ' Per mi ssi on deni ed' / var / l og/ webui _webwar e. l og

The output will look similar to the following:

2019- 1- 26T15: 53: 44- 08: 00 <18. 3> cl ust er - 1( i d1) ht t pd[ 1000] : [ er r or ] [ cl i ent 192. 168. 100. 1] ( 13) Per mi ssi on deni ed: access t o / st yl e/ ext 1/ ext - al l . css deni ed, r ef er er : _ht t ps: / / cl ust er - 1. l ocal : 8080/ St at us?l oadSt at e=1

Check to see if the Apache processes across all nodes are being run by the local daemon user (UID = 1), by running the following command:

ps auxwwwHl | egr ep " ^daemon| USER"

See Appendix D for example output and more information.

Is the UID value for each PID

listed as 1?Go to Page 15Yes

Refer to the following KB article to determine if there are duplicate local user accounts that need to be removed:

OneFS 6.5 and later: Duplicate user names cause users to be unable to log in to OneFS or change local account passwords, article 465109

No

Did the KB article resolve the

issue?End troubleshooting

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

No Yes

_________

Page 15: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

15 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Apache directory ownership

Page 15

You could have arrived here from:

- Page 14 - "Permission denied" errors

Check the Apache directory ownership by running the following command:

f i nd / usr / l ocal / www - not - user 0 - and - not - user 1 - exec l s - l and { } \ ;

If no output is returned, the directory is owned by "daemon" and this is correct.

Did the command return

any output?No

Yes

Correct the permissions by running the following command for your version of OneFS, where <v#> is the value of v1 or v1 from the output of the previous command:

OneFS 8.1chown - R 1: 1 / usr / l ocal / www/ st at i c/ <v#>

OneFS 7.2 - 8.0.xchown - R 1: 1 / usr / l ocal / www/ st at i c/ ui / *

Try to log in to the web administration interface again.

Were you able

to log in?

End troubleshooting

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in

Appendix A.

Yes No

End troubleshooting

Page 16: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

16 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot log in with the admin account

Page 16

You could have arrived here from:

- Page 5 - Routing

Can you log in as root?

Try to establish an SSH connection to any node

in the cluster.No

Check to see whether you have any external authentication providers enabled (LDAP, Legacy LDAP, Active Directory, or NIS) by following the

directions for your version of OneFS:

OneFS 8.xUnder the Access menu, select Authentication

Providers. Under the Active Directory, LDAP and NIS tabs, look to see if each provider has a green dot. This green dot indicates that the external provider is

online.

OneFS 7.2Click Cluster Management > Access Management.

In the Access Zones tab, look to see if Active Directory, LDAP, or NIS has a green dot. A green dot

indicates that external provider is enabled.

Yes

Go to Page 17

Can you connect by

SSH?

Go to Page 20

No

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

Yes

Page 17: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

17 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot log in with the admin account (2)

Page 17

You could have arrived here from:

- Page 16 - Cannot log in with the admin account

Do you have any external authentication

providers enabled?Go to Page 18No

Verify that your external authentication providers do not have duplicate user names appearing on the cluster.

Refer to: OneFS 6.5 and later: Duplicate user names cause users to be unable to log in to OneFS or change

local account passwords, article 465109

Yes

Can you log in as admin

now?

End troubleshooting

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

Yes

No

Page 18: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

18 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot log in with the admin account (3)

Page 18

You could have arrived here from:

- Page 17 - Cannot log in with the admin account (2)

Make sure the admin account is enabled by following the below steps from the web administration interface for your version of OneFS.

OneFS 8.xUnder the Access menu, select Membership & Roles. From the Current Access

Zone drop-down box, select System. From the Providers drop-down box, select File: System. For the admin username, check whether the Account Status is Enabled.

OneFS 7.2Click Cluster Management > Access Management > Users. In the Manage Users

section, from the Users Select a zone drop-down list, select System. From the Select a provider drop-down list, select FILE:System. For the admin username, check

whether the Account Status is Enabled.

Is the admin account

enabled?

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

Yes

Go to Page 19

No

Page 19: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

19 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot log in with the admin account (4)

Page 19

You could have arrived here from:

- Page 18 - Cannot log in with the admin account (3)

Using the new admin account

password, can you log in as admin now?

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

No

Enable it by setting the password and enabling the account.OneFS 8.x

From the same screen as above, for the admin username, click View / Edit. Click the Edit User button in the bottom right corner. Enter the desired password in the Password

field. Select the box for Enable the account. Click Save Changes and Close.

OneFS 7.2From the same screen as above, for the admin username, click View details. From the Enable Account section, click Edit, enter the desired password in the Password field

and then select the Enable the account box. Click Save.

Yes End troubleshooting

Page 20: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

20 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot log in with the admin account (5)

Page 20

You could have arrived here from:

- Page 16 - Cannot log in with the admin account

Run the following command to search the / webui _ht t pd_er r or . l og for errors relating to admin or root:

egr ep " admi n| r oot " / var / l og/ apache2/ webui _ht t pd_er r or . l og

See Appendix E for examples of error messages.

Does one of the errors in the output match one of the example errors

in Appendix D?

Go to Page 21Yes

Are you connecting to the web administration

interface with the node IP address or the SmartConnect Service IP

address?

No

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in

Appendix A.

Yes

No

Try to connect to the web administration interface using

the IP address of a node.

Did that resolve the

issue?

No

End troubleshooting

Yes

_________

Page 21: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

21 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot log in with the admin account (6)

Page 21

You could have arrived here from:

- Page 20 - Cannot log in with the admin account (5)

Verify that the admin user exists and that they have a password set by running the following command:

gr ep admi n / et c/ mast er . passwd

The output should look similar to the below example:

admi n: $3$$186cb09181e2c2ecaac768c47c729904: 10: 10: : 0: 0: I si l on UI Admi ni st r at or : / i f s/ home/ admi n: / usr / l ocal / bi n/ zsh

If the command returns any output, it means the admin user exists.If the output contains $3$$, it means there is a password set for the admin user.

Does the command return

any output?

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

No

Does the output contain $3$$?

Yes

Reset the password by running:

passwor d admi n

No

Go to Page 22

Yes

Page 22: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

22 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Cannot log in with the admin account (7)

Page 22

You could have arrived here from:

- Page 21 - Cannot log in with the admin account (6)

Open an SSH connection to the cluster and try to log in

with the admin account.

Yes

Do you know the admin account

password?

Reset the password by running:

passwor d admi n

No

Are you able to log in?

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

End troubleshooting

No

Yes

Page 23: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

23 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Not all pages are displayed correctly

Page 23

You could have arrived here from:

- Page 5 - Routing

Log into the cluster as both the root account and the admin account. Compare the way the

pages display with each login.

Do the same pages display incorrectly when you log in as root and

admin?

No

Is the Cluster Status tab the only page that displays incorrectly?

Yes

Go to Page 24

Yes

No

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in

Appendix A.

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in

Appendix A.

Page 24: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

24 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Issue with the Dashboard page

Page 24

You could have arrived here from:

- Page 23 - Not all pages are displayed correctly

Is the Dashboard

blank?Yes

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

Are the statistics blank?

No

Go to Page 25Yes

Are the statistics not refreshing?

No

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

No

Try a different browser. Yes

Did a different browser resolve the

issue?No

Continue using that browser.

End troubleshooting

Yes

Page 25: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

25 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

The statistics are not displayed

Page 25

You could have arrived here from:

- Page 24 - Issue with the Dashboard page

Open an SSH connection to the affected node and log in

using the root account.

Verify that the statistic services are running by running the following command:

i si ser vi ces - a | gr ep st at s

See the note box on this page for example output.

Are both i si _st at s_d and

i si _st at s_hi st _d enabled?

Example outputcl ust er - 1# i si ser vi ces - a | gr ep st at s i si _st at s_d St at i st i cs & Moni t or i ng Enabl ed i si _st at s_hi st _d St at i st i cs Hi st or y Enabl ed

Go to Page 26

Yes

Run the following command to enable each service that is not enabled, where <ser vi ce> is the name of the service

that needs to be enabled:

i si ser vi ces <ser vi ce> enabl e

No

Page 26: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

26 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

The statistics are not displayed (2)

Page 26

You could have arrived here from:

- Page 25 - The statistics are not displayed

Verify that both services are running by running the following two commands:

ps - f wul p ` pgr ep i si _st at s_d`

ps - f wul p ` pgr ep i si _st at s_hi st _d`

The output for both should appear similar to the note box at the bottom of this page.

For either command, did you receive output, or the

following error: ps: opt i on r equi r es an

ar gument - - p

Example outputUSER PI D %CPU %MEM VSZ RSS TT STAT STARTED TI ME COMMAND UI D PPI D CPU PRI NI MWCHANr oot 2000 0. 0 0. 5 67204 8472 ?? I s Mon02PM 0: 00. 06 / usr / sbi n/ i si _st 0 1 0 8 0 adv

Go to Page 27

This error indicates that the services are enabled

but are not running.

Output

Error

Output indicates that the daemons are running.

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in Appendix A.

Page 27: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

27 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

The statistics are not displayed (3)

Page 27

You could have arrived here from:

- Page 26 - The statistics are not displayed (2)

Run the following command:

i si st at us

Run the following command to disable the i si _webui service:

i si ser vi ces - a i si _webui di sabl e

Wait a few seconds and run:i si ser vi ces - a i si _webui enabl e

Log in to the Web Administration interface again and view the Dashboard page >

Cluster Status tab.

Compare the output from i si st at us to the Cluster Status page.

Does the cluster health

appear the same in the CLI as the web

administration interface?

End troubleshooting

Yes

Note the page number that you are currently on.

Upload log files and contact Isilon Technical Support, as instructed in

Appendix A.

No

Page 28: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

28 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Contact Isilon Technical Support

If you need to contact Isilon Technical Support during troubleshooting, reference the page or step that you need help with. This information and the log file will help Isilon Technical Support staff resolve your case more quickly.

Appendix A: If you need further assistance

Upload node log files and the screen log file to Isilon Technical Support

1. When troubleshooting is complete, in the command-line interface, type exi t to end your screen session.

2. Gather and upload the node log set and include the SSH screen log file by using the command appropriate for your method of uploading files. If you are not sure which method to use, use FTP.

ESRS:i si _gat her _i nf o - - esr s - - l ocal - onl y - f / i f s/ dat a/ I si l on_Suppor t / scr eenl og. 0

FTP: i si _gat her _i nf o - - f t p - - l ocal - onl y - f / i f s/ dat a/ I si l on_Suppor t / scr eenl og. 0

HTTP: i si _gat her _i nf o - - ht t p - - l ocal - onl y - f / i f s/ dat a/ I si l on_Suppor t / scr eenl og. 0

SMTP: i si _gat her _i nf o - - emai l - - l ocal - onl y - f / i f s/ dat a/ I si l on_Suppor t / scr eenl og. 0

SupportIQ: Copy and paste the following command. Note: When you copy and paste the command into the command-line interface, it will appear on multiple lines (exactly as it appears on the page), but when you press Enter, the command will run as it should.

i si _gat her _i nf o - - l ocal - onl y - f / i f s/ dat a/ I si l on_Suppor t / scr eenl og. 0 - - noupl oad \

- - syml i nk / var / cr ash/ Suppor t I Q/ upl oad/ f t p

3. If you receive a message that the upload was unsuccessful, refer to article 304567 on the EMC Online Support site for directions on how to upload files over FTP.

___________

Page 29: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

29 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Decision diamondYes No

Process stepProcess step with command:

command xyz

Go to Page #

Page # Note

Provides context and additional information. Sometimes a note is linked to a process step with a colored dot.

CAUTION!Caution boxes warn that a particular step needs to be performed with great care, to prevent serious consequences.

End pointDocument ShapeCalls out supporting documentation for a process step. When possible, these shapes contain links to the reference document.Sometimes linked to a process step with a colored dot.

Optional process step

Directional arrows indicate the path through the process flow.

IntroductionDescribes what the section helps you to accomplish.

You could have arrived here from:

- Page 4 - Start Troubleshooting

Appendix B: How to use this flowchart

Page 30: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

30 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.___________________

___________________________

You could have arrived here from:

- Page 11 - Cannot access the login page (6)

Appendix C: Example output

Example outputThe output should appear similar to the following example. Successful output will contain lines referring to / usr / l ocal / apache2/ bi n/ ht t pd and / usr / l ocal / apache2/ conf / webui _ht t pd. conf .

cl ust er - 1# ps - auxww| gr ep ht t pd| gr ep - v gr ep r oot 2637 0. 0 1. 1 287948 22756 - Ss 10: 09AM 0: 00. 06 / usr / l ocal / apache2/ bi n/ ht t pd - f / usr / l ocal / apache2/ conf / webui _ht t pd. conf - k st ar t r oot 2640 0. 0 0. 1 4908 2004 - I 10: 09AM 0: 00. 03 l ogger - t ht t pd - p l ocal 3. i nf o daemon 2641 0. 0 1. 1 287912 22740 - I @ 10: 09AM 0: 00. 00 / usr / l ocal / apache2/ bi n/ ht t pd - f / usr / l ocal / apache2/ conf / webui _ht t pd. conf - k st ar t daemon 2642 0. 0 1. 4 304116 29412 - I 10: 09AM 0: 01. 07 / usr / l ocal / apache2/ bi n/ ht t pd - f / usr / l ocal / apache2/ conf / webui _ht t pd. conf - k st ar t r oot 2661 0. 0 1. 1 351344 23228 - Ss 10: 09AM 0: 00. 06 / usr / l ocal / apache2/ bi n/ ht t pd - k st ar t daemon 2694 0. 0 1. 1 350776 22868 - I 10: 09AM 0: 00. 00 / usr / l ocal / apache2/ bi n/ ht t pd - k st ar t daemon 2697 0. 0 1. 2 355316 24724 - I 10: 09AM 0: 00. 00 / usr / l ocal / apache2/ bi n/ ht t pd - k st ar t daemon 2698 0. 0 1. 2 355316 24724 - I 10: 09AM 0: 00. 00 / usr / l ocal / apache2/ bi n/ ht t pd - k st ar t

Page 31: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

31 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

You could have arrived here from:

- Page 14 - "Permission denied" errors

Appendix D: Example output

Example outputThe output will look similar to the following. The UI D column for each process ID (PID) should show a value of 1. Any other number indicates that the local daemon user is not running that process.

cl ust er - 1# ps auxwwwH1 | egr ep " ^daemon| USER"USER PI D %CPU %MEM VSZ RSS TT STAT STARTED TI ME COMMAND UI D PPI D CPU PRI NI MWCHANdaemon 5513 0. 0 0. 8 350800 17408 - I 16Jan19 0: 00. 02 / usr / l ocal / apach 1 5510 0 38 0 acceptdaemon 5514 0. 0 1. 0 355596 19520 - I 16Jan19 0: 00. 00 / usr / l ocal / apach 1 5510 0 35 0 pi per ddaemon 5514 0. 0 1. 0 355596 19520 - I 16Jan19 0: 00. 00 / usr / l ocal / apach 1 5510 0 38 0 uwai tdaemon 5514 0. 0 1. 0 355596 19520 - I 16Jan19 0: 00. 00 / usr / l ocal / apach 1 5510 0 38 0 uwai t

Page 32: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

32 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

You could have arrived here from:

- Page 20 - Cannot log in with the admin account (5)

Appendix E: Example errors

Example output2014- 01- 13T17: 25: 52- 05: 00 <18. 3> cl ust er - 1( i d11) ht t pd[ 2616] : [ er r or ][ cl i ent 178. 178. 178. 221] ( The aut hent i cat i on r equest coul d not be handl ed er r or :40017) Fai l ed t o aut hent i cat e user admi n1, r ef er er : ht t ps: / / 178. 178. 178. 1: 8080/

2014- 01- 13T17: 25: 52- 05: 00 <18. 3> cl ust er - 1( i d11) ht t pd[ 2616] : [ er r or ][ cl i ent 178. 178. 178. 221] ( 401) User name or passwor d i s i ncor r ect . , r ef er er : ht t ps: / / 178. 178. 178. 1: 8080/

2014- 01- 13T17: 27: 46- 05: 00 <18. 3> cl ust er - 1( i d11) ht t pd[ 2616] : [ er r or ][ cl i ent 178. 178. 178. 221] ( The passwor d i s i ncor r ect f or t he gi ven user name er r or: 40022) Fai l ed t o aut hent i cat e user admi n, r ef er er : ht t ps: / / 178. 178. 178. 1: 8080/

2014- 01- 13T17: 27: 46- 05: 00 <18. 3> cl ust er - 1( i d11) ht t pd[ 2616] : [ er r or ][ cl i ent 178. 178. 178. 221] ( 401) User name or passwor d i s i ncor r ect . , r ef er er : ht t ps: / / 178. 178. 178. 1: 8080/

Page 33: EMC Isilon Customer Troubleshooting Guide: Troubleshoot Issues … · 2020-03-04 · 1 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration

33 - EMC Isilon Customer Troubleshooting Guide: Troubleshoot issues with the OneFS Web Administration Interface

For links to all Isilon customer troubleshooting guides, visit the Customer Troubleshooting - Isilon Info Hub.We appreciate your help in improving this document. Submit your feedback at http://bit.ly/isilon-docfeedback.

______________________________________________

Copyright © 2019 Dell Inc. or its subsidiaries. All rights reserved.

Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS-IS." DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE.

Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners.

EMC CorporationHopkinton, Massachusetts 01748-91031-508-435-1000 in North America 1-866-464-7381www.EMC.com