Cheaha Quick Start (Deprecated) - Revision history

Mhanby@uab.edu at 19:40, 11 February 2019

2019-02-11T19:40:34Z

← Older revision		Revision as of 19:40, 11 February 2019
Line 3:		Line 3:
	Cheaha is a shared cluster computing environment for UAB researchers. Cheaha offers total 8.75 TFLOPS compute power, 200 TB high-performance storage and 2.8 TB memory. See [[Cheaha_Quick_Start_Hardware]] for more details on compute platform, but first let's get started with an example and see how easy it is to use.		Cheaha is a shared cluster computing environment for UAB researchers. Cheaha offers total 8.75 TFLOPS compute power, 200 TB high-performance storage and 2.8 TB memory. See [[Cheaha_Quick_Start_Hardware]] for more details on compute platform, but first let's get started with an example and see how easy it is to use.

	If you have any questions about Cheaha usage then please contact Research Computing team at support@~~vo.uabgrid~~.uab.edu .		If you have any questions about Cheaha usage then please contact Research Computing team at support@listserv.uab.edu .

	== Logging In ==		== Logging In ==
Line 89:		Line 89:

	== Support ==		== Support ==
	If you have any questions about our documentation or need any help with Cheaha then please contact us on support@~~vo.uabgrid~~.uab.edu . Cheaha is maintained by [[About_Research_Computing\|UAB IT's Research Computing team]].		If you have any questions about our documentation or need any help with Cheaha then please contact us on support@listserv.uab.edu . Cheaha is maintained by [[About_Research_Computing\|UAB IT's Research Computing team]].

Jpr@uab.edu: Jpr@uab.edu moved page Cheaha Quick Start to Cheaha Quick Start (Deprecated) without leaving a redirect: Deprecated content for SGE cluster

2016-10-11T15:08:37Z

Jpr@uab.edu moved page Cheaha Quick Start to Cheaha Quick Start (Deprecated) without leaving a redirect: Deprecated content for SGE cluster

← Older revision	Revision as of 15:08, 11 October 2016
(No difference)

Pavgi@uab.edu: added note that page is under development

2013-04-09T16:56:30Z

added note that page is under development

← Older revision		Revision as of 16:56, 9 April 2013
Line 1:		Line 1:
			'''NOTE: This page is still under development. Please refer to [[Cheaha_GettingStarted]] page for detailed documentation.'''

	Cheaha is a shared cluster computing environment for UAB researchers. Cheaha offers total 8.75 TFLOPS compute power, 200 TB high-performance storage and 2.8 TB memory. See [[Cheaha_Quick_Start_Hardware]] for more details on compute platform, but first let's get started with an example and see how easy it is to use.		Cheaha is a shared cluster computing environment for UAB researchers. Cheaha offers total 8.75 TFLOPS compute power, 200 TB high-performance storage and 2.8 TB memory. See [[Cheaha_Quick_Start_Hardware]] for more details on compute platform, but first let's get started with an example and see how easy it is to use.

Mhanby@uab.edu: updated the job script with additional comments

2013-04-04T20:38:25Z

updated the job script with additional comments

← Older revision		Revision as of 20:38, 4 April 2013
Line 19:		Line 19:
	#		#
	# Define the shell used by your compute job		# Define the shell used by your compute job
	#
	#$ -S /bin/bash		#$ -S /bin/bash
	#		#
	# ~~Tell the cluster to run~~ in the current directory from where you submit the job		# Run in the current directory from where you submit the job
	#
	#$ -cwd		#$ -cwd
	#		#
	# ~~Tell~~ the ~~scheduler only need~~ 10 minutes		# Set the maximum runtime for the job (ex: 10 minutes)
			#$ -l h_rt=00:10:00
			# Set the maximum amount of RAM needed per slot (ex: 512 MB's)
			#$ -l vf=512M
	#		#
	#$ -~~l h_rt=00:01:00,s_rt=0:00:55,vf=512M~~		# Your email address
			#$ -M YOUR_EMAIL_ADDRESS
	#		#
	# ~~Set your email address and request notification~~ when ~~you~~ job is ~~complete~~ or ~~if it fails~~		# Notification Options:
	#		# b Mail is sent at the beginning of the job
	#~~$ -M YOUR_EMAIL_ADDRESS~~		# e Mail is sent at the end of the job
			# a Mail is sent when the job is aborted or rescheduled
			# s Mail is sent when the job is suspended
			# n No mail is sent
	#$ -m eas		#$ -m eas
	#		#
	# ~~Tell the scheduler to use~~ the environment from your current shell		# Use the environment from your current shell
	#		#
	#$ -V		#$ -V

