NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: For HPCDATAMGM-1755: Added subscriptions to the JSON code block.

...

  1. Make sure the user has an NIH user account. 
  2. In your local system, create a JSON file that specifies the user's information as follows:

    Code Block
    {
       "firstName": "John",
       "lastName": "Doe",
       "defaultBasePath" : "/FNLCR",
       "doc" : "FNLCR",
       "notifyUser" : "true",
       "subscriptions": [{
                "eventType": "DATA_TRANSFER_UPLOAD_ARCHIVED",
                "notificationDeliveryMethods": ["EMAIL"]
            },
            {
                "eventType": "DATA_TRANSFER_UPLOAD_FAILED",
                "notificationDeliveryMethods": ["EMAIL"]
            }]
    }

    Include the following information in this JSON file: 

    • Consider specifying the user's first name and last name. Otherwise, the system creates the account using the first and last name associated with the NIH user ID.
    • Specify a default base path for the user. 
    • Specify the user's DOC. If your user account has the group administrator role, the DOC you specify must match your own. 
    • If you want the system to send an email notification to the new user at the time of user account creation, include the notifyUser attribute and set it to true.  
    • If you want to subscribe the user to data transfer notifications, specify those notifications.
  3. Run the following command:

    Panel
    borderColorsilver
    borderStylesolid
    Clipboard
    AllowLineWraptrue

    dm_register_user [optional parameters] <userId> <description.json>


    The following table describes each parameter:

    ParameterDescription
    [-h]If you want to print a usage (help) message for this command, specify this option.
    [-D <REST-response>]

    An optional parameter, specifying a path and filename in your local system. The system always creates a response file:

    • If you specify this parameter, the system saves the response from the server to the specified file in the specified location.
    • If you omit this parameter, the system saves the file as register_user-response-header.tmp in your home directory.
    [-o <output-file>]

    An optional parameter, specifying a path and filename in your local system. The system always creates an output file: 

    • If you specify this parameter, the system saves the output to the specified file in the specified location.
    • If you omit this parameter, the system saves the output as register_user-response-message.json.tmp in your home directory. 

    If the command is successful, the output file is empty.

    <userId>
    Specify the user's NIH user ID.
    <description.json>

    A path to the JSON file that specifies the information about the user.

    The system creates the new user with the user role. (To create a user with the group administrator role, contact NCIDataVault@mail.nih.gov.)

...