GROMACS: Perbedaan antara revisi

Dari ALELEON by EFISON
(tes format baru)
(reformat)
Baris 19: Baris 19:


== '''Menjalankan GROMACS di Job Composer''' ==
== '''Menjalankan GROMACS di Job Composer''' ==
* User menjalankan GROMACS pada '''Job Composer''' EFIRO yang dapat dibuka melalui menu Jobs > Jobs Composer:
[[Berkas:Efirojobcomposermenu.png|nirbing|350x350px|al=]]
* Pilih '''New Jobs > From Template'''
[[Berkas:Jcnewjobmarked.png|al=|nirbing|180x180px]]
== '''Memilih template GROMACS''' ==
[[Berkas:Jcselecttemplate3.png|al=|nir|jmpl|'''Memilih template, mengisi Job Name, dan  klik Create New Job''']]
{| class="wikitable"
{| class="wikitable"
|+Template GROMACS yang tersedia
|'''1'''
|Buka menu dashboard EFIRO '''<code>Jobs</code> > <code>Jobs Composer</code>'''
[[Berkas:Efirojobcomposermenu.png|nirbing|300x300px|al=|pra=https://wiki.efisonlt.com/wiki/Berkas:Efirojobcomposermenu.png]]
|-
|'''2'''
|Pilih '''<code>New Jobs</code> > <code>From Template</code>'''
[[Berkas:Jcnewjobmarked.png|al=|nirbing|180x180px|pra=https://wiki.efisonlt.com/wiki/Berkas:Jcnewjobmarked.png]]
|-
|'''3'''
|
==='''Memilih Template GROMACS'''===
[[Berkas:Jcselecttemplate3.png|al=|nir|jmpl|Pilih template GROMACS yang dibutuhkan. Isi atau ganti <code>'''Job Name'''</code> sesuai keinginan user, kemudian klik <code>'''Create New Job'''</code>.|pra=https://wiki.efisonlt.com/wiki/Berkas:Jcselecttemplate3.png]]
{| class="wikitable"
|+Template GROMACS
!Nama Template
!Nama Template
!Penjelasan
!Penjelasan
|-
|-
|GROMACS 2021.1 (CPU)
|GROMACS 2021.1 (CPU)
|GROMACS 2020.01 versi CPU
|Menjalankan GROMACS 2021.1 versi CPU
|-
|-
|GROMACS 2021.1 dengan 1 GPU
|GROMACS 2021.1 dengan 1 GPU
|Jalan dengan akselerasi 1 GPU
|GROMACS 2021.1 dengan akselerasi 1 GPU
|-
|-
|GROMACS 2021.1 dengan 2 GPU
|GROMACS 2021.1 dengan 2 GPU
|Jalan dengan akselerasi 2 GPU
|GROMACS 2021.1 dengan akselerasi 2 GPU
|}
|}
* Pilih template GROMACS yang dibutuhkan
|-
* Isi '''Job Name''' sesuai keinginan user kemudian klik '''Create New Job'''.
| rowspan="2" |'''4'''
|
==='''Mempersiapkan File untuk Menjalankan Job'''===
[[Berkas:Jcjoboption3.png|nirbing|600x600px|pra=https://wiki.efisonlt.com/wiki/Berkas:Jcjoboption3.png]]
*Gunakan menu '''<code>Edit Files</code>''' untuk upload file yang dibutuhkan'''.'''
**Laman Edit Files juga dapat melakukan view / download / edit / rename / delete file.
|-
|''Fitur upload pada laman Edit Files '''mempunyai batasan ukuran upload 2GB per file'''. Gunakan [[Upload File dengan Aplikasi FTP|'''aplikasi FTP''']] apabila user hendak mengupload file tunggal diatas 2GB.''
|-
|'''5'''
|
=== Mempersiapkan Parameter Input GROMACS ===
[[Berkas:Jcjoboption4.png|nirbing|600x600px]]


== '''Mempersiapkan parameter input GROMACS''' ==
Beberapa perintah GROMACS bekerja secara interaktif dan membutuhkan input dari user (contoh: '''pdb2gmx, grompp''') sehingga harus dijalankan via terminal melalui menu '''<code>Open Terminal</code>.'''
[[Berkas:Jcjoboption2.png|al=|nirbing|600x600px]]


* User dapat melakukan '''upload, editing, dan rename file GROMACS yang dibutuhkan''' melalui menu '''Edit Files.'''
* Muat modul GROMACS sesuai dengan versi template yang digunakan.


* Beberapa perintah GROMACS bekerja secara interaktif dan membutuhkan input dari user (contoh: '''pdb2gmx, grompp''') sehingga harus dijalankan via terminal melalui menu '''Open Terminal.'''
{| class="wikitable"
** Muat modul GROMACS untuk mengaktifkan software GROMACS:
!Versi GROMACS
** Lanjutkan dengan melakukan perintah interaktif GROMACS (contoh: pdb2gmx):
!Perintah
|-
|2021.1
|<code>$ module load gromacs</code>
|}


$ module load gromacs
* Lanjutkan dengan melakukan perintah interaktif GROMACS (contoh: pdb2gmx):
$ gmx_mpi pdb2gmx <parameter_input_dan_output>
== '''Melengkapi Submit Script Template''' ==
[[Berkas:Jceditor3.png|al=|nirbing|500x500px]]


* Melalui menu '''Open Editor''', user perlu melengkapi Submit Script supaya program GROMACS dapat berjalan:
$ gmx_mpi '''pdb2gmx''' '''''<parameter_input_dan_output>'''''
**Parameter SBATCH.
|-
**Parameter input GROMACS sesuai setup user.
|'''6A'''
|
==='''Melengkapi Submit Script Template'''===
[[Berkas:Jceditor3.png|al=|nirbing|300x300px|pra=https://wiki.efisonlt.com/wiki/Berkas:Jceditor3.png]]


*Jangan lupa Save setiap sekali mengubah script.
Melalui '''<code>Open Editor</code>''', lengkapi Submit Script dengan mengganti bagian yang di tandai 4 garis miring (////).
[[Berkas:Save.png|nirbing|450x450px|pra=https://wiki.efisonlt.com/wiki/Berkas:Save.png]]
*'''''Jangan lupa klik <code>Save</code> setiap sekali mengubah script.'''''
 
|-
---
| rowspan="2" |'''6B'''
===Panduan lengkap mengisi Submit Script===
|
[[Berkas:Wiki-14.jpg|1000x1000px|link=SLURM Script ALELEON Supercomputer |alt=SLURM Script ALELEON Supercomputer ]]
==='''Panduan lengkap mengisi Submit Script:'''===
 
[[Berkas:Wiki-14edit.jpg|al=SLURM Script ALELEON Supercomputer|1000x1000px |link=Submit Script ALELEON Supercomputer ]]
'''Note:''' Submit Script pada dasarnya adalah '''SLURM Script''' karena ALELEON Supercomputer menggunakan manajemen SLURM untuk menjalankan job di Compute Node.
== '''Fitur MPI pada GROMACS versi CPU''' ==
GROMACS versi CPU menggunakan MPI (Message Passing Interface) sehingga memberi kebebasan user untuk:
{| class="wikitable"
![[MPI ALELEON Supercomputer]]
|-
|-
|
|
==='''Fitur MPI pada PHASE/0'''===
PHASE/0 menggunakan MPI (Message Passing Interface) sehingga memberi kebebasan user untuk:
*[https://wiki.efisonlt.com/wiki/MPI_ALELEON_Supercomputer#MPI_Satu_Node_vs_Multi_Node '''MPI Satu Node vs Multi Node''']
*[https://wiki.efisonlt.com/wiki/MPI_ALELEON_Supercomputer#MPI_Satu_Node_vs_Multi_Node '''MPI Satu Node vs Multi Node''']
**User dapat menjalankan GROMACS versi CPU hanya dengan 1 node (maksimal 128 core thread CPU)
**User dapat menjalankan PHASE/0 hanya dengan 1 node (maksimal 128 core thread CPU)
**Atau menggunakan '''multi-node''' alias '''lebih dari 128 core thread CPU'''.
**Atau menggunakan '''multi-node''' alias '''lebih dari 128 core thread CPU'''.
|}
|-
=='''Menjalankan Job'''==
| rowspan="3" |'''7'''
Semua file untuk menjalankan program dan Submit Script sudah siap? Jalankan job dengan menekan tombol '''Submit'''.
|
==='''Menjalankan Job'''===
Jalankan job dengan klik tombol '''<code>Submit</code>'''.


[[Berkas:Jcsubmit2.png|al=|nirbing|600x600px|pra=https://wiki.efisonlt.com/wiki/Berkas:Jcsubmit2.png]]
[[Berkas:Jcsubmit2.png|al=|nirbing|600x600px|pra=https://wiki.efisonlt.com/wiki/Berkas:Jcsubmit2.png]]
*Perhatikan status jalannya job pada kolom '''Status.'''
|-
|Berikut penjelasan kolom '''<code>Status</code>,''' pantau dengan refresh halaman job''':'''
{| class="wikitable"
{| class="wikitable"
!Status
!Status
Baris 99: Baris 116:
|-
|-
|Queue
|Queue
| Job mengantri dan belum berjalan.
|Job mengantri dan belum berjalan.
|-
|-
|Completed
|Completed
Baris 108: Baris 125:
Bisa karena di Stop atau Delete oleh user.
Bisa karena di Stop atau Delete oleh user.
|}
|}
*User dapat memantau perubahan kolom Status dengan me-refresh halaman Job.
|-
*Apabila user ingin menghentikan job yang sedang berjalan, klik tombol '''Stop''' yang berada di sebelah tombol Submit.
|
=='''Melihat hasil job yang selesai'''==
===Stop atau Cancel Job===
Apabila job sudah selesai (status Completed), user dapat melihat hasil output job melalui bagian '''Folder Contents''' atau membuka halaman '''Edit Pages.'''[[Berkas:Jcfoldercontentsedit.png|pra=https://wiki.efisonlt.com/wiki/Berkas:Jcfoldercontentsedit.png|al=|nir|jmpl|'''Kolom Folder Contents melihat isi dari ruang direktori job. User dapat melihat semua file output yang keluar di kolom ini.''']][[Berkas:Jcjoboption3.png|nir|jmpl|'''atau dengan membuka menu Edit Files. Melalui halaman ini user juga dapat melakukan revisi file input misalnya apabila hasil output tidak sesuai yang diharapkan.'''|pra=https://wiki.efisonlt.com/wiki/Berkas:Jcjoboption3.png]]
Untuk menghentikan job yang tengah berjalan, klik tombol '''Stop'''.
=='''Submit ulang job'''==
 
User dapat '''menjalankan ulang ruang job yang sama''' (misalkan ketika ada koreksi file input atau Submit Script) dengan mengklik kembali tombol Submit.
[[Berkas:Stop.png|nirbing|600x600px|pra=https://wiki.efisonlt.com/wiki/Berkas:Stop.png]]
|-
|'''8A'''
|
==='''Melihat hasil job yang selesai'''===
Hasil output job dapat dilihat pada kolom '''<code>Folder Contents</code>''' atau membuka halaman '''<code>Edit Pages</code>.'''[[Berkas:Jcfoldercontentsedit.png|pra=https://wiki.efisonlt.com/wiki/Berkas:Jcfoldercontentsedit.png|al=|nir|jmpl|User dapat melihat semua file output yang keluar di kolom '''<code>Folder Contents</code>'''.]][[Berkas:Jcjoboption3.png|nir|jmpl|atau dengan membuka menu '''<code>Edit Files</code>'''.|pra=https://wiki.efisonlt.com/wiki/Berkas:Jcjoboption3.png]]
|-
|'''8B'''
|
==='''Submit Ulang Job'''===
User dapat '''menjalankan ulang ruang job yang sama''' (misalkan ketika ada koreksi file input atau Submit Script) dengan '''mengklik kembali tombol <code>Submit</code>'''.
|}
=='''Akselerasi GPU di GROMACS'''==
=='''Akselerasi GPU di GROMACS'''==
User dapat menjalankan GROMACS dengan bantuan akselerasi GPU di Compute Node GPU. Perlu diketahui '''tidak semua input dan parameter berjalan kencang dengan akselerasi GPU'''.   
User dapat menjalankan GROMACS dengan bantuan akselerasi GPU di Compute Node GPU. Perlu diketahui '''tidak semua input dan parameter berjalan kencang dengan akselerasi GPU'''.   

Revisi per 25 Maret 2022 12.00

GROMACS.png

GROMACS adalah package berkecepatan tinggi untuk komputasi dinamika molekular baik untuk biokimia (seperti protein, lipids) maupun non-biokimia (seperti polimer).

Versi yang Tersedia

Versi Dukungan MPI Dukungan Hardware
2021.1 (CPU) Pure MPI CPU, multi-node
2021.1 (GPU) Hybrid MPI/OMP CPU-GPU, single-node

Menjalankan GROMACS di Job Composer

1 Buka menu dashboard EFIRO Jobs > Jobs Composer

2 Pilih New Jobs > From Template

3

Memilih Template GROMACS

Pilih template GROMACS yang dibutuhkan. Isi atau ganti Job Name sesuai keinginan user, kemudian klik Create New Job.
Template GROMACS
Nama Template Penjelasan
GROMACS 2021.1 (CPU) Menjalankan GROMACS 2021.1 versi CPU
GROMACS 2021.1 dengan 1 GPU GROMACS 2021.1 dengan akselerasi 1 GPU
GROMACS 2021.1 dengan 2 GPU GROMACS 2021.1 dengan akselerasi 2 GPU
4

Mempersiapkan File untuk Menjalankan Job

Jcjoboption3.png

  • Gunakan menu Edit Files untuk upload file yang dibutuhkan.
    • Laman Edit Files juga dapat melakukan view / download / edit / rename / delete file.
Fitur upload pada laman Edit Files mempunyai batasan ukuran upload 2GB per file. Gunakan aplikasi FTP apabila user hendak mengupload file tunggal diatas 2GB.
5

Mempersiapkan Parameter Input GROMACS

Jcjoboption4.png

Beberapa perintah GROMACS bekerja secara interaktif dan membutuhkan input dari user (contoh: pdb2gmx, grompp) sehingga harus dijalankan via terminal melalui menu Open Terminal.

  • Muat modul GROMACS sesuai dengan versi template yang digunakan.
Versi GROMACS Perintah
2021.1 $ module load gromacs
  • Lanjutkan dengan melakukan perintah interaktif GROMACS (contoh: pdb2gmx):
$ gmx_mpi pdb2gmx <parameter_input_dan_output>
6A

Melengkapi Submit Script Template

Melalui Open Editor, lengkapi Submit Script dengan mengganti bagian yang di tandai 4 garis miring (////).

  • Jangan lupa klik Save setiap sekali mengubah script.
6B

Panduan lengkap mengisi Submit Script:

SLURM Script ALELEON Supercomputer

Fitur MPI pada PHASE/0

PHASE/0 menggunakan MPI (Message Passing Interface) sehingga memberi kebebasan user untuk:

  • MPI Satu Node vs Multi Node
    • User dapat menjalankan PHASE/0 hanya dengan 1 node (maksimal 128 core thread CPU)
    • Atau menggunakan multi-node alias lebih dari 128 core thread CPU.
7

Menjalankan Job

Jalankan job dengan klik tombol Submit.

Berikut penjelasan kolom Status, pantau dengan refresh halaman job:
Status Arti
Not Submitted Job belum pernah dijalankan.
Running Job berjalan.
Queue Job mengantri dan belum berjalan.
Completed Job selesai berjalan.
Failed Job berhenti di tengah jalan,

Bisa karena di Stop atau Delete oleh user.

Stop atau Cancel Job

Untuk menghentikan job yang tengah berjalan, klik tombol Stop.

Stop.png

8A

Melihat hasil job yang selesai

Hasil output job dapat dilihat pada kolom Folder Contents atau membuka halaman Edit Pages.
User dapat melihat semua file output yang keluar di kolom Folder Contents.
atau dengan membuka menu Edit Files.
8B

Submit Ulang Job

User dapat menjalankan ulang ruang job yang sama (misalkan ketika ada koreksi file input atau Submit Script) dengan mengklik kembali tombol Submit.

Akselerasi GPU di GROMACS

User dapat menjalankan GROMACS dengan bantuan akselerasi GPU di Compute Node GPU. Perlu diketahui tidak semua input dan parameter berjalan kencang dengan akselerasi GPU.

  • Harap user dapat menguji terlebih dahulu mdrun-nya dengan nsteps kecil untuk mengetahui peningkatan performa yang bisa diperoleh melalui akselerasi GPU.
  • Perhatikan bahwa pengujian tersebut menggunakan kredit CPU Core Hour dan GPU Hour user.

Biasanya, GROMACS mdrun tidak memerlukan parameter tambahan untuk menjalankan akselerasi GPU. Namun dalam beberapa kasus, optimasi menggunakan parameter tambahan bisa berpengaruh positif ke kecepatan komputasi. Referensi mengenai parameter akselerasi GPU lanjutan (-nb, -bonded, -pme) dapat dibaca di laman:

---

Ikuti Arahan Template

User disarankan untuk tidak mengubah parameter CPU, GPU, RAM, OMP, dan perintah mdrun pada template karena telah dirancang untuk berjalan optimal di Compute Node GPU ALELEON Supercomputer.