Difference between revisions of "InContext Installation"

From Lingoport Wiki
Jump to: navigation, search
(Chrome Extension Configuration)
 
(32 intermediate revisions by 2 users not shown)
Line 1: Line 1:
  +
= InContext QA Installation and Verification =
  +
  +
This section identifies the tasks to get the InContext QA configured and verified. These are items, most likely, performed by a system administrator or linguistic developer. A linquistic QA, or reviewer, would not need this section for installation and should continue to the next part.
  +
  +
== Translate all resource files ==
  +
  +
First, create a Jenkins automation job for your application and it's resources. Make sure that it displays on the Dashboard correctly.
  +
  +
[[File:FullyTranslatedDashboard.jpg | 600px]]
  +
  +
Make sure the resources are fully translated and in the repository.
  +
  +
== Configure the Jenkins job for instrumentation ==
  +
  +
In Jenkins, select the automation job, scroll down and select '''Add build step''' at the bottom of the '''Build''' section. Select '''IQA Instrument'''.
  +
  +
[[File: AddIQAInstrument.jpg |600px]]
  +
  +
Run the automation job again. Verify that it Succeeds and there are no ERRORs in the console output. There should be instrumented resource files in the repository. The instumented files can be identified because they are resource files with <code>_LRMLQA</code> in the name.
  +
  +
== Deploy the web-based application ==
  +
At this point, the Lingoport system is configured, resource files have been instrumented and should reside in the repository.
  +
  +
The next step is to deploy the new instrumented resource files in the web-based application. On another server, the Deployment Server, set up the application and use the instrumented <code>_LRMLQA</code> resource files in place of the usual resource files. We assume that the Deployment Server is using Linux.
  +
  +
The deployment server may need the following software packages:
  +
* Tomcat
  +
* Ant
  +
* Java (1.8 or higher)
  +
  +
The Lingoport Server Jenkins user needs to be able to communicate with the deployment server over SSH and SCP. The permissions can be set up using <code>ssh-keygen</code> from the Jenkins user on Lingoport Server:
  +
<pre>
  +
$ cd /var/lib/jenkins/.ssh
  +
$ ssh-keygen
  +
$ <accept the defaults and don't enter a password>
  +
$ vi id_rsa.pub
  +
<copy contents of file>
  +
</pre>
  +
On deployment server:
  +
<pre>
  +
$ cd ~/.ssh
  +
$ vi authorized_keys <if this file does not exist, create it>
  +
<copy the contents of id_rsa.pub on the Lingoport Server into authorized_keys, being careful not to add line breaks>
  +
$ scp <testfile> jenkins@<Lingoport Server>:/var/lib/jenkins
  +
</pre>
  +
Verify that the <testfile> is transferred from the deployment server to the Lingoport Server.
  +
  +
== Test the system ==
  +
  +
* On the Lingoport Server, as the Jenkins administrator, create a username and a token to be used with the Chrome Extension.
  +
  +
