Hoffman2 App
Hoffman2 on iPhone, iPod, iPad Instructions
Contents
Submit Job Tab
- How to submit your job?
- How to submit an application installed on Hoffman2 such as Matlab, NWChem, Qchem, Gaussian, etc?
Job Status Tab
- How to check job status?
- How to view job output?
- How to email (save) job output?
- How to check job status details?
- How to delete the job record?
Home Tab
- How to create a new directory on Hoffman2 Cluster?
- How to download a file from Hoffman2 Cluster to iPhone?
- How to delete a Hoffman2 Cluster file or empty directory?
- How to change directories?
Upload Tab
- How to upload a local iPhone file to the Hoffman2 Cluster?
- How to view the contents of a local iPhone file?
How to transfer a file between your laptop or PC and your iPhone, iPad or iPod
Getting started
You can download the Hoffman2 app free from iTunes with the App Store (icon) on your iPhone, iPod touch or iPad, or click this link in email that has been sent to your mobile device:
itms://itunes.apple.com/us/app/hoffman2/id380521367?mt=8
You must have a Hoffman2 account and a Grid user name and passphrase in order to use the Hoffman2 app. Using the Hoffman2 app requires iOS 3.1.2 or later on your mobile device.
Launch the Hoffman2 app.
Enter your Grid user name and passphrase in the Login window, and click the Login button. This is the same grid user name and passphrase that you use when you login at UCLA Grid or UC Grid.
The Submit Job window will appear. To logout, click the Logout button in the upper-right corner on the Submit Job window.
How to submit your job?
Step 1: Click the Submit Job tab at the bottom of the widow to see the Submit Job window.
Step 2: Click the blue arrow button at the right of the Executable field. A list of the files in your Hoffman2 Cluster home directory will appear.
Step 3: Select the executable that you want to run (hello.sh in this example). Click the Select button in the upper-right corner.
Step 4: (Optional) If you need change the Job Type or Save the job for later submission, you can scroll down to see those options.
The Save button saves the values you entered in MyApps. To recall and use what you saved, on the Submit Job screen click the Apps button in the upper-left corner, then in the Apps window click the My Apps button in the upper-left corner.
If you need to enter or change the values for Arguments, Directory, Environment, Stdin, Num of Core, Max Memory, Max Time or Queue Name, you can use the keyboard below. Clicking the 123 keyboard button changes the keyboard to numeric keys and symbols.
Step 5: Click the Submit button to submit the job to Hoffman2. Scroll up or down if a Submit button is not visible. After your job completes, you can view its output from the Job Status window.
How to submit an application installed on Hoffman2 such as Matlab, NWChem, Qchem, Gaussian, etc?
Step 1: Click the Submit Job tab at the bottom of the widow to see the Submit Job window. Click the Apps button in the upper-left corner.
Step 2: The following menu appears. Select the application (Matlab in this example) and click the Load button in the upper-right corner.
Step 3: The following window appears, with the Executable and Arguments fields already filled in.
Step 4: Enter the input file name. This is the file which contains the application commands that you wrote. It must already exist on the Hoffman2 Cluster. If it is located in your home directory, you do not have to enter anything in the Directory field. If it is located in a subdirectory of your home directory, also enter the subdirectory name in the Directory field.
Step 5: Click the Submit button to submit the job to Hoffman2. Scroll up or down if a Submit button is not visible. After your job completes, you can view its output from the Job Status window.
How to check job status?
Click the Job Status tab at the bottom of the window to see the Job Status window. Click the Refresh button in the upper-right corner to update the status of your jobs.
The upper section of the Job Status window shows Job submitted from this device and will let you view your job output. The lower section of the Job Status window shows All your cluster jobs (qstat) and will let you view job status details of pending or running jobs.
How to view job output?
Click the Job Status tab at the bottom of the window to see the Job Status window. The upper section, Job submitted from this device, contains records for jobs submitted from your mobile device.
You cannot view job output of jobs submitted from UCLA Grid or the Hoffman2 Cluster login nodes from the Job Status window. You can, however, download a Hoffman2 Cluster file which contains job output to your iPhone and view that local iPhone file.
In the upper section of the Job Status window, click the blue arrow at the right of a job whose status is DONE.
A window will open which displays your job output. If you want to save the output of a job submitted from your mobile device, you need to email the output file.
How to email (save) job output?
Click the Job Status tab at the bottom of the window to see the Job Status window. In the upper section of the Job Status window, click the blue arrow at the right of a job whose status is DONE. Click the Email button in the upper-right corner after viewing the job output.
Fill in the To: address and click the Send button in the upper-right corner.
How to check job status details?
Click the Job Status tab at the bottom of the window to see the Job Status window. The lower section, All your cluster jobs (qstat), contains the status information for all pending or running Hoffman2 jobs submitted from anywhere, including the Hoffman2 login nodes, UCLA Grid and your mobile device. Basically we show the output from the qstat -u userid or myjobs command for your Hoffman2 userid.
Click the blue arrow at the right of a job record in the lower section. This will display the job details from qstat -j jobid for that job.
How to delete the job record?
Click the Job Status tab at the bottom of the window to see the Job Status window.
Swipe your finger to the right of the job record you want to delete. A red Delete button will appear. Click the Delete button.
How to create a new directory on Hoffman2 Cluster?
You might want to create a new directory on the Hoffman2 if your program will write its output there. Click the Home tab at the bottom of the window to see the Home window. Click on the New Directory button in the upper-right corner.
Enter the directory name to create the directory in current directory (a123 in this example). Click the Create button in the upper-right corner.
How to download a file from Hoffman2 Cluster to iPhone?
You might want to download a text file, for example an input file for Matlab, or a job script, so that you can view it on your mobile device before you submit it as a job. Or you might want to view an output file from a job that you submitted from a Hoffman2 Cluster login node or UCLA Grid.
Click the Home tab at the bottom of the window to see the Home window. Click the black down-arrow at the right of a file name. The file will be saved locally on your iPhone and will be listed under the Upload tab. Note that you can download only single files. Download of Hoffman2 Cluster directories is not available.
How to delete a Hoffman2 Cluster file or empty directory?
Click the Home tab at the bottom of the window to see the Home window. Swipe your finger to the right on the file or directory that you want to delete. A red Delete button will appear. Click the Delete button.
Notice that you can not delete a non-empty directory because it uses an FTP sort of client. Only single files or empty directories can be deleted.
How to change directories?
Click the Home tab at the bottom of the window to see the Home window. Click on the directory to change into that directory. The name of the directory (AAA in this example) will appear at the top of the window in place of the word Home.
How to upload a local iPhone file to the Hoffman2 Cluster?
Click the Upload tab at the bottom of the window to see the Upload window. Select the file and click the Upload button in the upper-right corner. The file will always be stored in your Hoffman2 home directory.
Click the OK button that appears after the file transfer completes.
How to view the contents of a local iPhone file?
Click the Upload tab at the bottom of the window to see the Upload window. Click the blue arrow button at the right of the file name.
The file contents will be displayed if the file type is supported by your mobile device. To return to the Upload window, click the Done button in the upper-left corner
How to transfer files between your laptop or PC and your iPhone, iPad or iPod
In order to submit an input file as a job, the file must exist in your Hoffman2 home directory or its subdirectories or elsewhere on the Hoffman2 Cluster. If you have your file on your laptop or PC you can either scp or sftp it to the Hoffman2 Cluster. Or you can use the iTunes application, which you have installed on your laptop, to copy the laptop file to your mobile device, and then upload it to your Hoffman2 Cluster home directory.
To copy a file from your laptop to your mobile device, you need to open iTunes on your laptop, go to the Apps tab, and select the Hoffman2 app. Drag any file to the right side of the window under File Sharing.
A file transferred from your laptop to your mobile device will be listed on your mobile device under the Hoffman2 app Upload tab. You can upload it to your Hoffman2 Cluster home directory.
August 24, 2010
home
Disability Resources