Mhanby@uab.edu: updated link to https://docs.uabgrid.uab.edu/wiki/Cheaha_GettingStarted#Login to make it intra wiki

2013-04-02T18:25:00Z

updated link to https://docs.uabgrid.uab.edu/wiki/Cheaha_GettingStarted#Login to make it intra wiki

← Older revision		Revision as of 18:25, 2 April 2013
Line 4:		Line 4:

	== Logging In ==		== Logging In ==
	More [[~~http://docs.uabgrid.uab.edu/wiki/~~Cheaha_GettingStarted#Login\|detailed login instructions]] are also available.		More [[Cheaha_GettingStarted#Login\|detailed login instructions]] are also available.

	Most users will authenticate to Cheaha using their BlazerID and associated password using an SSH (Secure Shell) client. The basic syntax is as follows:		Most users will authenticate to Cheaha using their BlazerID and associated password using an SSH (Secure Shell) client. The basic syntax is as follows:

Mhanby@uab.edu: Added new section "Logging In"

2013-04-02T18:23:08Z

Added new section "Logging In"

← Older revision		Revision as of 18:23, 2 April 2013
Line 2:		Line 2:

	If you have any questions about Cheaha usage then please contact Research Computing team at support@vo.uabgrid.uab.edu .		If you have any questions about Cheaha usage then please contact Research Computing team at support@vo.uabgrid.uab.edu .

			== Logging In ==
			More [[http://docs.uabgrid.uab.edu/wiki/Cheaha_GettingStarted#Login\|detailed login instructions]] are also available.

			Most users will authenticate to Cheaha using their BlazerID and associated password using an SSH (Secure Shell) client. The basic syntax is as follows:

			<pre>
			ssh BLAZERID@cheaha.uabgrid.uab.edu
			</pre>

	== Hello Cheaha! ==		== Hello Cheaha! ==

Pavgi@uab.edu: /* Support */ Added about research computing teaxt.

2013-04-01T21:33:08Z

Support: Added about research computing teaxt.

← Older revision		Revision as of 21:33, 1 April 2013
Line 73:		Line 73:

	== Support ==		== Support ==
	If you have any questions about our documentation or need any help with Cheaha then please contact us on support@vo.uabgrid.uab.edu .		If you have any questions about our documentation or need any help with Cheaha then please contact us on support@vo.uabgrid.uab.edu . Cheaha is maintained by [[About_Research_Computing\|UAB IT's Research Computing team]].

Pavgi@uab.edu: Added more sections

2013-04-01T21:30:13Z

Added more sections

@@ Line 1: / Line 1: @@
-Cheaha is a shared cluster computing environment for UAB researchers. A shared cluster environment uses a job scheduler to run tasks on the cluster to provide optimal resource sharing among users. Cheaha uses a job scheduling system call SGE to schedule and manage jobs. A user needs to tell SGE about resource requirements (e.g. CPU, memory) so that it can schedule jobs effectively. These resource requirements along with actual application code can be specified in a single file commonly referred as 'Job Script/File'. Following is a simple job script that prints job number and hostname.
+If you have any questions about Cheaha usage then please contact Research Computing team at support@vo.uabgrid.uab.edu .
 <pre>
@@ Line 30: / Line 34: @@
 </pre>
-Lines starting with '#$' have a special meaning in the SGE world. SGE specific configuration options are specified after the '#$' characters. SGE offers many configuration options but above mentioned options should be useful for basic job scripts. A job script is submitted to the cluster using SGE specific commands. There are many commands available, but following three commands are the most common:
+Lines starting with '#$' have a special meaning in the SGE world. SGE specific configuration options are specified after the '#$' characters. Above configuration options are useful for most job scripts and for additional configuration options refer to SGE commands manual. A job script is submitted to the cluster using SGE specific commands. There are many commands available, but following three commands are the most common:
 * qsub - to submit job
 * qdel - to delete job
@@ Line 41: / Line 45: @@
 </pre>
-When the job script is submitted, SGE queues it up and assigns it a job number (e.g. 9043385 in above example). The job number is available inside job script using environment variable $JOB_ID. This variable can be used inside job script to create job related directory structure or file names.
+When the job script is submitted, SGE queues it up and assigns it a job number (e.g. 9043385 in above example). The job number is available inside job script using environment variable $JOB_ID. This variable can be used inside job script to create job related directory structure or file names. [[Cheaha_Quick_Start_Job_Script_Examples]] provides more job script examples and [[Cheaha_Quick_Start_SGE_Commands]] provides more information about SGE commands.

Pavgi@uab.edu at 19:49, 27 March 2013

2013-03-27T19:49:17Z

← Older revision		Revision as of 19:49, 27 March 2013
Line 38:		Line 38:
	<pre>		<pre>
	$ qsub HelloCheaha.sh		$ qsub HelloCheaha.sh
			Your job 9043385 (HelloCheaha.sh) has been submitted
	</pre>		</pre>

			When the job script is submitted, SGE queues it up and assigns it a job number (e.g. 9043385 in above example). The job number is available inside job script using environment variable $JOB_ID. This variable can be used inside job script to create job related directory structure or file names.

Pavgi@uab.edu at 19:40, 27 March 2013

2013-03-27T19:40:24Z

← Older revision		Revision as of 19:40, 27 March 2013
Line 1:		Line 1:

	Cheaha is a shared cluster computing environment for UAB researchers. A shared cluster environment uses a job scheduler to run tasks on the cluster to provide optimal resource sharing among users. Cheaha uses a job scheduling system call SGE to schedule and manage jobs. A user needs to tell SGE about resource requirements (e.g. CPU, memory) so that it can schedule jobs effectively. These resource requirements along with actual application code can be specified in a single file commonly referred as 'Job Script/File'.		Cheaha is a shared cluster computing environment for UAB researchers. A shared cluster environment uses a job scheduler to run tasks on the cluster to provide optimal resource sharing among users. Cheaha uses a job scheduling system call SGE to schedule and manage jobs. A user needs to tell SGE about resource requirements (e.g. CPU, memory) so that it can schedule jobs effectively. These resource requirements along with actual application code can be specified in a single file commonly referred as 'Job Script/File'. Following is a simple job script that prints job number and hostname.

	Following is a simple job script ~~to uncompress a tar.gz compressed file~~.

	<pre>		<pre>
Line 17:		Line 15:
	# Tell the scheduler only need 10 minutes		# Tell the scheduler only need 10 minutes
	#		#
	#$ -l h_rt=00:10:00,s_rt=0:09:50,vf=512M		#$ -l h_rt=00:01:00,s_rt=0:00:55,vf=512M
	#		#
	# Set your email address and request notification when you job is complete or if it fails		# Set your email address and request notification when you job is complete or if it fails
Line 28:		Line 26:
	#$ -V		#$ -V

	~~tar xzf sample.tar.gz~~		echo "The job $JOB_ID is running on $HOSTNAME"

	</pre>		</pre>

	SGE ~~scheduler provides commands~~ to ~~manage jobs and view~~ cluster ~~status~~. There are many commands available, but following three commands are the most common:		Lines starting with '#$' have a special meaning in the SGE world. SGE specific configuration options are specified after the '#$' characters. SGE offers many configuration options but above mentioned options should be useful for basic job scripts. A job script is submitted to the cluster using SGE specific commands. There are many commands available, but following three commands are the most common:
	* qsub - to submit job		* qsub - to submit job
	* qdel - to delete job		* qdel - to delete job
	* qstat - to view job status		* qstat - to view job status

			We can submit above job script using qsub command:
			<pre>
			$ qsub HelloCheaha.sh
			</pre>