====== Support & Contact ======

===== How to Get Help =====

^ I need... ^ What to do ^
| An account on the cluster | Email [[mailto:it-support@abi.am|it-support@abi.am]] with your name, email, and SSH public key. See [[getting_started:new_member|New Member Onboarding]]. |
| Software installed on the cluster | Email [[mailto:it-support@abi.am|it-support@abi.am]] with the tool name, version, and homepage. Or [[software:conda|install it yourself with Conda]]. |
| Help with Slurm / running jobs | Check the [[software:slurm|Slurm Guide]], then email IT if your issue is not covered. |
| Help with a bioinformatics analysis | Ask your project lead or email the team mailing list. *TODO: add project-specific contacts or mailing list.* |
| Help with this wiki | See [[getting_started:wiki_editing|How to Edit This Wiki]] or just ask -- someone will help. |
| To report a server/infrastructure issue | Email [[mailto:it-support@abi.am|it-support@abi.am]] with a description of the problem, the server name, and any error messages. |
| General IT help | Email [[mailto:it-support@abi.am|it-support@abi.am]] |

===== Contact =====

^ Contact ^ For ^
| **[[mailto:it-support@abi.am|it-support@abi.am]]** | Technical support, accounts, infrastructure issues |
| *TODO: research lead email* | Scientific questions, project guidance |
| *TODO: mailing list* | General announcements and discussions |

----

===== Troubleshooting =====

Before contacting support, check these common issues:

==== Connection Problems ====

^ Problem ^ Solution ^
| Cannot SSH into the server | Check your SSH key is correct. Try ''ssh -v user@ssh.abi.am'' for verbose output. |
| Connection timeout | ''ssh.abi.am'' is accessible from the internet -- no VPN needed. Check your network connection and try again. |
| ''Permission denied (publickey)'' | Your SSH key is not on the server. Email IT to add it. |

==== Slow Internet at the Office ====

  - **Test local network speed:** Copy a large file (>100MB) from a local server. If slow, the WiFi may be the issue -- try reconnecting.
  - **Test Armenian network speed:** Run a speed test at [[https://www.speedtest.net/|Speedtest.net]]. Should be >250 Mbps.
  - **Test international connectivity:** Run a speed test at [[https://librespeed.org/|librespeed.org]] using a Western European server (Amsterdam, Frankfurt). If slow, the issue is upstream at IIAP.

==== Slurm Issues ====

^ Problem ^ Solution ^
| Job stuck in ''PD'' (pending) | Resources are busy. Check with ''sinfo'' if nodes are available. Reduce resource request if possible. |
| Job failed immediately | Check the log file for error messages. Common causes: typo in script, missing input file, wrong path. |
| ''Exceeded job memory limit'' | Your job needed more memory than requested. Increase ''%%--mem%%''. |
| ''CANCELLED ... DUE TO TIME LIMIT'' | Job took longer than expected. Increase ''%%--time%%''. |

See the full [[software:slurm#troubleshooting|Slurm Troubleshooting]] section for more.

==== Disk Space Issues ====

<code bash>
# Check your home directory usage (~12G quota)
du -sh /mnt/home/$USER/

# Check your personal workspace (~100G quota)
du -sh /mnt/nas0/user/$USER/

# Check project directory usage
du -sh /mnt/nas1/proj/your_project/

# Check overall filesystem space
df -h /mnt/home /mnt/nas0/user /mnt/nas1/proj /mnt/nas1/db
</code>

If you are running out of space:
  * Remove old/temporary files and intermediate results
  * Clean Conda caches: ''conda clean --all''
  * You do **not** need to manually compress files -- the storage uses ZFS with transparent compression

----

===== Frequently Asked Questions =====

**Q: How do I change my password?**

A: *TODO: Describe password change procedure. If passwords are managed via LDAP, the admin changes it. If there is a self-service option, document it here.*

**Q: How do I add someone to my project?**

A: Contact **[[mailto:it-support@abi.am|it-support@abi.am]]** with the person's username and the project name.

**Q: Where should I store my data?**

A: Use your project directory (''/mnt/nas1/proj/<project>'') for research data. Use ''/mnt/nas0/user/<your_username>'' for personal experiments and data. Keep your home directory (''/mnt/home'') for configs and small scripts only (~12G quota). See [[getting_started:cluster_basics#storage|Storage]].

**Q: Can I install software myself?**

A: Yes, using Conda. See [[software:conda|Installing Software with Conda]]. For system-wide installations, request them via IT.

**Q: What happens when my job finishes?**

A: Output files are written wherever your script specifies. The console output goes to the log file specified by ''%%--output%%''. Check it with ''cat log/yourjob_<jobid>.log''.

----

===== Contributing to This Wiki =====

This wiki improves when everyone contributes. If you have knowledge to share:
  * Write a new page: [[getting_started:wiki_editing|How to Edit This Wiki]]
  * Fix an error: click "Edit this page" on any page
  * Suggest improvements: email IT or just make the change

----

*TODO: Add any ABI-specific policies (acceptable use, data retention, acknowledgment in publications, etc.) here or link to a separate policy page.*