iCommands Troubleshooting and Issue Report¶

Troubleshooting¶

Installing iCommands on Windows and macOS¶

iCommands has limited support for Windows and macOS. While there are options available, such as using Windows Subsystem for Linux (WSL) or custom iCommands packages for macOS, we highly recommend using GoCommands as a more versatile alternative.

GoCommands is a cross-platform tool that offers similar functionality to iCommands with several advantages:

Cross-platform compatibility: Works seamlessly on Windows, macOS, and Linux
No installation required: Simply download and run the executable
User-friendly commands: Provides essential data access functions

For detailed instructions on downloading, setting up, and using GoCommands, please refer to the GoCommands documentation.

Running iCommands in an HPC Environment¶

To use pre-installed iCommands in an HPC environment:

module load irods

This command provides access to iRODS iCommands.

Request Support¶

If you encounter an issue that you cannot resolve, please contact support@cyverse.org for assistance. Your Data Store access via iCommands may be limited or fail due to various factors, including configuration issues, network problems, authentication errors, or data policies. The support team is available to help you identify and resolve these issues.

Report Bugs¶

Encountered a bug in iCommands? We encourage you to report it on the iCommands GitHub issues page. Your detailed bug reports are invaluable for improving the stability and usability of iCommands for the entire iRODS community. When submitting, please provide as much information as possible to help with diagnosis and resolution.