Skip to main content
XCP

Troubleshoot XCP File Analytics errors

Contributors netapp-pcarriga netapp-aoife netapp-cgoff netapp-barbe ciarm

Review the solutions to troubleshoot your issue.

Issue Solution

PostgreSQL service failed

Run configure again and select the installation option. If the previous installation was successful, you can select the repair option. If you are still getting the error, try manual steps as follows:

  1. Restart the PostgreSQL service:

    sudo systemctl restart postgresql.service

  2. Check the service status:

    sudo systemctl status postgresql.service | grep Active

HTTPD service failed

Run configure again and select the installation option. If the previous installation was successful, you can select the repair option. If you are still getting the error, try manual steps as follows:

  1. Restart the HTTPD services:

    sudo systemctl restart httpd

  2. Check the HTTPD service status:

    sudo systemctl status httpd | grep Active

Not able to open login page after successful install

Verify that your system can ping the Linux machine where XCP File Analytics is installed and HTTPD is running. If the services are not running, run configure and choose the repair option.

Verify that you are using a supported browser version. See the IMT.

User login failed

  • Verify that you are using a supported browser version. See the IMT.

  • Verify that the user is “admin” and the password is correct.

  • Verify that the XCP service is running by issuing xcp service status.

  • Verify that port 5030 is open on Linux. Open the application at https:// <linux ip> :5030/api/xcp, and confirm that the messagereads msg: Missing Authorization Header.

  • Check whether the xcp.ini file is present in the /opt/NetApp/xFiles/xcp/ location. To reset the xcp.ini file, run the configuration script and select the Repair option. Next, select the menu option to rebuild xcp.ini file.

  • Manually run the xcp --listen command on the CLI and try logging in. If you do not receive a request on the server, re-check the installation and the ports used for communication with the server. After you verify that the installation is correct, run the service xcp start command to restart the service.

XCP GUI is not showing updated pages

Clear the cache and try again

XCP service is not starting

To run the xcp service, use the sudo systemctl start xcp command. Alternatively, run the configuration script and select the Repair option to start the services that are stopped.

Failed to scan file share

File share/volume might not be readable. Check manually whether the file share is accessible/readable by running the xcp show command.
Also, check if the xcp.ini file is deleted. If it is deleted, rebuild the xcp.ini file by using the configure.sh script repair option.

Could not load file servers

Try a page refresh. If the problem persists, manually run the xcp show command on the prompt and check whether you can scan the file server. If successful, raise a ticket with NetApp customer support. If unsuccessful, check if the file server is active by performing a manual check.

Check whether the xcp.ini file and license files are in the correct location. To reset the xcp.ini file, run the configuration script and select the Repair option. Next, select the menu option to rebuild xcp.ini file.

Check the xcpfalogs logs to see if the license needs renewal.

XCP File Analytics page is not displayed after system reboot

XCP services might be down. Run the configuration script and select the option to Repair. This will restart all the services that are stopped.

The total space for an exported file system on a given file server might show more space compared to the allocated physical storage.

This can happen when there are qtree level exports inside the volume.
For example, if the volume size that is exported as /vol1 is 10 GB and there is a qtree inside the volume /vol1/qtree1, then the xcp show command will show the vol1 size as 10 GB and the qtree1 size as 10 GB. XCP File Analytics sums the space of both exports and gives the total space, in this case, 20 GB. It does not understand that qtree1 is a logical space.

The site can’t be reached or user login failed after a successful install.

  1. Check if XCP services are running:
    service xcp status

  2. Start the XCP listen operation and confirm that there are no errors:

    xcp –listen

  3. If you see the following error, install the CodeReady packages using yum, such as yum install codeready-builder-for-rhel-8-x86_64-rpms:

Error:
-------
Traceback (most recent call last):
  File "xcp.py", line 1146, in <module>
  File "xcp.py", line 1074, in main
  File "<frozen importlib._bootstrap>", line 991, in _find_and_load
  File "<frozen importlib._bootstrap>", line 975, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 671, in _load_unlocked
  File "PyInstaller/loader/pyimod03_importers.py", line 495, in exec_module
  File "rest/routes.py", line 61, in <module>
  File "<frozen importlib._bootstrap>", line 991, in _find_and_load
  File "<frozen importlib._bootstrap>", line 975, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 671, in _load_unlocked
  File "PyInstaller/loader/pyimod03_importers.py", line 495, in exec_module
  File "onelogin/saml2/auth.py", line 14, in <module>
xmlsec.Error: (1, 'cannot load crypto library for xmlsec.')
[23891] Failed to execute script 'xcp' due to unhandled exception!