Главная » Языки программирования

Php command line apache

Содержание
  1. PHP Command Line Scripts Tutorial
  2. Introduction
  3. Prerequisites
  4. You Will Learn
  5. Tutorial I — Preparation
  6. Tutorial II — Sanity Check
  7. Tutorial III — Add Computational Resources
  8. Tutorial IV — Create, Update & List Projects
  9. Tutorial V — Create, View , Update & Clone Experiment
  10. Tutorial VI — Search Experiments by Project & User
  11. Tutorial VII — Launch & Cancel Experiments
  12. Tutorial VIII — Get Experiment Results & Status
  13. Tutorial IX — List Applications & Resources
  14. Tutorial X — Airavata API tester
  15. Useful Commands

PHP Command Line Scripts Tutorial

The PHP command line scripts have been moved to the Apache Airavata git repository.

Introduction

An Airavata user or a gateway developer can also exercise using PHP client through command line to execute jobs in the computational Resources.

Prerequisites

  1. Make sure you have PHP & GIT installed in your machine.
    NOTE : The tutorial steps are given for Linux environment.

You Will Learn

  1. Execution of Airavata API methods using PHP client-command line.
  2. How to enter/modify input parameters for the methods in command-line.

Tutorial I — Preparation

  1. Create a folder (ex: SciGaP) in a preferable location in your local machine to clone the PHP samples from GitHub.
  2. Open the created SciGaP folder (. / cd SciGaP) and clone the files using GitHuB ‘HTTPS clone URL’
    git clone https://github.com/SciGaP/Airavata-PHP-Client-Samples
    Once the cloning is completed you would get a completed message.
  3. Open the folder which contains the PHP sample scripts.
    SciGaP → Airavata-PHP-Client-Samples → client-samples
  4. client-samples folder contains PHP scripts to exercise currently existing Airavata API methods;
    1. GetAPIVersion.php (a sanity check)
    2. add-compute-resources.php
    3. createProject.php
    4. updateProject.php
    5. getAllUserProjects.php
    6. createExperiment.php
    7. getExperiment.php
    8. updateExperiment.php
    9. cloneExperiment.php
    10. getAllExperimentsInProject.php
    11. getAllUserExperiments.php
    12. launchExperiment.php
    13. getExperimentStatus.php
    14. getExperimentOutputs.php
    15. terminateExperiment.php
    16. list-application-interfaces.php
    17. list-compute-resources.php
    18. airavata-client-api-tester.php
    1. airavata-client-properties.ini — contains the server. port and timeout period information
    2. README-PHP-CLI-Examples.txt — Gives the script execution order

    Tutorial II — Sanity Check

    Tutorial III — Add Computational Resources

    1. To add computational resources use script; registerComputeResource.php
    2. In order to run the script hostName and resourceDescription are passed as command line arguments.
      1. Format;
        php registerComputeResource.php
      2. Execute the above and a confirmation message will be prompted along with the resource ID (computResourceId)
        Compute Resource< computeResourceId >isregistered!
      3. Tutorial Tryout;
        Add other parameters to the script as command line arguments and improve the script.
        1. hostAliases
        2. ipAddresses

        Tutorial IV — Create, Update & List Projects

        Create Project
        1. Use; createProject.php to create new projects.
          project_owner and project_name can be given as command line arguments.
          1. Format;
            php createProject.php
          2. When creating new projects both project_owner and project_name cannot contain spaces.
            1. Sample values;
              project_owner: Thomas
              project_name: Test_Project
            Update Project
            1. Use; updateProject.php to modify or add project description.
              project_ID and project_description are passed into the script as command line arguments.
              1. Format;
                php updateProject.php
              2. When updating Projects currently user can only update the project description. Description cannot contain spaces.
                1. Sample values;
                  project_ID: Test_Project_4063b440-332a-49af-a6de-aea21d77bb2f
                  project_description: Test_Airavata_Project
                List Project
                1. Verify the existence of the above created project by using getAllUserProjects.php file
                2. User = Project owner who creates the Project. User name is given as a command line argument.
                  1. Format;
                    php getAllUserProjects.php
                  2. Sample values;
                    user: Thomas

                  Image — Project Detail Listing

                  Tutorial V — Create, View , Update & Clone Experiment

                  Create Experiment
                  1. Create an experiment with above created project using createExperiment.php script. When creating experiment User, Experiment name and Project ID (username, experiment_name, project_ID) are passed as arguments to the script.
                    1. Format;
                      php createExperiment.php
                    2. Changing other parameters require opening the script and modifying and saving values inside the script.
                      Sample values;
                    Parameter Sample Values NOTE
                    Project ID Test_Project_4063b440-332a-49af-a6de-aea21d77bb2f Project iD is validated against existing projects Passed as an argument to the script
                    Creating User Thomas Users are validated against existing Airavata gateway users. Passed as an argument to the script
                    Experiment Name Exp_Test_Project_1 Not a unique value. Use can enter any value Passed as an argument to the script
                    Resource Host ID trestles.sdsc.edu stampede.tacc.xsede.org
                    Computational Project Account
                    Total CPU Count 10 Number of CPUs required for the experiment
                    nodeCount 10 Number of nodes required in each CPU
                    Number of Threads 10 Number of threads per node
                    Queue Name normal if left blank it will pick default queue
                    Wall Time Limit 10 This is given in minutes
                    JobStartTime 0
                    Total Physical Memory 0
                    Application ID SimpleEcho2 Existing application in the selected resource
                    Input Key echo_input
                    Input Value echo_output=Hello World
                    Output Key echo_output
                    View Experiment (Search by Experiment ID)
                    1. To search and view above created experiment use getExperiment.php.
                    2. This would list experiment parameters and information about the experiment such as output, number of nodes, status, etc…
                    3. To view the experiment use;
                      1. php getExperiment.php
                      2. Format:
                        php getExperiment.php
                      3. All experiment related information will be listed along with experiment ID, experiment name, resource, application , user configuration data, etc…
                      Update Experiment
                      1. To update above created experiment use updateExperiment.php.
                      2. Currently the script modifies only the experiment name, by adding a generated text at the end of the name.
                      3. To modify the experiment use;
                        1. php updateExperiment.php
                        2. Format:
                          php updateExperiment.php
                        3. Once executed experiment details will be displayed along with the new experiment name.
                        4. Tutorial tryout;
                          1. Modifying the script to update more data in the experiment the same way; Try updating exp_description.
                          2. Update the script to modify existing configuration data by feeding the new values as command line arguments.
                          Clone Experiment
                          1. To clone above modified experiment use cloneExperiment.php.
                          2. Cloning will create exact copy of the existing experiment with a new experiment ID in CREATED state.
                          3. To clone the experiment use;
                            1. php cloneExperiment.php
                            2. Format:
                              php cloneExperiment.php
                            3. Experiment modification confirmation message;
                              1. Experimentcloned!
                              1. Try adding parameters to the script to change other data in the new experiment. E.g.: Exp name, Application, Resource, etc… and execute.

                              Tutorial VI — Search Experiments by Project & User

                              Get All Experiments In Project
                              1. To view all experiments created under one project we use getAllExperimentsInProject.php.
                                1. Format:
                                  php getAllExperimentsInProject.php
                                2. All the experiments and their details created using the given project_ID will be listed.
                                Get All Experiments by User
                                1. To view all experiments created by a single user we use getAllUserExperiments.php.
                                  1. Format:
                                    php getAllUserExperiments.php
                                  2. All the experiments and their details created by the given user/username will be listed.

                                  Tutorial VII — Launch & Cancel Experiments

                                  Launch Experiment
                                  1. launchExperiment.php is used to launch individual experiments.
                                  2. Currently with the scripts to launch an experiment user need to pass only the experiment ID as a command line arguments to the script.
                                    1. Format;
                                    2. php launchExperiment.php
                                    3. Upon successful launch a confirmation message will be displayed;
                                      Experiment< experiment_id >islaunched!
                                    Cancel/Terminate the Experiment
                                    1. Experiments which are not in statuses COMPLETED, CANCELED, UNKNOWN can be canceled/terminated.
                                    2. In order to cancel use;
                                      1. Format;
                                        php terminateExperiment.php
                                      2. User provided with the message; ‘ If there are no exceptions, assume the experiment terminated successfully’
                                      3. Experiment will be terminated/canceled. The status can be viewed by using the command getExperimentStatus.php . Status will be immediately changed to CANCELING and then to CANCELED.

                                      Tutorial VIII — Get Experiment Results & Status

                                      Check Experiment Status
                                      1. To check the experiment status;
                                        1. Format;
                                          php getExperimentStatus.php
                                        1. experiment status = COMPLETED
                                        Check Experiment Output
                                        1. Once the experiment is COMPLETED (Status of the experiment is checked using above getExperimentStatus.php) user can check the output.
                                        2. To check the output
                                          1. Format;
                                            php getExperimentOutputs.php

                                          Tutorial IX — List Applications & Resources

                                          List Application Interfaces
                                          1. For user to view all existing applications and their deployments in resources can use; getAllApplicationInterfaceNames.php script.
                                          2. All the applications used within the gateway will be listed.
                                          3. Execute phpgetAllApplicationInterfaceNames.php

                                          Tutorial X — Airavata API tester

                                          1. This special script consist of several API method executions.
                                            1. Format;
                                              php airavata-client-api-tester.php
                                            2. By this single script user can create project, update the project, create experiment, launch experiment, view experiment, clone experiment, etc.
                                            3. Explore the script for more infomration and build on this script.

                                            Useful Commands

                                            Navigate to a directory giving path

                                            sudo apt-get install php5-cli

                                            The given sequence will ensure getting a new copy from git reverting all the local changes have made to the local scripts

                                            Источник

                                            Читайте также:  Python check if list contains value
Оцените статью
© 2024 Программирование