InContext Server Users Guide

From Lingoport Wiki
Revision as of 20:57, 1 March 2019 by MaryH (talk | contribs)
Jump to: navigation, search

Browse to your InContext Server and Log In

When the InContext Server is installed, it creates one account with Username: Admin and Password: please.reset.me.

Please browse to your InContext Server and log in with the above credentials:


Incontext-server-login-screen.png


The Admin user can do the following:

  • Reset Admin Password
  • Manage Tokens to control access to this Server
  • View uploaded LRM Keys and their Context
  • Display Log File

Reset your Admin Password

To reset your password, Click on the Settings link to display the following page and then provide a new Admin Password, matching Confirm, and press the Reset Password button:


Incontext-server-settings.png


Passwords need to be at least 6 characters in length and cannot be just spaces. Also, please retain this password as it cannot be recovered by Lingoport, though Lingoport can reset the password for you if necessary.

Manage InContext Server Tokens

The InContext Server manages two kinds of tokens to control access to the Server:

  • Chrome Token(s)
  • Translator Token

The Chrome Token is used by the Lingoport InContext Capture to send context to this Server. The Chrome Token value configured on the InContext Capture page (shown below) must match one of the Chrome Tokens configured on the Settings page of the InContext Server (shown above):


Incontext capture signinnew.png


The Admin user can create multiple Chrome Tokens to give different groups of users access to the Server. In this way, if you decide to change the Chrome Token for one group of users, it will not affect access for other groups of users.

The Translator Token is used to verify context lookups. The Translator Token value configured in Jenkins for LRM must match the Translator Token configured on the Settings page of the InContext Server.

View Context Associated with LRM Keys

The home page for the Admin user lists LRM Keys (and their corresponding values) that have context stored on the Server. The keys and values can be searched and sorted.


Incontext-server-home.png


If you click on a key, the associated context will be displayed in a new tab with the value highlighted. This is what translators will see when there is context associated with a key they are translating.


Incontext-server-context.png


Display Log File

The InContext Server keeps a log file that rolls over daily. To view the contents of today's log, click Display Log File from the Admin home screen. Note that the location of all the log files is listed on this page.


Incontext-server-log.png


Configure Log Settings

The default log level is set to INFO. If you would like the log to generate more information, you can set the log level to DEBUG. If you would like the log to generate less information, you can set the log level to WARN or ERROR.

To do this, you need to stop the server, modify the incontext-server.sh script, and restart the server:

> cd tomcat
> ./incontext-server.sh stop -force
> modify incontext-server.sh file and set the INCONTEXT_SERVER_LOG_LEVEL to desired level
> ./incontext-server.sh start

The default number of days to keep a log file is 30. That is, a new log file is created every day and the last 30 logs are kept. You can increase or decrease the number of logs kept.

To do this, you need to stop the server, modify the incontext-server.sh script, and restart the server:

> cd tomcat
> ./incontext-server.sh stop -force
> modify incontext-server.sh file and set the INCONTEXT_SERVER_MAX_LOGS to desired number
> ./incontext-server.sh start