Apertium-apy/Debian - Revision history

Tino Didriksen: wget -> curl

2021-04-02T21:00:34Z

wget -> curl

2017-06-20T08:27:44Z

servlet.py: error: APY needs a UTF-8 locale, please set LANG or LC_ALL

2017-06-02T07:21:06Z

doh

2017-06-02T07:07:31Z

More info

2017-01-17T08:07:43Z

Quickstart

2016-09-26T14:51:01Z

2016-06-21T08:25:12Z

More info

2016-06-13T13:25:57Z

Quickstart

2016-06-13T13:08:05Z

Quickstart

2016-06-13T09:42:57Z

Quickstart

@@ Line 15: / Line 15: @@
 Unless you're running Debian sid, you'll need the apt-repo:
 <pre>
-wget http://apertium.projectjj.com/apt/install-nightly.sh
+curl -sS https://apertium.projectjj.com/apt/install-nightly.sh | sudo bash
-sudo bash install-nightly.sh
 </pre>
 Now install APY and the language pairs you want:

@@ Line 92: / Line 92: @@
 You need to have at least one UTF-8 locale installed. Do
 <pre>locale -a</pre>
-to see which ones you have installed. Say you had <code>pt_BR.utf8</code> in there, then you can do
+to see which ones you have installed. At minimum, Debian/Ubuntu derivatives will have the <code>C.UTF-8</code> locale available, which will do. But you can use any UTF-8 locale you want, such as <code>en_US.utf8</code> or <code>pt_BR.utf8</code>. To edit daemon locale, run
 <pre>sudo systemctl edit apertium-apy</pre>
 which will open an empty file for you; enter
 <pre>[Service]
-Environment=LC_ALL=pt_BR.UTF-8</pre>
+Environment=LC_ALL=C.UTF-8</pre>
 there and verify what it all looks like with
 <pre>systemctl cat apertium-apy</pre>

@@ Line 96: / Line 96: @@
 which will open an empty file for you; enter
 <pre>[Service]
-Environment=LC_ALL=en_US.UTF-8</pre>
+Environment=LC_ALL=pt_BR.UTF-8</pre>
 there and verify what it all looks like with
 <pre>systemctl cat apertium-apy</pre>

@@ Line 87: / Line 87: @@
 ==If you don't have/want root==
 See [[Apertium-apy#Running_as_a_--user_unit]].
+==Troubleshooting==
+===<code>servlet.py: error: APY needs a UTF-8 locale, please set LANG or LC_ALL</code>===
+You need to have at least one UTF-8 locale installed. Do
+<pre>locale -a</pre>
+to see which ones you have installed. Say you had <code>pt_BR.utf8</code> in there, then you can do
+<pre>sudo systemctl edit apertium-apy</pre>
+which will open an empty file for you; enter
+<pre>[Service]
+Environment=LC_ALL=en_US.UTF-8</pre>
+there and verify what it all looks like with
+<pre>systemctl cat apertium-apy</pre>
+then try starting again with
+<pre>sudo systemctl start apertium-apy</pre>
 ==More info==

@@ Line 23: / Line 23: @@
 sudo apt-get install apertium-eng-kaz apertium-sme-nob apertium-hbs-mkd apertium-eo-en apertium-tat-rus # etc.
 </pre>
-(Here we're assuming you only want packaged pairs, see [[Installation]] on how to install SVN pairs.)
+(Here we're assuming you only want packaged pairs, see [[Installation]] on how to install pairs that are only in SVN.)

@@ Line 93: / Line 93: @@
 [[Category:Tools]]
 [[Category:Installation]]
+[[Category:Documentation in English]]
 [[Category:Quickstart]]

@@ Line 13: / Line 13: @@
 ==Quickstart==
+Unless you're running Debian sid, you'll need the apt-repo:
-Install apt-repo and APY:
 <pre>
 wget http://apertium.projectjj.com/apt/install-nightly.sh
 sudo bash install-nightly.sh
-sudo apt-get install apertium-apy
 </pre>
+Now install APY and the language pairs you want:
-And install the language pairs you want:
 <pre>
+sudo apt-get install apertium-apy
 sudo apt-get install apertium-eng-kaz apertium-sme-nob apertium-hbs-mkd apertium-eo-en apertium-tat-rus # etc.
 </pre>

@@ Line 27: / Line 27: @@
+You can now start APY like this:
-Now try starting APY and checking its status:
 <pre>
 sudo systemctl start apertium-apy
+</pre>
+and enable it for starting after a reboot like this:
-sudo systemctl status apertium-apy
+<pre>
+sudo systemctl enable apertium-apy
 </pre>
+==Test that it works==
-It should look like
+You can do
+<pre>
+sudo systemctl status apertium-apy
+</pre>
+and it should show something like
 <pre>
 ● apertium-apy.service - Apertium APY service
@@ Line 52: / Line 60: @@
 juni 13 11:38:11 gamlepadda python3[14813]: [I 160613 11:38:11 servlet:898] Serving at http://localhost:2737
 </pre>
+if it's started. (Press q to get your terminal back if it put you in less-mode.)
-Press q to get your terminal back.
+Try checking what language data it found:
-Open a new terminal to check that it's OK:
 <pre>
 curl http://localhost:2737/listPairs
@@ Line 62: / Line 69: @@
 It should contain a list of pairs.
 Say the list contains <code>{"sourceLanguage": "sme", "targetLanguage": "nob"}</code>, then we can try translating the sentence "in leat doppe" from sme to nob:
@@ Line 71: / Line 79: @@
-If everything worked, congrats, you have your own Apertium API server running! You can enable it on startup with
+If everything worked, congrats, you have your own Apertium API server running!
-<pre>
-sudo systemctl enable apertium-apy
-</pre>
 Now open port 2737 in your firewall and point your [[apertium-html-tools|website]] or [[Android|app]] at it :-)