Difference between revisions of "Introduction to the LRM File System"

From Lingoport Wiki
Jump to: navigation, search
(LRM_STREAMLINING)
(LRM_STREAMLINING)
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
The major directories for LRM are as follow, if installed under the Jenkins user with default installation values:
 
The major directories for LRM are as follow, if installed under the Jenkins user with default installation values:
* <code>LRM_HOME (~jenkins/lingoport/lrm-server-2.0/)</code> is where the application's code resides
+
* '''LRM_HOME (Install directory):''' <code>(<HOME>/lingoport/lrm-server-x.x/)</code> is where the application's code resides
* <code>LRM_STREAMLINING (~jenkins/Lingoport_Data/L10nStreamlining/)</code>: <group_name>/projects/<project_name> are under <code>LRM_STREAMLINING</code> and
+
* '''LRM_STREAMLINING:''' <code>(<HOME>/Lingoport_Data/L10nStreamlining/)<group_name>/projects/<project_name></code> are under <code>LRM_STREAMLINING</code> and
 
** the configuration,
 
** the configuration,
 
** the prep kits sent to translation (for tracking purposes)
 
** the prep kits sent to translation (for tracking purposes)
 
** the prep kits received from translation reside there (for tracking purposes).
 
** the prep kits received from translation reside there (for tracking purposes).
* <code>LRM_DATA_HOME (~jenkins/Lingoport_Data/LRM)</code> holds temporary files to send files for translation, or receive them back; That's also where LRM reports are stashed.
+
* '''LRM_DATA_HOME''': <code>(<HOME>/Lingoport_Data/LRM)</code> holds temporary files to send files for translation, or receive them back; That's also where LRM reports are stashed.
   
   
 
== LRM_STREAMLINING ==
 
== LRM_STREAMLINING ==
   
LRM_STREAMLINING is typically set to '''~jenkins/Lingoport_Data/L10nStreamlining/'''. Under LRM_STREAMLINING, '''<group_name>/projects/<project_name>''' contains those directories:
+
LRM_STREAMLINING is typically set to '''<HOME>/Lingoport_Data/L10nStreamlining/'''. Under LRM_STREAMLINING/'''<group_name>/projects/<project_name>''' contains those directories:
 
<pre>
 
<pre>
   
Line 43: Line 43:
 
</pre>
 
</pre>
   
* config: This directory contains files to setup this project. See [[Project Configuration Files]]
+
* '''config''': This directory contains files to setup this project. See [[Project Configuration Files]]
* context: Not used at this stage
+
* '''context''': Not used at this stage
* failedkits: If failures occurred during importing translated files, the failed files are moved to that directory for trouble shooting purposes
+
* '''failedkits''': If failures occurred during importing translated files, the failed files are moved to that directory for troubleshooting purposes
* importkits: Keeps the files successfully imported to the project's repository for tracking purposes.
+
* '''importkits''': Keeps the files successfully imported to the project's repository for tracking purposes.
* logs: Contains the log files for this project
+
* '''logs''': Contains the log files for this project
* prepkits: Keeps the files successfully sent for translation for tracking purposes.
+
* '''prepkits''': Keeps the files successfully sent for translation for tracking purposes.
   
 
== LRM_DATA_HOME ==
 
== LRM_DATA_HOME ==
LRM_DATA_HOME is typically set to ~jenkins/Lingoport_Data/LRM. Two type of directories are located here, staging and LRM core command directories for each project.
+
LRM_DATA_HOME is typically set to '''<HOME>/Lingoport_Data/LRM'''. Two type of directories are located here, staging and LRM core command directories for each project.
   
 
=== staging ===
 
=== staging ===
Line 89: Line 89:
   
 
=== LRM_DATA_HOME project ===
 
=== LRM_DATA_HOME project ===
LRM_DATA_HOME is typically set to ~/Lingoport_Data/LRM. Each group under LRM_DATA_HOME holds data for the core functionality of LRM. Here is a typical layout for the directory structure for one group, here just with one project:
+
LRM_DATA_HOME is typically set to '''<HOME>/Lingoport_Data/LRM'''. Each group under LRM_DATA_HOME holds data for the core functionality of LRM. Here is a typical layout for the directory structure for one group, here just with one project:
   
 
<pre>
 
<pre>

Latest revision as of 20:33, 30 January 2017

