How to Install WBO on Debian Latest

This tutorial will guide you through the process of installing WBO on the latest version of Debian. WBO is a web-based annotation tool that enables users to markup and annotate PDF files.

Prerequisites

Before we begin, make sure that your system is up-to-date by running the following command as the root user:

apt-get update && apt-get upgrade -y

Also, make sure that you have installed the following dependencies:

  • Apache 2
  • PHP 7 or later
  • MySQL 5.5 or later

Step 1: Download WBO from GitHub

First, you need to download WBO from GitHub. You can do this by running the following command:

git clone https://github.com/lovasoa/whitebophir.git

This will download the WBO code in the current directory.

Step 2: Install the Required PHP Packages

Once you have downloaded the WBO code, navigate to the whitebophir directory and install the required PHP packages by running the following command:

composer install

Step 3: Create a Virtual Host

Next, we need to create a virtual host to serve the WBO application. To do this, open the following file using your preferred text editor:

/etc/apache2/sites-available/000-default.conf

Add the following lines before the </VirtualHost> tag:

        Alias /wbo /path/to/whitebophir/web

        <Directory /path/to/whitebophir/web>
                AllowOverride All
                Order Allow,Deny
                Allow from All
                Require all granted
        </Directory>

Replace /path/to/whitebophir with the actual path where you downloaded WBO in step 1.

Save and close the file.

Step 4: Enable the Virtual Host

Now, we need to enable the virtual host by running the following command:

a2ensite 000-default.conf

Restart the Apache server by running:

systemctl restart apache2

Step 5: Create the WBO Database

Before we can use WBO, we need to create a MySQL database. Connect to your MySQL server and run the following commands:

CREATE DATABASE wbo;

GRANT ALL PRIVILEGES ON wbo.* TO 'wbo_user'@'localhost' IDENTIFIED BY 'password';

FLUSH PRIVILEGES;

Replace 'password' with a strong password of your choice.

Step 6: Configure WBO

Next, we need to configure WBO by creating the app/config/parameters.yml file. Navigate to the app/config directory and copy the parameters.yml.dist file to parameters.yml:

cd whitebophir/app/config
cp parameters.yml.dist parameters.yml

Open the parameters.yml file using your preferred text editor, and change the database settings as follows:

database_host: localhost
database_port: null
database_name: wbo
database_user: wbo_user
database_password: password

Replace 'password' with the MySQL password you set in step 5.

Step 7: Populate the Database

Now, we need to populate the WBO database with the required tables by running the following command:

php bin/console doctrine:schema:update --force

Step 8: Access WBO

Finally, open your web browser and navigate to http://localhost/wbo. You should see the WBO annotation tool.

Conclusion

Congratulations! You have successfully installed WBO on Debian Latest. You can now use WBO to annotate and markup your PDF files.