Smile CDR v2024.05.PRE
On this page:
  • Smile CDR CLI (smileutil)
  • 42.0 Introduction
  • 42.1 Bulk Import
  • 42.2 Create FHIR Package
  • 42.3 Execute Script Function
  • 42.4 Export ConceptMap to CSV
  • 42.5 HL7 v2.x Analyze Flat File
  • 42.6 HL7 v2.x Transmit Flat File
  • 42.7 Import CSV to ConceptMap
  • 42.8 Map and Upload CSV Bulk Import File
  • 42.9 Migrate Database
  • 42.10 Clear Database Migration Lock
  • 42.11 Module Config Properties Export
  • 42.12 Reindex Terminology
  • 42.13 Synchronize FHIR Servers
  • 42.14 Upgrade H2 Database File
  • 42.15 Upload Bundle Files
  • 42.16 Upload CSV Bulk Import File
  • 42.17 Upload Sample Dataset
  • 42.18 Upload Terminology
  • 42.19 Generate Realtime Export Schema
  • 42.20 Validate FHIR Resources
    • 42.1    Bulk Import   
       Table of Contents

    Introduction

    42.0.1Smile CLI Tool (smileutil)

     

    The smileutil tool is a standalone command-line tool distributed with Smile CDR that contains a number of utility functions for maintenance and operation of Smile CDR.

    It is located in the bin/ directory of the Smile CDR installation.

    42.0.1.1Commands

    The smileutil tool has a number of supported functions, called commands. Each command has a name and a set of supported arguments.

    You can see a list of supported commands by simply issuing the command smileutil. For example:

    $ bin/smileutil

Usage:
  smileutil {command} [options]

Commands:
  hl7v2-analyze-flatfile     - Test mapping a flat file of HL7 v2.x messages to
                               FHIR using Smile CDR's converter
  hl7v2-transmit-flatfile    - Transmit HL7 v2.x messages using a flat file as a
                               source
(...trimmed...)

    You can also see the list of supported arguments for a given command by issuing the command smileutil help [commandname]. For example:

    $ bin/smileutil help upload-csv-etl-import-file

Usage:
    smileutil upload-csv-etl-import-file [options]

  Options:
    -b,--basic-auth <arg>       If specified, this parameter supplies a username
                               and password (in the format "username:password") to
                               include in an HTTP Basic Auth header
    -f,--filename <arg>        The filename to include
(...trimmed...)

    42.0.2Enabling Debug Logging

     

    The --debug flag can be added to all smileutil commands in order to enable verbose debug logging. With this flag set, a file containing the output will also be created called output.log in the current directory.

    42.0.3Memory Settings

     

    Note that smileutil runs in its own JVM as a discrete process dinstinct from Smile CDR. Like all Java applications, smileutil relies on arguments passed to the Java process at startup to determine the memory characteristics it will have. Althought smileutil defaults to a sensible setting, this can be changed with command line arguments.

    For example, to set a max memory of 4g, you would add the following to your command:

    env JAVA_OPTS=-Xmx4g

    Your command would look something like:

    $ env JAVA_OPTS=-Xmx4g bin/smileutil upload-csv-bulk-import-file [options]

    A value of -Xmx4g or -Xmx8g may be more appropriate depending on your needs.

  • Smile CDR CLI (smileutil)
  • 42.0 Introduction
  • 42.1 Bulk Import
  • 42.2 Create FHIR Package
  • 42.3 Execute Script Function
  • 42.4 Export ConceptMap to CSV
  • 42.5 HL7 v2.x Analyze Flat File
  • 42.6 HL7 v2.x Transmit Flat File
  • 42.7 Import CSV to ConceptMap
  • 42.8 Map and Upload CSV Bulk Import File
  • 42.9 Migrate Database
  • 42.10 Clear Database Migration Lock
  • 42.11 Module Config Properties Export
  • 42.12 Reindex Terminology
  • 42.13 Synchronize FHIR Servers
  • 42.14 Upgrade H2 Database File
  • 42.15 Upload Bundle Files
  • 42.16 Upload CSV Bulk Import File
  • 42.17 Upload Sample Dataset
  • 42.18 Upload Terminology
  • 42.19 Generate Realtime Export Schema
  • 42.20 Validate FHIR Resources
    • 42.1    Bulk Import