...

Guides for PDF library

How to use Flyingbee PDF Conversion SDK.


Want to Try?

Try Flyingbee PDF Converter Online for Free, play with PDF to MS Office (.docx, .xlsx, .pptx) conversion on Web.

Launch Web Demo

Powered by Flyingbee PDF Conversion SDK

1. Prerequisites for Linux


james wei 2024-09-29 15:22:44

Here's a detailed step-by-step guide for deploying and running the Flyingbee PDF Converter SDK/FPPDFConverter.out on a Linux system:

1. Check System Requirements

First, ensure that your Linux system meets the following basic requirements:

  • glibc version: FPPDFConverter.out requires ensuring that the GNU C Library (glibc) kernel version on the system is at least GLIBC-2.12, GLIBCXX_3.4.15, CXXABI_1.3.5。 You can check the glibc version by running the following command:

    $ getconf GNU_LIBC_VERSION
    glibc 2.12

    If the version is lower than GLIBC-2.12, you need to upgrade the versions of GNU Standard C Library (libc), Standard C++Library (libstdc++), and C++ABI Library (libcxxabi) by upgrading gcc.

  • gcc Version (Optional): The Flyingbee PDF Converter SDK is compiled with GCC 4.8.2 or higher. Therefore, you need to ensure that the GCC version on your system is at least 4.8.2. You can check the GCC version by running the following command:

    $ gcc --version
    gcc (GCC) 4.8.2
    Copyright (C) 2013 Free Software Foundation, Inc.
    This is free software; see the source for copying conditions.  There is NO
    warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

    If the version is lower than 4.8.2, you need to upgrade GCC.

  • Memory: Ensure that the system has at least 1GB of memory. You can check the memory size by running the following command:

    $ free -m
                 total       used       free     shared    buffers     cached
    Mem:          1989        599       1390          3         29        214
    -/+ buffers/cache:        355       1634
    Swap:         1983          0       1983

    This will display the memory usage in MB.

    Knowledge 1: The Flyingbee PDF Converter SDK library/FPDFConverter.out file is compiled under the GCC 4.8.2 compiler (requires C++11); So the highest required kernel version is GLIBC-2.12; GLIBCXX_3.4.15; CXXABI_1.3.5; On May 3, 2010, GLIBC 2.12 was released.

    Knowledge 2: The competitor Solid PDF Document is compiled under the GCC 4.8.3 compiler; So the highest required kernel version is GLIBC-2.17; GLIBCXX_3.4.19; CXXABI_1.3.5; On December 25, 2012, GLIBC 2.17 was released.

2. Check Font Files (Optional)

If your application needs to use font files, ensure that the following font-related files and directories exist:

  • Font Configuration File: Check if the /etc/fonts/fonts.conf file exists. If the file does not exist, you may need to install font management software.

    $ ls /etc/fonts/fonts.conf
    /etc/fonts/fonts.conf
  • Font Directories: Check if the /usr/share/fonts and ~/.fonts directories contain sufficient font files. If these directories are empty or do not exist, you need to install fonts.

    $ ls /usr/share/fonts
    $ ls ~/.fonts

3. Set Executable Command (Optional)

For convenience, you can set an alias for FPPDFConverter.out to run it directly in the terminal. You can set up the alias by following these steps:

  1. Open your bash configuration file (usually ~/.bashrc).

  2. Add the following line to the end of the file:

    $ alias FPPDFConverter="./FPPDFConverter.out"
  3. Save and close the file.

  4. Run the following command to apply the changes:

    $ source ~/.bashrc

Now, you can run FPPDFConverter directly in the terminal to start the application.

4. Enable Executable Permissions (If Needed)

If the FPPDFConverter.out file does not have execute permissions, you need to add them. You can do this by running the following command:

$ chmod +x FPPDFConverter.out

This will add execute permissions to the FPPDFConverter.out file.

5. Test and Display Help Information

Now, you can test whether the program is installed successfully and display help information. Run the following command:

$ ./FPPDFConverter.out -h
=== Wellcome to use Flyingbee PDF Converter! ===
The app exe folder: /home/peter/Desktop/FPPDFConverter for Linux
FPPDFConverter v1.5.3.0 (Aug 17 2024, 19:10:41)
FPPDFConverter v1.5.3.0
Time of license remaining: 19 days
FPPDFConverter - Convert PDF to Word/Excel/PPT, etc.
Usage: FPPDFConverter -a CMD_Name [input]filepath.pdf [options]docx [output]filepath.docx
Where options are:
 -a                [app]The apps: "PDF2Files", "Images2PDF", "Text2Word"
 -h                [help]print this help message
 -c                [open]open converted file[todo]
=== Thank you for using our product! ===

$ ./FPPDFConverter.out -a PDF2Files -i "Test.pdf" -f docx -p all
FPPDFConverter v1.5.3.0 (Aug 17 2024, 19:10:41)
Cmd: PDF2Files
inputFilePath: "Test.pdf"
Work folder: /home/peter/Desktop/FPPDFConverter for Linux
srcPath: /home/peter/Desktop/FPPDFConverter for Linux/Test.pdf
Let's convert PDF to docx
The number of pages in this PDF document: 20
Time of license remaining: 19 days
desPath: /home/peter/Desktop/FPPDFConverter for Linux/Test.docx
The converter has started.
The conversion progress:  5%
The conversion progress:  10%
The conversion progress:  15%
The conversion progress:  20%
The conversion progress:  25%
The conversion progress:  30%
The conversion progress:  35%
The conversion progress:  40%
The conversion progress:  45%
The conversion progress:  50%
The conversion progress:  55%
The conversion progress:  60%
The conversion progress:  65%
The conversion progress:  70%
The conversion progress:  75%
The conversion progress:  80%
The conversion progress:  85%
The conversion progress:  90%
The conversion progress:  95%
The conversion progress:  100%
The converter will save document to disk...
The converter has ended.
Time for Conversion: 5 seconds
Successfully converted!
=== Thank you for using our product! ===

