.. _crsp troubleshoot: CRSP Troubleshooting ==================== .. contents:: :local: Please note that RCIC does not provide Windows OS or macOS support for the campus. If there is an operating system related issue, RCIC will refer you to you get support to address your systems issue first before installing CRSP Desktop. The following sections have information on how to solve most common problems. If you continue having issues after reading the guide below please see :ref:`submit ticket` a ticket. .. _problem install: CRSP Desktop install problems ----------------------------- If you are having issues installing *CRSP Desktop*, please check the following: .. _problem mac install: :section:`On macOS` 1. Your laptop meets minimal system requirements listed in the :ref:`client desktop mac`. #. Make sure you have *Admin* rights on your system. If your system is managed by OIT, ask your support team to give you *Admin* rights. #. In :guilabel:`Applications`, check for *CRSP Desktop* (or *Mountain Duck*). If found, drag the App to trash, and retry installation using RCIC provided version :ref:`client desktop mac`. .. _problem windows install: :section:`On Windows` 1. Your laptop meets minimal system requirements listed in the :ref:`client desktop windows`. #. In :guilabel:`Windows -> Add or Remove Programs`, check for *CRSP Desktop* (or *Mountain Duck*). If found, uninstall any previous installations, reboot the system and retry installation using RCIC provided version :ref:`client desktop windows`. #. Check for any obvious errors or warnings on your laptop. .. _problem empty share: Share is not visible or is empty -------------------------------- This could be caused by one or more reasons: .. table:: :align: center :class: noscroll-table +--------------------------------------------+------------------------------------------------------+ | Reason | Resolution | +============================================+======================================================+ | Disconnect from share after computer | Reconnect your share. | | came back from sleep, or hibernation mode. | | +--------------------------------------------+------------------------------------------------------+ | Not connected via UCI VPN. | You must either be on the campus network or | | | connected to the | | | `UCI campus VPN `_ | +--------------------------------------------+------------------------------------------------------+ | Network connectivity is poor or network | Ensure your system is connected to UCINET | | is down. | or home internet. Restart system if necessary. | +--------------------------------------------+------------------------------------------------------+ If the above does not solve your issue, try deleting the *share bookmark* from *CRSP Desktop*, and recreate it anew. Follow configuring share instructions for your laptop type in :ref:`crsp clients` guide. .. _problem login: Unable to login --------------- This could be caused by one or more reasons: .. table:: :align: center :widths: 45,55 :class: noscroll-table +--------------------------------------------+------------------------------------------------------+ | Reason | Resolution | +============================================+======================================================+ | You don't have an account created for CRSP.| Please note that HPC3 and CRSP accounts are created | | | separately. See :ref:`getting crsp account`. | +--------------------------------------------+------------------------------------------------------+ | Not connected via UCI VPN. | You must either be on the campus network or | | | connected to the | | | `UCI campus VPN `_ | +--------------------------------------------+------------------------------------------------------+ | Your UCInetID password is incorrect. | Make sure your password is correct. | | | Please see :ref:`password reset `. | +--------------------------------------------+------------------------------------------------------+ | Your CRSP home directory is over quota. | Check your :ref:`crsp quotas`. | +--------------------------------------------+------------------------------------------------------+ | There may be a technical issue with CRSP. | Please submit a ticket. | +--------------------------------------------+------------------------------------------------------+ | Authentication errors. | When setting your CRSP desktop app you see a message | | | similar to: *Too many authentication errors*. | | | *Please contact your web hosting* | | | *service provider for assistance*. | | | Follow the steps in `workaround`_ below. | +--------------------------------------------+------------------------------------------------------+ .. _workaround: :section:`Workaround` There is a bug in :guilabel:`CRSP Desktop` app that causes the authentication errors. The errors may happen when :underline:`you used to have a password access and have stored your password in the laptop credentials manager and then you switched to the ssh-keys based access`. The workaround is as follows. :bluelight:`For Windows laptops` - Quit :guilabel:`CRSP Desktop` App. - Open the :guilabel:`Windows Credentials Manager` and delete any references to CRSP. It might be under *sftp* , it might be under *access.crsp*. Remove all such entries. That should remove the remembered password for the CRSP desktop. - Start :guilabel:`CRSP Desktop` App which will ask for the passphrase for your locally-setup key. :bluelight:`For macOS laptops` - Quit :guilabel:`CRSP Desktop` App. - Open :guilabel:`Applications -> Utilities -> Keychain Access` application (standard on Mac). - Choose a Default keychain :guilabel:`login`, then :guilabel:`Passwords`, and in the :guilabel:`Search` box type `crsp`. - Delete entries with *crsp* in their names that show up in the main window. See for a reference: .. figure:: images/crsp/mac-keychain.png :align: center :alt: Keychain access app Keychain Access App Do the same for Default keychain :guilabel:`iCloud` or any other keychain that you may have on your laptop. - Quit :guilabel:`Keychain Access` app. - Start :guilabel:`CRSP Desktop` app, edit your lab bookmark. It should no longer have Password field pre-filled or you should be able to remove what is there and the password should not appear again. - Try to connect to the lab share. you will be *prompted for your passphrase* which is what you used when you created your ssh keys. .. _problem sshfs: Unable to access via SSHFS -------------------------------- Reason: * slow network connection * unstable network connections * CRSP share is unavailable. Resolution: Unmount and then remount the share. .. code-block:: console $ fusermount -u ~/your-mount-point $ sshfs UCInetID@crspssh.crsp.uci.edu:/mmfs1/home/UCInetID ~/your-mount-point .. _problem file browser: File Browser issues ------------------- | You must be registered and setup with `UCI DUO `_ in order to use File Browser. The following are the known limitations of File Browser access: * File Browser based access is for lightweight use cases. * It will take longer to populate the File Browser if there are lots of files in a directory. In our lab tests, we were able to load around 2000 files. * Uploading large size files can be a problem if you have slow internet connection or if your connection is interrupted. If you have large data sets, use one of the following clients in place of File Browser: * :ref:`client sshfs` * :ref:`client desktop mac` * :ref:`client desktop windows` * Running the File Browser in *Firefox* does not provide the best user experience. *Chrome* or *Safari* seems to work better. * Since the File Browser works with campus shibboleth authentication, it will timeout and expire as soon as your web browser authentication expires. That means a re-authentication will be required.