Home

Software User Manual - Information Systems

1. does not exist Related operations remove 4 1 5 add user Functional description This operation adds an user to the SPINGRID system SPINGRID Software User Manual 0 1 0 16 CHAPTER 4 REFERENCE 20 Formal description e Syntax as rol lt rolename gt add user lt username gt lt password gt e Parameters lt rolename gt Required This parameter is the name of role that you have This 245 can either be sysadmin or projadmin lt username gt Required This parameter is the name of the user that is added Spaces are not allowed lt password gt Required This parameter is the password of the user that is added Spaces are not allowed 20 Examples e as rol sysadmin add user Henk kneH e as rol projadmin add user Piet teiP Possible errors e You do not have the role project admin 255 e You do not have the role system admin e An user with username lt username gt already exists Related operations remove 4 1 6 allow private Functional description This operation allows an user to use private applications or datasets 20 in a project Formal description e Syntax allow private lt appsordata gt for usr lt username gt in pro lt projectname gt e Parameters 265 lt appsordata gt Required This parameter can be apps to allow the user to use private applications or data to allow the user to use private datasets lt username gt Required Thi
2. SPINGRID system Examples e remove pro MedicalResearch e remove usr Henk 50 Possible errors e You do not have the role project admin e You do not have the role system admin e User lt username gt does not exist e User lt username gt is the last project admin of project lt projectname gt You cannot 595 remove this user e User lt username gt does not have the role project admin in project lt projectname gt Related operations 4 1 18 trust Functional description This operation lets an user trust an application dataset or user so for a project Formal description e Syntax trust app lt applicationname gt lt datasetname gt lt username gt as rol lt rolename gt for lt projectname gt 605 e Parameters lt applicationname gt Required when chosen This parameter is the name of the application that is trusted lt datasetname gt Required when chosen This parameter is the name of the dataset that is trusted 610 lt username gt Required when chosen This parameter is the name of the user that is trusted SPINGRID Software User Manual 0 1 0 29 615 620 625 630 635 CHAPTER 4 REFERENCE lt rolename gt Required when chosen This parameter is the name of the role of the user that is trusted lt projectname gt Required when chosen This parameter is the name of the project where the user is trusted in This parameter is requir
3. The format is hhmmss Examples e add interval tim 140000 to tim tim 180000 Possible errors None Related operations remove interval 4 2 2 exit Functional description This operation exits the agent application Formal description e Syntax exit Examples e exit Possible errors None Related operations None 4 2 3 help Functional description This operation returns information of a command SPINGRID Software User Manual 0 1 0 32 690 695 700 705 710 CHAPTER 4 REFERENCE Formal description e Syntax list help lt command gt e Parameters lt command gt Required This parameter is name of the command where infor mation of is returned Examples e help add interval Possible errors None Related operations None 4 2 4 list projects Functional description This operation returns a list of all projects in the SPINGRID system Formal description e Syntax list projects Examples e list projects Possible errors None Related operations None 4 2 5 remove interval Functional description This operations removes an interval when the resource can be used to execute jobs SPINGRID Software User Manual 0 1 0 33 715 720 725 730 CHAPTER 4 REFERENCE Formal description e Syntax remove interval tim lt timel gt to tim lt time2 gt e Parameters lt timel gt Required This parameter is the first parameter of the interval that is
4. e as rol datprov list projects SPINGRID Software User Manual 0 1 0 26 CHAPTER 4 REFERENCE Possible errors e You do not have the role project admin 530 e You do not have the role system admin e You do not have the role job provider e You do not have the role application provider e You do not have the role data provider Related operations sss 4 1 15 list users Functional description This operation returns a list of users having a specific role in a specific project Formal description e Syntax as rol lt rolenamel gt list users having rol lt rolename2 gt in pro lt projectname gt 540 e Parameters lt rolenamel gt Required This parameter is the name of the role you have This parameter can only be projadmin or sysadmin lt rolename gt Required This parameter is the name of the role the users have 545 in the returned list lt projectname gt Optional This parameter is the name of the project which the users in the returned list are in Examples e as rol sysadmin list users having rol datprov 550 e as rol projadmin list users having rol jobprov in pro MedicalResearch Possible errors e You do not have any of the following roles project admin system admin e You do not have the role project admin e You do not have the role system admin 555 e Project lt projectname gt does not exist SPINGRID Software User Manual 0 1 0 27 560 565 570 5
5. is detected and the instructions on screen can be followed to install the plug in 4 Create a new project from the source In Eclipse click File New and then Project Choose Java Project from the list and click Next In the project name field enter Dispatcher SPINGRID Software User Manual 0 1 0 9 70 75 80 85 90 95 100 CHAPTER 3 TUTORIAL select Create new project from existing source and choose the root directory where the source files of the dispatcher are located Click Finish to complete the process 5 Import the mysql library Select the newly created project in the package explorer choose Project and then Properties from the menu Choose Java Build Path on the left and select the tab Libraries Click the button Add External JARs and select mysql connector java T x cr bin jar in the archive you downloaded Next click on the tab Order and Export and check the imported jar Click OK to close the window 6 Build the project Click with the right mouse button on the project in the Package Explorer and select Build Fat Jar In the dialog box that appears choose a jar name e g Dispatcher select the main class Dispatcher java and start the building process by clicking Finish The process is analogous for the client and agent except for the steps including MySQL and Fat Jar which can be skipped Instead these applications can be build by choosing Export instead of Build Fat Jar from the dropdown menu in t
6. 75 580 CHAPTER 4 REFERENCE Related operations None 4 1 16 passwd Functional description This operation changes your password Formal description e Syntax passwd lt password gt e Parameters lt password gt Required This is the new password where the old password is changed into Spaces are not allowed Examples e passwd teiP Possible errors None Related operations None 4 1 17 remove Functional description This operation removes an application a dataset a project a job or an user from the SPINGRID system Formal description e Syntax remove app lt applicationname gt dat lt datasetname gt pro lt projectname gt job lt jobname gt usr lt username gt e Parameters lt applicationname gt Required when chosen This parameter is the name of the application that is removed from the SPINGRID system lt datasetname gt Required when chosen This parameter is the name of the dataset that is removed from the SPINGRID system lt projectname gt Required when chosen This parameter is the name of the project that is removed from the SPINGRID system SPINGRID Software User Manual 0 1 0 28 CHAPTER 4 REFERENCE lt jobname gt Required when chosen This parameter is the name of the job that is removed from the SPINGRID system 585 lt username gt Required when chosen This parameter is the name of the user that is removed from the
7. DIX B GLOSSARY SPINGRID A computational grid using SPINGRID software SPINGRID Software Software developed by Dutch Space and TU e to build computational grids for distributed data processing SPINGRID System The full name of the entire system System Administrator The system administrator oversees the entire SPINGRID system and has the right to configure the system to create and remove projects and assign and remove project administrators SPINGRID Software User Manual 0 1 0 37 Index agent add interval 31 exit 32 745 help 32 list projects 33 remove interval 33 client add app 13 750 add data 14 add job 15 add project 16 add user 16 allow private 17 755 assign 18 disallow private 19 distrust 20 info 21 list apps 22 760 list data 23 list jobs 25 list projects 26 list users 27 passwd 28 765 remove 28 trust 29 unassign 30 dispatcher exit 34 SPINGRID Software User Manual 0 1 0
8. Software Engineering Project 21P40 Project Group 1 Software User Manual version 0 1 0 Internally Accepted 14 June 2006 Project Team Sven Bego 0550191 Roel Coset 0548132 Robert Leeuwestein 0546746 Maarten Leijten 0547649 Ivo van der Linden 0547632 Joery Mens 0547515 Marcel Moreaux 0499480 Tim Muller 0547961 Project Manager Tom Kleijkers 0515015 Senior Manager L Somers TU e HG 7 83 Advisor Y Usenko TU e HG 5 71 Customer C Plevier Dutch Space H de Wolf Dutch Space Technische Informatica Eindhoven University of Technology Eindhoven Abstract This document is the Software User Manual SUM for the SPINGRID project and was made according to the software engineering standard described in ESA provided by European Space Agency ESA The Software User Manual SUM instructs how to install and use the SPINGRID software This project is part of the Software Engineering Project course 21P40 at the Technische Universiteit Eindhoven TU e SPINGRID Software User Manual 0 1 0 1 Contents 1 Introduction 6 1 1 Intended readership ct ral a Eee he a 2D 6 12 ZApppligability 4 8 2 a og Gene A ke ee A Wd ie 6 1 35 Purpose ea A ee a a eee a Ee eee Bite dd 6 1 4 How to use this document 6 1 5 Related documents ani dopey see a oe ge eS 7 1 6 Conventions a ur sue soan Ba ee ee eo E Aa a 7 Lr Problem reporting wet pr A e OEE ORO ae DDAR TEE edi eres 7 2 Overview 8 3 Tutorial 9 3 1 Inst
9. ains URL s which point to the files that are added An URL must point to a file lt datasetname gt Required This parameter is the name of the dataset that is added It must be unique Spaces are not allowed lt description gt Required This parameter is the description of the dataset that is added Examples e add data fil URLs txt as Football This is a football dataset e add data url http www medicalresearch com datal dat url http www medicalresearch com data2 dat as MedicalResearch This is a medical research dataset SPINGRID Software User Manual 0 1 0 14 190 195 200 205 210 215 CHAPTER 4 REFERENCE Possible errors e You do not have the role data provider e A dataset with name lt dataname gt already exists Related operations remove 4 1 3 add job Functional description This operation adds a job to the SPINGRID system Formal description e Syntax add job fil lt filename gt to pro lt projectname gt e Parameters lt filename gt Required This parameter is the name of the file that describes the job This must be a JSDL file lt projectname gt Required This parameter is the name of the project where the job is added Examples e add job fil sumcalculation jsdl to pro MedicalResearch Possible errors Project lt projectname gt does not exist e You do not have the role job provider in project lt projectname gt A job with name l
10. al This parameter is the name of the project where the user as the role is removed from This parameter is only necessary when removing the role project admin or job provider from an user Examples e unassign rol datprov from usr Henk e unassign rol projadmin from usr Piet in pro MedicalResearch Possible errors e You do not have the role system admin e User lt username gt does not exist Project lt projectname gt does not exist e You do not have the role of project admin in project lt projectname gt e User lt username gt does not have the role of application provider User lt username gt does not have the role of data provider U ser lt username gt does not have the role of job provider in project lt projectname gt e User lt username gt does not have the role of project admin in project lt projectname gt Related operations assign 4 2 Agent operations 4 2 1 add interval Functional description This operation adds an interval when the resource can be used to execute jobs SPINGRID Software User Manual 0 1 0 31 665 670 675 680 685 CHAPTER 4 REFERENCE Formal description e Syntax add interval tim lt timel gt to tim lt time2 gt e Parameters lt timel gt Required This parameter is the first parameter of the interval that is added The format is hhmmss lt time2 gt Required This parameter is the second parameter of the interval that is added
11. alling the software ee 3 1 1 Building the software a 9 3 1 2 Installation ia a al Ee ia ed 10 3 2 Uninstalling the software oaoa 11 3 3 A quick start with the client ooa 11 3 4 A quick start with the agemtb e 12 3 5 A quick start with the dispatcher a 12 4 Reference 13 4 1 Client operations 2 sos nun ah ar ke Re ER ae ba Wa 13 ALLE Add ap prt vera ee ane hee Ee anes Ie oe We he Sl a oke 13 AA 2 add data osani eiea fox Bee A hee Qi a 14 ALS Add OD par Bee ht A AO A ee a nd id 15 AVA add projectiyic 5 in ever a a RR Bee RS a pS 16 SPINGRID Software User Manual 0 1 0 2 CONTENTS Aioria 16 A126 allow privates iu A Rett a a ee a ed 17 ANT CASI ey eek ath Ban A a ce Eye Bea ele ee See Berns 18 4 1 8 disallow private eee 19 419 COISTTUSO ui AA ae rl A AAA e de 20 AO LO Andere e ar a Ae A ot NN ek 21 AAE USADOS tss che Bene BA Ee SE AE br ed Arend 22 ATD sidad diene il panelen eta ee es Pe Bede Aln rie el 23 43e list JODS a ee BE ee SY bare EA AE a RER B 25 4 1 14 Vist projects ie venae ae ata eee eae a eo We Gil a 26 NED 5 ve lex an oe ho Bee nlp et a ecw hw Rit a 27 ALO Pass da ht A ROM A ee it ae ke 28 AUT removes BS ak A Soe yO Ph aed ee AA A ge o i 28 ALAS AUS ici ee Re A ate ee ee ee 29 AAV VUNASSIOT ee venen e Bee det te Sor ce Ae eS Ge eee Be 30 4 2 Agent operatlons sua Door h d Rasa eee de pie bo h
12. dd 31 421 add interval zee on ea a Se a a ee 31 ADD VOX tho et Bhs E A NT ph UN tiel Nel A LY 32 423 Help a var eet A a WR Sco A te NG 32 AZA list projects we haa aha Sk ee EE A ee 33 ADO remove interval es os Ape A BOE EE ESSE eS REO 33 4 3 Dispatcher operations eee 34 ALO SOX 3 3 5 ol o bh ee AG eee Se ds 34 A Error messages and recovery procedures 35 B Glossary 36 SPINGRID Software User Manual 0 1 0 3 Document Status Sheet Document Title Software Transfer Document Document Identification SPINGRID Documents product SUM 0 1 0 Author s S Bego R Leeuwestein Version 0 1 0 Document Status draft internally accepted conditionally approved approved Version Date Author s Summary 0 0 1 22 05 2006 R Leeuwestein Document creation 0 0 2 12 06 2006 S Bego R Leeuwestein Version for internal review 0 1 0 14 06 2006 R Leeuwestein Internal approved SPINGRID Software User Manual 0 1 0 Document Change Report Document Title Software Transfer Document Document Identification SPINGRID Documents product SUM 0 1 0 Date of Changes N A SPINGRID Software User Manual 0 1 0 20 25 Chapter 1 Introduction 1 1 Intended readership This document covers the use for the following users of the SPINGRID system the system administrator the project administrators the job providers e the application prov
13. ded If a project is given it returns all applications that you have trusted in the specific project aso Formal description e Syntax as rol lt rolename gt list data in pro lt projectname gt e Parameters lt rolename gt Required This parameter is the name of the role you have This 455 can either be projadmin sysadmin jobprov or datprov lt projectname gt Optional This parameter is the name of the project See the functional description of this operation for more information Examples e as rol datprov list data 460 e as rol sysadmin list data in pro MedicalResearch Possible errors e You do not have the role project admin e You do not have the role system admin e You do not have the role job provider 465 e You do not have the role data provider e Project lt projectname gt does not exist e You do not have the role project admin in project lt projectname gt e You do not have the role job provider in project lt projectname gt Related operations list apps SPINGRID Software User Manual 0 1 0 24 470 475 480 485 490 495 500 CHAPTER 4 REFERENCE 4 1 13 list jobs Functional description This operation returns a list of jobs This operation can be exe cuted either as a project admin a system admin a job provider an application provider or as an data provider Project admin As a project admin it returns a list of all jobs in y
14. ed when trusting an application or data provider Examples Possible errors User lt username gt does not exist User lt username gt is already a job provider in project lt projectname gt Project lt projectname gt does not exist You do not have the role application provider You do not have the role data provider You do not have the role project admin in project lt projectname gt DataSet lt datasetname gt does not exist Application lt applicationname gt does not exist DataSet lt datasetname gt is not yours Application lt applicationname gt is not yours You as application provider already allowed project lt projectname gt to use your appli cation lt applicationname gt You as data provider already allowed project lt projectname gt to use your dataset lt datasetname gt Project lt projectname gt does not exist Related operations distrust 4 1 19 unassign Functional description This operation removes a role from an user SPINGRID Software User Manual 0 1 0 30 645 650 655 660 CHAPTER 4 REFERENCE Formal description e Syntax unassign rol lt rolename gt from usr lt username gt in pro lt projectname gt e Parameters lt rolename gt Required This parameter is the name of role that is removed from the user lt username gt Required This parameter is the name of the user where the role is removed from lt projectname gt Option
15. er is the name of the user that is disallowed to use applications or datasets in the project lt projectname gt Required This parameter is the name of the project were the user is not trusted in Examples e disallow private apps for usr Henk in pro MedicalResearch e disallow private data for usr Henk in pro MedicalResearch SPINGRID Software User Manual 0 1 0 19 330 335 340 345 350 355 CHAPTER 4 REFERENCE Possible errors Project lt projectname gt does not exist e You do not have the role project admin in project lt projectname gt e User lt username gt does not exist e User lt username gt does not have the role JobProvider in project lt projectname gt e User lt username gt does not have the right to use his own applications for jobs in project lt projectname gt e User lt username gt does not have the right to use his own datasets for jobs in project lt projectname gt Related operations allow private 4 1 9 distrust Functional description This operation lets an user distrust an application dataset or user for a project Formal description e Syntax distrust app lt applicationname gt lt datasetname gt lt username gt as rol lt rolename gt for lt projectname gt e Parameters lt applicationname gt Required when chosen This parameter is the name of the application that is distrusted lt datasetname gt Required when ch
16. he package explorer The instructions on the screen can be followed to complete the normal build process 3 1 2 Installation After the source has been build the jar file created can be copied to any location and the programs are almost ready to be used Before the first start it is necessary to create a configuration file named options in the same directory as the jar file For the agent an additional properties file needs to be created In the next subsections you can find what to put in these configuration files Note that text between the symbols lt and gt is only comment of what needs to be put there The symbols lt and gt should not used in the files Client file options proxy_address lt the proxy address when used gt password lt your password gt http_port lt the port of the dispatcher to which to connect to this would normally be port 80 gt dispatcher_address lt the address of the dispatcher gt username lt your username in the system gt Agent file options proxy_address lt the proxy address when used gt SPINGRID Software User Manual 0 1 0 10 105 110 115 120 125 130 CHAPTER 3 TUTORIAL http_port lt the port of the dispatcher to which to connect to this would normally be port 80 gt proxy_port lt the port that used by the proxy gt dispatcher_address lt the address of the dispatcher gt agent_id lt this must be a unique identifier in the SPINGRID system gt file pro
17. iders e the data providers e the resource providers 1 2 Applicability This Software User Manual SUM applies to the SPINGRID software version 0 1 1 3 Purpose The purpose of the SUM is to assist the user in installing and using the SPINGRID software 1 4 How to use this document e Chapter 2 gives an overview of the SPINGRID software e Chapter 3 contains tutorials for common tasks that enable users to get started quickly e Chapter 4 gives a reference of the complete SPINGRID software SPINGRID Software User Manual 0 1 0 6 CHAPTER 1 INTRODUCTION e Appendix A includes a list of all error messages and recovery procedures 30 e Appendix B contains the glossary 1 5 Related documents ESA ESA Software Engineering Standards ESA PSS 05 0 Issue 2 ESA Board for Software Standardization and Control BSSC 1991 1 6 Conventions None 1 7 Problem reporting 35 Since the SPINGRID team will be dissolved after completion of the SPINGRID project the issue of problem reporting is left to Dutch Space SPINGRID Software User Manual 0 1 0 7 Chapter 2 Overview The software implements a computational grid This grid is able to execute jobs when it 4 receives an application accompanied by a set of data files By hiding the complexity of grid technology which makes the system easy to use SPINGRID Software User Manual 0 1 0 8 45 50 55 60 65 Chapter 3 Tutorial 3 1 Install
18. ing the software 3 1 1 Building the software Before the software applications can be used they need to be build from the source Below is explained how to perform this process for the dispatcher For the client and agent the process is analogous 1 Install Eclipse The easiest way to build the dispatcher from source is using Eclipse SDK Eclipse SDK is a development environment and is a open source project The latest version of this software can be obtained at http www eclipse org downloads After the download is completed install the software using the instructions provided by the installer Note that version 3 1 is used by the SPINGRID team A different version could give problems 2 Download the mysql driver for Java The dispatcher needs to communicate with a mysql database and depends on MySQL Connector J The source of this driver needs to be downloaded from http dev mysql com downloads connector j Note that version 3 1 is used by the SPINGRID team A different version could give problems 3 Import the Fat Jar Eclipse Plug in To include MySQL Connector J Eclipse needs a plug in After Eclipse is started click Help Software Updates and finally Find And Install Select Search for new features to install and click next Click New Remote Site and enter the following URL http kurucz grafika de fatjar Choose as name Fatjar and then click ok to add the URL Make sure only Fatjar is selected and click finish The Fat Jar plug in
19. jectname gt Optional This parameter is the name of the project where the user as the role is assigned to This parameter is only necessary when assigning the role project admin or job provider to an user Examples e assign rol appprov to usr Henk e assign rol jobprov to usr Piet in pro MedicalResearch SPINGRID Software User Manual 0 1 0 18 300 305 310 315 320 325 CHAPTER 4 REFERENCE Possible errors e You do not have the role system admin e User lt username gt does not exist Project lt projectname gt does not exist e You do not have the role of project admin in project lt projectname gt e User lt username gt is already an application provider User lt username gt is already a data provider U ser lt username gt is already a job provider in project lt projectname gt e User lt username gt is already a project admin of project lt projectname gt Related operations unassign 4 1 8 disallow private Functional description This operation disallows an user to use private applications or datasets in a project Formal description e Syntax disallow private lt appsordata gt for usr lt username gt in pro lt projectname gt e Parameters lt appsordata gt Required This parameter can be apps to disallow the user to use private applications or data to disallow the user to use private datasets lt username gt Required This paramet
20. me gt Project lt projectname gt does not exist Related operations trust 4 1 10 info Functional description This operation return information of an entity in the SPINGRID system Formal description Syntax info app lt applicationname gt dat lt datasetname gt job lt jobname gt pro lt projectname gt usr lt username gt Parameters lt applicationname gt Required when chosen This parameter is the name of the application from which the info is returned lt datasetname gt Required when chosen This parameter is the name of the dataset from which the info is returned lt jobname gt Required when chosen This parameter is the name of the job from which the info is returned SPINGRID Software User Manual 0 1 0 21 CHAPTER 4 REFERENCE lt projectname gt Required when chosen This parameter is the name of the project from which the info is returned 390 lt username gt Required when chosen This parameter is the name of the user from which the info is returned Examples e info pro MedicalResearch e info usr Henk 305 Possible errors e User lt username gt does not exist e Project lt projectname gt does not exist e DataSet lt datasetname gt does not exist e Application lt applicationname gt does not exist 400 e Job lt jobname gt does not exist Related operations None 4 1 11 list apps Functional description This operation ret
21. on 25 Examples e as rol appprov list apps e as rol sysadmin list apps in pro MedicalResearch Possible errors e You do not have the role project admin 430 e You do not have the role system admin e You do not have the role job provider e You do not have the role application provider e Project lt projectname gt does not exist e You do not have the role project admin in project lt projectname gt 435 e You do not have the role job provider in project lt projectname gt Related operations list data 4 1 12 list data Functional description This operation returns a list of datasets This operation can be executed either as a project admin a system admin a job provider or as an data provider 440 e Project admin As a project admin it returns a list of all datasets that can be used in one or more of your projects If a project is given it returns the datasets that can be used in that specific project e System admin As system admin it returns a list of all datasets in the system If a project is given it returns the datasets that can be used in that specific project SPINGRID Software User Manual 0 1 0 23 CHAPTER 4 REFERENCE 445 e Job provider As job provider it returns a list of all datasets that can be used in your jobs If a project is given it returns all datasets that can be used in your jobs in that specific project e Data provider As data provider it returns a list of the datasets you have provi
22. osen This parameter is the name of the dataset that is distrusted lt username gt Required when chosen This parameter is the name of the user that is distrusted lt rolename gt Required when chosen This parameter is the name of the role of the user that is distrusted lt projectname gt Required when chosen This parameter is the name of the project where the user is distrusted in This parameter is required when distrusting an application or data provider Examples e distrust app testapp for pro testproject e distrust usr Henk as rol appprov SPINGRID Software User Manual 0 1 0 20 360 365 370 375 380 385 CHAPTER 4 REFERENCE Possible errors User lt username gt does not exist User lt username gt does not have the role job provider in project lt projectname gt Project lt projectname gt does not exist You do not have the role application provider You do not have the role data provider You do not have the role project admin in project lt projectname gt DataSet lt datasetname gt does not exist Application lt applicationname gt does not exist DataSet lt datasetname gt is not yours Application lt applicationname gt is not yours You as application provider did not allow project lt projectname gt to use your applica tion lt applicationname gt You as data provider did not allow project lt projectname gt to use your dataset lt datasetna
23. our projects If a project is given it returns the jobs in that specific project System admin As system admin it returns a list of all jobs in the system If a project is given it returns the jobs in that specific project Job provider As job provider it returns a list of all your jobs If a project is given it returns all your jobs in that specific project Application provider As application provider it returns a list of the jobs that use an application that you have provided If a project is given it returns all jobs in the specific project that use an application that you have provided Data provider As data provider it returns a list of the jobs that use one or more datasets that you have provided If a project is given it returns all jobs in the specific project that use one or more datasets that you have provided Formal description Syntax as rol lt rolename gt list jobs in pro lt projectname gt Parameters lt rolename gt Required This parameter is the name of the role you have This can either be projadmin sysadmin jobprov appprov or datprov lt projectname gt Optional This parameter is the name of the project See the functional description of this operation for more information Examples as rol jobprov list jobs as rol sysadmin list jobs in pro MedicalResearch Possible errors e You do not have the role project admin e You do not have the role s
24. ource provider who uses the agent application Computational Grid A hardware and software infrastructure that enables coordinated resource sharing within dynamic organizations consisting of individuals institutions and resources Customer Dutch Space B V Data Provider A data provider can offer a set of datafiles to the SPINGRID system They can restrict access for projects and for resource providers to their datafiles Dispatcher A dispatcher acts like a server and manages the distribution of jobs over the computational grid Job Specification of application configuration data input and or output data files and scheduler specific data priority preferred resource etc Job Provider Job providers are users that offer a job to a project They have to be a member of that particular project Project A collection of jobs with specified access rights to which users project members can be assigned Project Administrator The project administrators administrate projects and can assign and re move job providers configure a project and restrict access for resource providers Resource Provider Resource providers are users that offer time on their computers to the SPINGRID system They can restrict access to their computer for appli cation providers and projects Role The actions and activities assigned to a person SPINGRID Software User Manual 0 1 0 36 APPEN
25. perties FileSystem_NORMAL_MountPoint lt working directory for the agent gt FileSystem NORMAL_Capacity lt available space in the working directory given in bytes gt FileSystem_TMP_MountPoint lt temporary directory for the agent gt FileSystem TMP Capacity lt available space in the temporary directory given in bytes gt ExclusiveExecution lt this may be true or false but has no effect gt OperatingSystem_Name lt operating system on which the agent is running e g Windows_XP gt OperatingSystem_Version lt version of the operating system e g SP2 gt CPUArchitecture lt architecture on which the agent is running e g x86 gt CPUSpeed lt cpu speed in hertz gt CPUCount lt total amount of available cpus gt NetworkBandwidth lt total amount of available bandwidth given in bits per second gt PhysicalMemory lt total amount of available physical memory given in bytes gt VirtualMemory lt total amount of available virtual memory given in bytes gt Dispatcher file options database name lt name of the user that has full privileges over the database gt database_pass lt password of the user gt database_address lt address to the database e g jdbc mysql pcewin509 softeng tue nl spingrid gt http_port lt port on which HTTP runs gt max_connections lt maximum number of simultaneous connections allowed gt 3 2 Uninstalling the software All the applications can be easily uninstalled by removing the jar files 3 3 A quick star
26. removed The format is hhmmss lt time2 gt Required This parameter is the second parameter of the interval that is removed The format is hhmmss Examples e remove interval tim 140000 to tim tim 180000 Possible errors None Related operations add interval 4 3 Dispatcher operations 4 3 1 exit Functional description This operation exits the dispatcher The dispatcher stops running after calling the operation Formal description e Syntax exit Examples e exit Possible errors None Related operations None SPINGRID Software User Manual 0 1 0 34 Appendix A Error messages and recovery procedures All error messages can be found in chapter 4 There are no recovery procedures if an error occurs If the application crashes then the program should be restarted as described in chapter 3 SPINGRID Software User Manual 0 1 0 35 Appendix B Glossary Agent Application that is used by a resource provider to retrieve and execute jobs Application A non interactive data processing application consisting of executables scripts and or auxiliary data files that reads one or more input data files and writes one ore more output files Application Provider An application provider can offer a set of applications to the SPINGRID system They can restrict access for projects and for resource providers to their applications Client Application that is used by all the users except the res
27. s 4 1 1 add app Functional description This operation adds an application to the SPINGRID system Formal description e Syntax add app fil lt filename gt as lt applicationname gt lt description gt 155 e Parameters lt filename gt Required This parameter is the name of file that is added as an application lt applicationname gt Required This parameter is the name of the application 160 that is added It must be unique Spaces are not allowed lt description gt Required This parameter is the description of the application that is added SPINGRID Software User Manual 0 1 0 13 165 170 175 180 185 CHAPTER 4 REFERENCE Examples e add app fil lt testapp xml gt as testapp this is a test application Possible errors e You do not have the role application provider e An application with name lt applicationname gt already exists Related operations remove 4 1 2 add data Functional description This operation adds a dataset to the SPINGRID system Formal description e Syntax add data url lt url gt fil lt filename gt as lt datasetname gt lt description gt e Parameters lt url gt Required when chosen This parameter is the URL of a file that is added Note that more URL s are allowed in the syntax see the examples An URL must point to a file lt filename gt Required when chosen This parameter is the name of file that cont
28. s parameter is the name of the user that is allowed to use applications or datasets in the project lt projectname gt Required This parameter is the name of the project were the 270 user is trusted in SPINGRID Software User Manual 0 1 0 17 275 280 285 290 295 CHAPTER 4 REFERENCE Examples e allow private apps for usr Henk in pro MedicalResearch e allow private data for usr Henk in pro MedicalResearch Possible errors Project lt projectname gt does not exist e You do not have the role project admin in project lt projectname gt e User lt username gt does not exist User lt username gt does not have the role JobProvider in project lt projectname gt e You as project admin of project lt projectname gt already allowed lt username gt to use his own applications for jobs in that project e You as project admin of project lt projectname gt already allowed lt username gt to use his own datasets for jobs in that project Related operations disallow private 4 1 7 assign Functional description This operation assigns a role to an user Formal description e Syntax assign rol lt rolename gt to usr lt username gt in pro lt projectname gt e Parameters lt rolename gt Required This parameter is the name of role that is assigned to the user lt username gt Required This parameter is the name of the user where the role is assigned to lt pro
29. t jobname gt already exists Application lt applicationname gt does not exist e Your project is not approved to use application lt applicationname gt e The owner of the application is no longer an application provider His applications can not be used e The owner of the application is not trusted by a project admin in project lt projectname gt His applications can not be used e Your project is not approved to use dataset lt dataset gt SPINGRID Software User Manual 0 1 0 15 220 225 230 235 CHAPTER 4 REFERENCE e The owner of the data set is no longer a data provider His data sets can not be used e The owner of the data set is not trusted by a project admin in project lt projectname gt His data sets can not be used Related operations remove 4 1 4 add project Functional description This operation adds a project to the SPINGRID system Formal description e Syntax add project lt projectname gt with usr lt username gt e Parameters lt projectname gt Required This parameter is the name of project that is added Spaces are not allowed lt username gt Required This parameter is the name of the user that becomes project admin of the added project The user must exist Examples e add project MedicalResearch with usr Henk Possible errors e You do not have the role system admin e A project with name lt projectname gt already exists e User lt username gt
30. t with the client After installing the client can be started with java jar sgclient jar A list of available commands should be returned More info of a command can be found by typing java jar sgclient jar help followed by a command For an example java jar sgclient jar help info SPINGRID Software User Manual 0 1 0 11 135 140 CHAPTER 3 TUTORIAL 3 4 A quick start with the agent After installing the agent can be started with java jar sgagent jar A list of available commands should be returned More info of a command can be found by typing help followed by a command For an example help add interval 3 5 A quick start with the dispatcher After installing the dispatcher can be started with java jar sgdispatcher jar A list of available commands should be returned SPINGRID Software User Manual 0 1 0 12 Chapter 4 Reference The client agent and dispatcher operations are described in this chapter The description of the syntax of the operations needs an explanation 145 e arg Parameters between the symbols and mean that these are optional Note that the symbols itself are never used e arg0 argl argn Parameters between the symbols and and the symbol betweens those parameters mean that one of the parameters from arg0 to argn must be chosen Note that the symbols itself are never used so 4 1 Client operation
31. urns a list of applications This operation can be executed either as a project admin a system admin a job provider or as an application 405 provider e Project admin As a project admin it returns a list of all applications that can be used in one or more of your projects If a project is given it returns the applications that can be used in that specific project e System admin As system admin it returns a list of all applications in the system If a 410 project is given it returns the applications that can be used in that specific project Job provider As job provider it returns a list of all applications that can be used in your jobs If a project is given it returns all applications that can be used in your jobs in that specific project Application provider As application provider it returns a list of the applications you 415 have provided If a project is given it returns all applications that you have trusted in the specific project SPINGRID Software User Manual 0 1 0 22 CHAPTER 4 REFERENCE Formal description e Syntax as rol lt rolename gt list apps in pro lt projectname gt 420 e Parameters lt rolename gt Required This parameter is the name of the role you have This can either be projadmin sysadmin jobprov or appprov lt projectname gt Optional This parameter is the name of the project See the functional description of this operation for more informati
32. ystem admin e You do not have the role job provider SPINGRID Software User Manual 0 1 0 25 CHAPTER 4 REFERENCE e You do not have the role application provider e You do not have the role data provider e Project lt projectname gt does not exist e You do not have the role project admin in project lt projectname gt 505 e You do not have the role job provider in project lt projectname gt Related operations None 4 1 14 list projects Functional description This operation returns a list of projects This operation can be executed either as a project admin a system admin a job provider an application provider sio Or as an data provider Project admin As a project admin it returns a list of all projects where you are project admin e System admin As system admin it returns a list of all projects in the system Job provider As job provider it returns a list of all projects where you can submit jobs 515 to Application provider As application provider it returns a list of all projects in the system Data provider As data provider it returns a list of all projects in the system Formal description 520 e Syntax as rol lt rolename gt list projects e Parameters lt rolename gt Required This parameter is the name of the role you have This can either be projadmin sysadmin jobprov appprov or datprov ss Examples e as rol sysadmin list projects

Software User Manual - Information Systems

Contents

Download Pdf Manuals

Related Search

Related Contents