PDF conversion (HTTP)

This topic will show how to configure the PDF converter with HTTP protocol on port 8584. To do that, take the following steps:

danger

• We recommend using the HTTPS protocol for the PDF converter. Use the HTTP protocol only if it is not possible to use HTTPS.
• The commands below must be run as root.

1. Create the sepdfconverter directory:

mkdir /usr/local/se/sepdfconverter

2. Access the sepdfconverter directory:

cd /usr/local/se/sepdfconverter

3. Create the docker-compose.yml file inside the sepdfconverter directory.

vim docker-compose.yml

4. Paste the following text:

version: '3.7'

services:
 sepdfconverter:
  container_name: sepdfconverter
  image: softexpert/sepdfconverter:latest
  restart: always
  extra_hosts:
   - AccessURL:ServerIP
  environment:
   - ASPNETCORE_URLS=http://+:80
  ports:
   - "${HTTP_PORT}:80"
  volumes:
     - ./conf:/app/conf/
deploy:
   resources:
     limits:
       memory: 1G

5. Locate the extra_hosts parameter.

6. Insert the SE access URL and the local IP of the application server, as shown in the image below.

7. Save the changes with:

wq!:

8. Create the pdf.env file inside the sepdfconverter directory.

vim pdf.env

9. Insert the following text, indicating the port that will be used for connection:

HTTP_PORT=8584

By default, the port used for HTTP connection is 8584, but it is possible to set a different port, if the default one is already being used. In this case, run the netstat -lnp | grep "8584" command to check whether the port is being used.

10. Start the PDF conversion service using the command below:

cd /usr/local/se/sepdfconverter/ ; docker-compose --env-file pdf.env --compatibility up -d

• To stop the service, run the command below:

cd /usr/local/se/sepdfconverter/ ; docker-compose --env-file pdf.env down

• To check whether the sepdfconverter service is up, run the command below:

docker ps

11. Once this is done, access the SoftExpert Document component -> Configuration

General parameters (DC035) and point the service in the application by entering https://serverIP:8584 in the Enable PDF conversion service -> Server field.

12. Then, run the connection test and save.

13. After completing all the configuration, run a file conversion test for .doc, .docx, .xls, and .xlsx.