* As a user, install and configure the [[InContext_Installation#Chrome_Extension_Installation|InContext Chrome Extension]] and verify that you can select strings and suggest changes.
  +
  +
[[File:TestChromeExtension.jpg| 600px]]
  +
  +
* Then '''Send''' the changes.
  +
  +
[[File:SelectRequests.jpg |600px]]
  +
  +
* If everything has been configured correctly, the Jenkins '''IQARetranRequest''' job should have been triggered.
  +
  +
= Installation for Reviewers or Linguistic QA =
 
== Pre-Requisites ==
 
== Pre-Requisites ==
 
In order to use Lingoport InContext QA, the user must have access to the Google Chrome browser. Lingoport InContext QA is based off a Chrome extension and other browsers do not have the same capability. Firefox or Internet Explorer can not be used as the browser in this situation.
 
In order to use Lingoport InContext QA, the user must have access to the Google Chrome browser. Lingoport InContext QA is based off a Chrome extension and other browsers do not have the same capability. Firefox or Internet Explorer can not be used as the browser in this situation.
*LRM must be installed and
+
* Localyzer must be installed and
 
* the G11n Continuous System's Jenkins server must be accessible from the reviewer's system.
 
* the G11n Continuous System's Jenkins server must be accessible from the reviewer's system.
   
Line 18: Line 80:
 
From within the Google Chrome Browser:
 
From within the Google Chrome Browser:
 
* Make sure you are signed in to Chrome Web Store with an authorized Google account: https://chrome.google.com/webstore/category/extensions
 
* Make sure you are signed in to Chrome Web Store with an authorized Google account: https://chrome.google.com/webstore/category/extensions
* Lingoport will give permissions to access the extension, based on the email address given to Lingoport.
+
* Lingoport will give permissions to access the extension, based on the email address given to Lingoport. This is the email address that must be used when signing into the Chrome Web Store.
 
* Navigate to https://chrome.google.com/webstore/detail/lingoport-incontext-qa/jboelmhkcjgogedegacfnhabhgpamiam
 
* Navigate to https://chrome.google.com/webstore/detail/lingoport-incontext-qa/jboelmhkcjgogedegacfnhabhgpamiam
 
* If this gives an error or a "URL was not found" message:
 
* If this gives an error or a "URL was not found" message:
** Check to make sure you are logged in as the correct Chrome user. Return to www.google.com and select the upper-right icon. This should match the login given to Lingoport. If it does not, sign out and sign in as the correct user. If this does not work, please contact support@lingoport.com.
+
** In the Chrome Web Store, verify that you are logged in using the correct email address . If this does not work, please contact support@lingoport.com.
[[File:google.png|600px]]
+
[[File:UserSignin.png|600px]]
 
* click on '''Add to Chrome Extension'''
 
* click on '''Add to Chrome Extension'''
 
You should see the Lingoport swirl [[File:swirl.png|35px]] at the top of the Chrome browser window.
 
You should see the Lingoport swirl [[File:swirl.png|35px]] at the top of the Chrome browser window.
* Select the '''three vertical dots''' on the top right side of the Chrome browser window. In the menu, select '''Settings'''
 
[[File:chrome_customize.png|200px]]
 
* On the Settings page, select the '''three horizontal lines''' (Main Menu) and select '''Extensions'''. There should be an entry for Lingoport InContext QA. Slide '''Developer Mode''' button to ON.
 
* Select '''DETAILS''' in the Lingoport InContext QA entry. Slide on the choice for '''Allow access to file URLs'''
 
Note: If you are using multiple screens, you may want to invoke Chrome the following way:
 
* <code>"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" /high-dpi-support=1 /force-device-scale-factor=1. --allow-file-access-from-files</code>
 
   
 
== Chrome Extension Configuration ==
 
== Chrome Extension Configuration ==
Line 40: Line 96:
   
 
You should be ready to do InContext reviews.
 
You should be ready to do InContext reviews.
  +
  +
== Loading Local Files in Google Chrome ==
  +
Due to security reasons Chrome will not load local files by default. You'll need to launch the Google Chrome browser from the command line window with the additional argument ''–allow-file-access-from-files'' as well as allowing local files access within the Chrome Extension.
  +
* Determine where chrome.exe is located on your machine by entering ''chrome://version'' into your Chrome Browser and search for ''Executable Path''.
  +
* Launch the Google Chrome browser from the command line window with the additional argument ''–allow-file-access-from-files''.
  +
: <code>>"path to your chrome installation\chrome.exe" --allow-file-access-from-files</code>
  +
* Within the Chrome Browser right-click on the Lingoport Incontext QA Chrome Extension and choose '''Manage Extensions'''
  +
[[File:ManageExtensions.png|200px]]
  +
* Move the ''Allow access to file URLs'' switch to the right.
  +
[[File:UserAllowAccess.png|400px]]
  +
  +
== Using Multiple Displays with Google Chrome ==
  +
In order for multiple high resolution displays to work properly with Google Chrome you'll need to launch the Google Chrome browser from the command line with additional arguments. You may want to create/change the Chrome shortcut to include the options rather than opening from a command line each time.
  +
* Determine where chrome.exe is located on your machine by entering ''chrome://version'' into your Chrome Browser and search for ''Executable Path''.
  +
* Launch the Google Chrome browser from the command line window with additional scaling directives ''/high-dpi-support=1 /force-device-scale-factor=1''.
  +
: <code>>"path to your chrome installation\chrome.exe" /high-dpi-support=1 /force-device-scale-factor=1</code>
  +
: Note: arguments are single spaced. If you need to load local files then add ''–allow-file-access-from-files'' to the argument list.

Latest revision as of 20:33, 23 February 2021

InContext QA Installation and Verification

This section identifies the tasks to get the InContext QA configured and verified. These are items, most likely, performed by a system administrator or linguistic developer. A linquistic QA, or reviewer, would not need this section for installation and should continue to the next part.

Translate all resource files

First, create a Jenkins automation job for your application and it's resources. Make sure that it displays on the Dashboard correctly.

FullyTranslatedDashboard.jpg

Make sure the resources are fully translated and in the repository.

Configure the Jenkins job for instrumentation

In Jenkins, select the automation job, scroll down and select Add build step at the bottom of the Build section. Select IQA Instrument.

AddIQAInstrument.jpg

Run the automation job again. Verify that it Succeeds and there are no ERRORs in the console output. There should be instrumented resource files in the repository. The instumented files can be identified because they are resource files with _LRMLQA in the name.

Deploy the web-based application

At this point, the Lingoport system is configured, resource files have been instrumented and should reside in the repository.

The next step is to deploy the new instrumented resource files in the web-based application. On another server, the Deployment Server, set up the application and use the instrumented _LRMLQA resource files in place of the usual resource files. We assume that the Deployment Server is using Linux.

The deployment server may need the following software packages:

  • Tomcat
  • Ant
  • Java (1.8 or higher)

The Lingoport Server Jenkins user needs to be able to communicate with the deployment server over SSH and SCP. The permissions can be set up using ssh-keygen from the Jenkins user on Lingoport Server:

$ cd /var/lib/jenkins/.ssh
$ ssh-keygen
$ <accept the defaults and don't enter a password>
$ vi id_rsa.pub
<copy contents of file> 

On deployment server:

$ cd ~/.ssh
$ vi authorized_keys <if this file does not exist, create it>
<copy the contents of id_rsa.pub on the Lingoport Server into authorized_keys, being careful not to add line breaks>
$ scp <testfile> jenkins@<Lingoport Server>:/var/lib/jenkins

Verify that the <testfile> is transferred from the deployment server to the Lingoport Server.

Test the system

  • On the Lingoport Server, as the Jenkins administrator, create a username and a token to be used with the Chrome Extension.

TestChromeExtension.jpg

  • Then Send the changes.

SelectRequests.jpg

  • If everything has been configured correctly, the Jenkins IQARetranRequest job should have been triggered.

Installation for Reviewers or Linguistic QA

Pre-Requisites

In order to use Lingoport InContext QA, the user must have access to the Google Chrome browser. Lingoport InContext QA is based off a Chrome extension and other browsers do not have the same capability. Firefox or Internet Explorer can not be used as the browser in this situation.

  • Localyzer must be installed and
  • the G11n Continuous System's Jenkins server must be accessible from the reviewer's system.

The reviewer needs to have the following information which should be set up by the Jenkins administrator:

  • The Jenkins URL
  • A Jenkins username and password.
  • To get the API token and verify the Jenkins account:
    • Log in to Jenkins using the reviewer username and password.
    • Select the pull down next to username at the top of the window and select Configure.
      • Under API Token, Show API Token.... Copy the token.

In addition, the reviewer will need:

  • Their email address

Chrome Extension Installation

From within the Google Chrome Browser:

UserSignin.png
  • click on Add to Chrome Extension

You should see the Lingoport swirl Swirl.png at the top of the Chrome browser window.

Chrome Extension Configuration

  • Before configuring the Chrome InContext extension, a username needs to be created in Jenkins.
  • Click on the Lingoport swirl Swirl.png for the Chrome Extension (top right corner of your Chrome)
  • Click on the 'Option' icon (☰) of the dialog.
  • Fill in the data, using the username and API token and Save Credentials
 Incontext credentials.png

You should be ready to do InContext reviews.

Loading Local Files in Google Chrome

Due to security reasons Chrome will not load local files by default. You'll need to launch the Google Chrome browser from the command line window with the additional argument –allow-file-access-from-files as well as allowing local files access within the Chrome Extension.

  • Determine where chrome.exe is located on your machine by entering chrome://version into your Chrome Browser and search for Executable Path.
  • Launch the Google Chrome browser from the command line window with the additional argument –allow-file-access-from-files.
>"path to your chrome installation\chrome.exe" --allow-file-access-from-files
  • Within the Chrome Browser right-click on the Lingoport Incontext QA Chrome Extension and choose Manage Extensions

ManageExtensions.png

  • Move the Allow access to file URLs switch to the right.

UserAllowAccess.png

Using Multiple Displays with Google Chrome

In order for multiple high resolution displays to work properly with Google Chrome you'll need to launch the Google Chrome browser from the command line with additional arguments. You may want to create/change the Chrome shortcut to include the options rather than opening from a command line each time.

  • Determine where chrome.exe is located on your machine by entering chrome://version into your Chrome Browser and search for Executable Path.
  • Launch the Google Chrome browser from the command line window with additional scaling directives /high-dpi-support=1 /force-device-scale-factor=1.
>"path to your chrome installation\chrome.exe" /high-dpi-support=1 /force-device-scale-factor=1
Note: arguments are single spaced. If you need to load local files then add –allow-file-access-from-files to the argument list.