The major directories for LRM are as follow, if installed under the Jenkins user with default installation values:

  • LRM_HOME (Install directory): (<HOME>/lingoport/lrm-server-x.x/) is where the application's code resides
  • LRM_STREAMLINING: (<HOME>/Lingoport_Data/L10nStreamlining/)<group_name>/projects/<project_name> are under LRM_STREAMLINING and
    • the configuration,
    • the prep kits sent to translation (for tracking purposes)
    • the prep kits received from translation reside there (for tracking purposes).
  • LRM_DATA_HOME: (<HOME>/Lingoport_Data/LRM) holds temporary files to send files for translation, or receive them back; That's also where LRM reports are stashed.


LRM_STREAMLINING

LRM_STREAMLINING is typically set to <HOME>/Lingoport_Data/L10nStreamlining/. Under LRM_STREAMLINING/<group_name>/projects/<project_name> contains those directories:


├── config
│   ├── config_email_recipients.xml
│   └── config_vcs.properties
├── context
├── failedkits
├── importkits
│   └── TRANSLATED_KIT_1
│       └── fr
│           ├── file_one_fr.properties
│           ├── file_three_fr.properties
│           └── file_two_fr.properties
├── logs
│   ├── error_import_kit.log
│   └── error_prep_kit.log
├── prepkits
│   └── PREP_KIT_1
│       ├── BaseFileSearch_fr.xml
│       ├── FilesToPrep.xml
│       ├── fr
│       │   ├── file_one_en.properties
│       │   ├── file_three_en.properties
│       │   └── file_two_en.properties
│       ├── <project_name>_1_fr.xml
│       ├── imported_lingotek_5f79e96c-cd3a-4b6e-bac5-9d37febc8f07_fr_fr.json
│       ├── IncompletePrepKit.xml
│       └── lingotek_5f79e96c-cd3a-4b6e-bac5-9d37febc8f07.json
└── reports
    └── notify-changes
  • config: This directory contains files to setup this project. See Project Configuration Files
  • context: Not used at this stage
  • failedkits: If failures occurred during importing translated files, the failed files are moved to that directory for troubleshooting purposes
  • importkits: Keeps the files successfully imported to the project's repository for tracking purposes.
  • logs: Contains the log files for this project
  • prepkits: Keeps the files successfully sent for translation for tracking purposes.

LRM_DATA_HOME

LRM_DATA_HOME is typically set to <HOME>/Lingoport_Data/LRM. Two type of directories are located here, staging and LRM core command directories for each project.

staging

The staging directory is where files which are ready to be sent for translation or retrieved from translation transit. As soon as the prep kit is finished, the files are moved to the LRM_STREAMLINING directory. As soon as the downloaded files have been imported and pushed to the repository, the files are moved to the LRM_STREAMLINING directory.

The files to be sent to a translation end point are not dependent on the LRM core at that point. The files which must be downloaded from the translation application do not know anything about the LRM core either.

staging
├── downloads
│   └── lingotek
├── importkits
│   └── lingotek
│       ├── <group_name1>
│       │   └── <project_name1>
│       │   └── <project_name2>
│       ├── <group_name2>
│       │   └── <project_name3>
│       └── ...
├── sendkits
│   └── lingotek
│       ├── <group_name1>
│       │   └── <project_name1>
│       │   └── <project_name2>
│       ├── <group_name2>
│       │   └── <project_name3>
│               └── PREP_KIT_1
│                   ├── BaseFileSearch_fr.xml
│                   ├── FilesToPrep.xml
│                   ├── fr
│                   │   ├── file1_en.properties
│                   │   └── file2_en.properties
│                   ├── <project_name>_1_fr.xml
│                   └── IncompletePrepKit.xml
└── tmp_importkits
    └── lingotek

LRM_DATA_HOME project

LRM_DATA_HOME is typically set to <HOME>/Lingoport_Data/LRM. Each group under LRM_DATA_HOME holds data for the core functionality of LRM. Here is a typical layout for the directory structure for one group, here just with one project:

<group1>
├── logs
│   └── lrmerror.log
├── prep_kit
│   └── <project1>
│       └── PREP_KIT_2
│           ├── FilesToPrep.xml
│           ├── OutstandingPrepFiles_de.xml
│           ├── OutstandingPrepFiles_es.xml
│           ├── OutstandingPrepFiles_fr.xml
│           ├── OutstandingPrepFiles_it.xml
│           ├── OutstandingPrepFiles_ja.xml
│           └── OutstandingPrepFiles_ru.xml
└── reports
    └── <project1>
        └── ProjectDefinition.xml