Difference between revisions of "LRM Commands Reference"

From Lingoport Wiki
Jump to: navigation, search
(Create a project)
(Create a group)
Line 167: Line 167:
   
 
=== Create a group ===
 
=== Create a group ===
  +
  +
When creating a group, you must have the license associated with the group. If you do not have a license, contact support@lingoport.com. With the license you will have the following information:
  +
* The group name (-gn)
  +
* The number of licenses (-nl) - this determines how many projects you can create under this group.
  +
* The expiration date (-dt)
  +
* The license key (-lkey)
  +
  +
'''<code>
  +
lrm --create-group -gn <group-name> -nl <number of licenses> -dt <expiration-date> -lkey <license key>
  +
</code>'''
  +
  +
For example:
  +
<code>
  +
lrm --create-group -gn Blue -nl 10 -dt 2016-12-31 -lkey 1234567890
  +
</code>
  +
  +
To verify that the group was created successfully, use the --list-groups option. This will show the options used to create the group
  +
<code>
  +
lrm -lg
  +
  +
Name Max Project Exp Date Days Left
  +
Blue 10 2016-12-31 452
  +
Process completed successfully.
  +
</code>
   
 
=== Update a project ===
 
=== Update a project ===

Revision as of 16:10, 21 April 2015

Introduction

To invoke a command, you must type java -jar <path-to-jarfile> -command -parameters For instance, on Linux, if the Lingoport Resource Manager Command Line Interface jar file is located under ~/lingoport/lrm-server-2.0 (the default location) and you want to list the Resource Manager projects, you would type:

 java -jar ~/lingoport/lrm-server-2.0/lrm-cli.jar --list-projects

Each command also has an abbreviation. The long version of each command starts with two dashes, --. The short version of each command starts with one dash, -.

For example, the previous example could have been written:

 java -jar ~/lingoport/lrm-server-2.0/lrm-cli.jar -lp

To Note

The help provides a list of all available commands. The debug and the verbose flags can be applied to all commands.

 -d,--debug                     Log4j Debug mode

 -v,--verbose                   Verbose (console logging)

 -h,--help                      Displays Help.
                              

Reference

