Discussion

Difference between revisions of "Setup:Installation Guide/System Preparation/Linux/Parsoid"

[quality revision][quality revision]
(translation EN)
(Tag: 2017 source edit)
 
(Tag: 2017 source edit)


icon for optional
Parsoid is the rendering service for the Visual Editor. The steps listed here are optional and only required if you plan to use them in your BlueSpice installation.

Installation[edit | edit source]

The installation from package sources of the distribution will be omitted. Parsoid is installed under /opt. Go there with the following command: 

                cd /usr/localopt

To download Parsoid, the software "git" must be installed(apt install git). Start the download with: 

git clone --depth 1 --branch v0.10.0 https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid parsoid

Install Parsoid with the following commands: 

cd parsoid; \
npm install

Create the configuration file[edit | edit source]

In the BlueSpice codebase, you can find two files in the folder extensions/BlueSpiceVisualEditorConnector/docs/parsoid:

  • config.yaml
  • localsettings.js

Copy them to the folder /opt/parsoid.

Parsoid is already fully configured and should work in standard setup without further changes.

Installing Parsoid and checking the configuration[edit | edit source]

To test the installation and the configuration, run the command node bin\server.js in the /opt/parsoid folder.

Parsoid should now start without an error message.

Quit Parsoid by pressing "Ctrl+C". Keep the command prompt open and go to the next step.

Installing Parsoid as a service[edit | edit source]

To run Parsoid in the background in the future, you must additionally install pm2 via Node.js: 

npm install -g pm2

Then start Parsoid via pm2: 

pm2 start /opt/parsoid/bin/server.js

Now save the pm2 process list — this adds parsoid to the pm2 services: 

pm2 save

Finally, add pm2 to the system startup: 

# Render startup-script for a specific platform, the [platform] could be one of:
#   ubuntu|centos|redhat|gentoo|systemd|darwin|amazon
pm2 startup [platform]

Next Step[edit | edit source]

If you have completed all steps successfully, you can proceed to the next step " Python". 

{{DISPLAYTITLE:Installing Parsoid}}
        
        __TOC__
        
        
        
        
        
        {{Template:Optional|text=Parsoid is the rendering service for the Visual Editor. The steps listed here are optional and only required if you plan to use them in your BlueSpice installation.}}
        
        == Installation ==
        
        The installation from package sources of the distribution will be omitted. Parsoid is installed under /opt. Go there with the following command:
        
        
        
        
        <pre>cd /usr/localopt</pre>
        
         
        
        To download Parsoid, the software "git" must be installed(<code>apt install git</code>).
        
        Start the download with:
        
        
        
        
        <pre>git clone --depth 1 --branch v0.10.0 https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid parsoid</pre>
        
        
        
        Install Parsoid with the following commands:
        
        
        
        
        <pre>cd parsoid; \
        
        npm install</pre>
        
        
        
        ==Create the configuration file==
        
        In the BlueSpice codebase, you can find two files in the folder <code>extensions/BlueSpiceVisualEditorConnector/docs/parsoid</code>:
        
        * config.yaml
        
        * localsettings.js
        
        
        
        Copy them to the folder <code>/opt/parsoid</code>.
        
        
        
        Parsoid is already fully configured and should work in standard setup without further changes.
        
        
        
        ==Installing Parsoid and checking the configuration ==
        
        To test the installation and the configuration, run the command <code>node bin\server.js </code> in the <code>/opt/parsoid </code> folder.
        
        
        
        Parsoid should now start without an error message.
        
        
        
        Quit Parsoid by pressing "Ctrl+C". Keep the command prompt open and go to the next step.
        
        
        
        == Installing Parsoid as a service ==
        
        To run Parsoid in the background in the future, you must additionally install pm2 via Node.js:
        
        
        
        
        <pre>npm install -g pm2</pre>
        
        
        
        Then start Parsoid via pm2:
        
        
        
        
        <pre>pm2 start /opt/parsoid/bin/server.js</pre>
        
        
        
        Now save the pm2 process list &mdash; this adds parsoid to the pm2 services:
        
        
        
        
        <pre>pm2 save</pre>
        
        
        
        Finally, add pm2 to the system startup:
        
        
        
        
        <pre># Render startup-script for a specific platform, the [platform] could be one of:
        
        #   ubuntu|centos|redhat|gentoo|systemd|darwin|amazon
        
        pm2 startup [platform]</pre>
        
        
        
        ==Next Step==
        
        If you have completed all steps successfully, you can proceed to the next step "[[Setup: Installation Guide/System Preparation/Linux/Python | Python]]".
        
        
        
        
        
        [[en:{{PAGENAME}}]][[de:etup:Installationsanleitung/Systemvorbereitung/Linux/Parsoid]]
Line 7: Line 7:
 
The installation from package sources of the distribution will be omitted. Parsoid is installed under /opt. Go there with the following command:
 
The installation from package sources of the distribution will be omitted. Parsoid is installed under /opt. Go there with the following command:
  
−
<pre>cd /usr/local</pre>
+
<pre>cd /opt</pre>
 
   
 
   
 
To download Parsoid, the software "git" must be installed(<code>apt install git</code>).
 
To download Parsoid, the software "git" must be installed(<code>apt install git</code>).
Retrieved from "https://bs3-en.wiki.bluespice.com/w/index.php?title=Setup:Installation_Guide/System_Preparation/Linux/Parsoid&oldid=16229"

Attachments

Discussions