If the program is installed successfully, it will display help information.

6. Check Library Dependencies

To ensure that the program can run properly, you need to check whether all the library files it depends on are installed correctly. You can use the ldd command to check library dependencies(CentOS):

$ ldd FPPDFConverter.out

This will output information similar to the following (example):

  linux-vdso.so.1 =>  (0x00007fff6dbbf000)
  libpthread.so.0 => /lib64/libpthread.so.0 (0x0000003e5e000000)
  libm.so.6 => /lib64/libm.so.6 (0x0000003e5ec00000)
  libgcc_s.so.1 => /lib64/libgcc_s.so.1 (0x0000003e69400000)
  libc.so.6 => /lib64/libc.so.6 (0x0000003e5dc00000)
  /lib64/ld-linux-x86-64.so.2 (0x00007f953ef48000)

This will list all the library files that the program depends on. If a library file is missing, you need to install it.

7. Check GLIBC and GLIBCXX Versions (Optional)

Since the Flyingbee PDF Converter SDK is compiled with specific versions of GLIBC and GLIBCXX, you need to ensure that your system has the correct versions of these libraries installed. You can check the versions using the following commands(CentOS):

$ ldd --version
ldd (GNU libc) 2.12
Copyright (C) 2010 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Written by Roland McGrath and Ulrich Drepper.
$ strings /lib64/libc.so.6 | grep GLIBC
GLIBC_2.2.5
GLIBC_2.2.6
GLIBC_2.3
GLIBC_2.3.2
GLIBC_2.3.3
GLIBC_2.3.4
GLIBC_2.4
GLIBC_2.5
GLIBC_2.6
GLIBC_2.7
GLIBC_2.8
GLIBC_2.9
GLIBC_2.10
GLIBC_2.11
GLIBC_2.12
GLIBC_PRIVATE
$ strings /usr/lib64/libstdc++.so.6 | grep GLIBCXX
GLIBCXX_3.4
GLIBCXX_3.4.1
GLIBCXX_3.4.2
GLIBCXX_3.4.3
GLIBCXX_3.4.4
GLIBCXX_3.4.5
GLIBCXX_3.4.6
GLIBCXX_3.4.7
GLIBCXX_3.4.8
GLIBCXX_3.4.9
GLIBCXX_3.4.10
GLIBCXX_3.4.11
GLIBCXX_3.4.12
GLIBCXX_3.4.13
GLIBCXX_3.4.14
GLIBCXX_3.4.15
GLIBCXX_3.4.16
GLIBCXX_3.4.17
GLIBCXX_3.4.18
GLIBCXX_3.4.19
GLIBCXX_FORCE_NEW
GLIBCXX_DEBUG_MESSAGE_LENGTH
$ strings /usr/lib64/libstdc++.so.6 | grep CXXABI
CXXABI_1.3
CXXABI_1.3.1
CXXABI_1.3.2
CXXABI_1.3.3
CXXABI_1.3.4
CXXABI_1.3.5
CXXABI_1.3.6
CXXABI_1.3.7
CXXABI_TM_1

This will display the versions of GLIBC and GLIBCXX installed on your system. If the versions are not compatible, you may need to upgrade your libraries or recompile the SDK.

8. Update the System (Optional)

If your system version is low and does not support the library versions required by the Flyingbee PDF Converter SDK, you may need to update your system. For CentOS systems, you can use the following command to update the system:

$ sudo yum update
Loaded plugins: fastestmirror, refresh-packagekit, security
Setting up Update Process
Loading mirror speeds from cached hostfile
 * base: mirrors.aliyun.com
 * extras: mirrors.aliyun.com
 * updates: mirrors.aliyun.com
base                                                     | 3.7 kB     00:00     
extras                                                   | 3.4 kB     00:00     
updates                                                  | 3.4 kB     00:00     
No Packages marked for Update

This will update your system and all installed packages.

By following these steps, you should be able to successfully deploy and run the Flyingbee PDF Converter SDK. If you encounter any issues, carefully check the error messages and make adjustments or install missing dependencies as needed.

We sincerely thank you for choosing Flyingbee PDF Converter! We hope our product brings convenience to your work and studies.



No More...
2.1 Install Fontconfig

Apple, the Apple logos, MacBook, iPad, iPhone, Apple Watch, and Apple Vision Pro are trademarks of Apple Inc., registered in the U.S. and other countries. App Store and Mac App Store is a service mark of Apple Inc., registered in the U.S. and other countries.
© 2014- 2024 Flyingbee Software, All Right Reserved.
United StatesUnited States

We uses cookies to give you the best experience, analyze traffic, and personalize content. By continuing using our Site, you agree to our use of cookies. The information collected might relate to you, your preferences, or your device, and is mostly used to make the site work as you expect it to and to provide a more personalized web experience. However, you can choose not to allow certain types of cookies, which may impact your experience of the site and the services we are able to offer. Read our Privacy Policy or manage your cookie preferences. If you would like to submit an opt-out request with respect to your non-cookie personal information (e.g., your email address), find our support email address to opt-out of sale/sharing/targeting with respect to non-cookie personal information.