This reference gives the short and the long version of each Resource Manager command and a usage example.


 -ak,--activate-kit             Activate a kit. Example: lrm-cli.jar -ak
                                --project-name MyProject --kit-version 2
 -au,--add-user                 Add a user. Example: lrm-cli.jar -au
                                --new-name MyName --new-password
                                MyPassword
 -cp,--create-project           Create a project from an xml file.
                                Example: lrm-cli.jar -cp -f
                                C:/MyLocation/Setup.xml
 -d,--debug                     Log4j Debug mode

 -dk,--deactivate-kit           Deactivate a specific kit. Example:
                                lrm-cli.jar -dk --project-name MyProject
                                --kit-version 2
 -dp,--delete-project           Delete a project. Example: lrm-cli.jar -dp
                                --project-name MyProject
 -dr,--dry-run                  Optional argument for --prep-kit. Runs
                                --prep-kit without altering the database.
 -ep,--export-project           Export the project into an xml file. If
                                option `-f` is not specified then the xml
                                file is saved to the default report
                                directory. Example: lrm-cli.jar -ep
 -f <string>                    Location of file (-f C:/MyLocation) or
                                file name with path (-f
                                C:/myfolder/myfile.xml)
 -h,--help                      Displays Help.

 -ii,--import-issues            Report on all the active import issues.
                                Example lrm-cli.jar -r -ii -pn
                                MyProjectName
 -ik,--import-kit               Import the translated kit. Example:
                                lrm-cli.jar -ik -pn MyProject -f
                                C:/KitLocation
 -ks,--kit-status               Report on all the incomplete and complete
                                kits. Example lrm-cli.jar -r -ks -pn
                                MyProjectName
 -ksi,--kit-status-incomplete   Report on all the incomplete kits. Example
                                lrm-cli.jar -r -ksi -pn MyProjectName
 -kv,--kit-version <number>     Specifies the kit version id when
                                activating or deactivating a kit.
 -lp,--list-projects            Lists all the projects to the console.
                                Example: lrm-cli.jar -lp
 -nn,--new-name <string>        Specifies either the new project name when
                                renaming a project (-rp) or the user name
                                when adding a user (-au).
 -np,--new-password <string>    Specifies the password when adding a user
                                (-au).
 -p,--password <string>         Optional argument used to log into the LRM
                                system as a different user than indicated
                                in the LrmUserConfig.xml file.
 -pi,--project-inspect          Report on all the files that were found
                                using the project definition for the
                                supplied project name. Example:
                                lrm-cli.jar -r -pi -pn MyProjectName
 -pk,--prep-kit                 Prep a kit. Example: lrm-cli.jar -pk
                                --project-name MyProject
 -pn,--project-name <string>    Specifies the project name.

 -ps,--project-status           Report on the productivity and status of
                                the supplied project name. Example
                                lrm-cli.jar -r -ps -pn MyProjectName
 -r,--report                    Run a report that is specified by an
                                additional option. If option `-f` is not
                                specified then the report is saved to the
                                default report directory.  Example:
                                lrm-cli.jar -r <report option>
 -rp,--rename-project           Rename a project. Example: lrm-cli.jar -rp
                                --project-name projectName --new-name
                                NewName
 -si,--source-issues            Report on the source issues for the
                                supplied project name. Example:
                                lrm-cli.jar -r -si -pn MyProjectName
 -u,--user <string>             Optional argument used to log into the LRM
                                system as a different user than indicated
                                in the LrmUserConfig.xml file.
 -up,--update-project           Update a project from an xml file.
                                Example: lrm-cli.jar -up -f
                                C:/MyLocation/Setup.xml
 -v,--verbose                   Verbose (console logging)



Commands to Know

There are a few commands which are useful for getting started and debugging problems.

To make things easier, set up an alias for the command. The examples below will be using the lrm alias

On Unix:

alias lrm='java -jar ~/lingoport/lrm-server2.0/lrm-cli.jar'

lrm --version

In Windows:

set "LRM=java -jar C:\Lingoport\LRM-Server-2.0\lrm-cli.jar"

%LRM% --version

Create a project

lrm --create-project -f <path to proj.xml file>

For example:

lrm -cp -f projects/MyProject.xml

The -f is the location of the project description file. The project description file must contain a <group-name> stanza and a <project-name> stanza otherwise the creation will fail.

       <project-name>MyProject</project-name>
       <group-name>Blue</group-name>
       <project-desc>This project contains resource files of all types for baseline testing</project-desc>
       <top-level-dir>Lingoport\test\MyProject\resources\</top-level-dir>
       <target-locales
               <locale>de_DE</locale>
               <locale>fr_FR</locale>
               <locale>zh_CN</locale>
       </target-locales>

To see if there are multiple groups:

lrm --list-groups

To create a project when there are multiple groups use the -gn option. The group must match that in the MyProject.xml file.

lrm -cp -f projects/MyProject.xml -gn <group-name>

To verify that the project was created in a group. If there is only one group the -gn is optional:

lrm -lp -gn <group-name>

Create a group

When creating a group, you must have the license associated with the group. If you do not have a license, contact support@lingoport.com. With the license you will have the following information:

  • The group name (-gn)
  • The number of licenses (-nl) - this determines how many projects you can create under this group.
  • The expiration date (-dt)
  • The license key (-lkey)

lrm --create-group -gn <group-name> -nl <number of licenses> -dt <expiration-date> -lkey <license key>

For example: lrm --create-group -gn Blue -nl 10 -dt 2016-12-31 -lkey 1234567890

To verify that the group was created successfully, use the --list-groups option. This will show the options used to create the group lrm -lg

 Name     Max Project     Exp Date       Days Left
 Blue     10              2016-12-31     452

Process completed successfully.

Update a project

Update a license

Create reports