Akeneo 7.x Installation on Ubuntu 22.04

Kaushal

7 October 2024

Akeneo PIM (Product Information Management) is an open-source software developed by Akeneo to improve customer experience.

It is widely used by retailers, manufacturers, distributors, and other businesses dealing with large catalogs of products across multiple channels.

The benefits of streamlined product information management and improved data quality and consistency for enhancing the overall customer experience.

Let’s discuss how to install Akeneo on Ubuntu 22.04.

Here we use the below configuration to install Akeneo Ver. 7.x, you can choose your configuration as per the requirement.

Requirements to install Akeneo –

Ubuntu 22.04
System Requirements 8 GB of RAM, 4 CPU Cores, 25 GB of Disk space
Web-server: Apache2
MySQL 8.0
PHP8.1
Composer 2.5.X
Elasticsearch 8.8.2
Node 18
Yarn
Download Akeneo PIM Ver. 7.x

Step 1: Install Apache

Update the local package then Install Apache

sudo apt-get update

sudo apt-get install apache2

sudo systemctl enable apache2

sudo systemctl status apache2

Step 2: Install MySql

Install MySQL and create a database for Akeneo

There are two ways to use MySQL database:

Localhost MySQL Database Server
AWS RDS(Relational Database Service)

Case-1 – For localhost MySQL database server

1	sudo apt-get install mysql-server

In this section, we can set our MySQL root password.
We create a dbuser, database for Akeneo and give privileges to the dbuser.

sudo mysql

ALTER USER ‘root’@’localhost’ IDENTIFIED WITH mysql_native_password BY ‘password’;

CREATE DATABASE akeneo_pim;

CREATE USER akeneo_pim@localhost IDENTIFIED WITH mysql_native_password BY ‘akeneo_pim’;

GRANT ALL PRIVILEGES ON akeneo_pim.* TO akeneo_pim@localhost;

FLUSH PRIVILEGES;

exit

Case-2 – If you are using AWS RDS

Here we create a dbuser, database in AWS RDS for Akeneo and give privileges to the dbuser.

mysql -u admin -p -h RDS_end_point

CREATE USER 'akeneo_pim'@'%' IDENTIFIED BY 'your_secure_password';

ALTER USER 'akeneo_pim'@'%' IDENTIFIED WITH mysql_native_password BY 'your_secure_password';

CREATE DATABASE akeneo_pim;

GRANT ALL PRIVILEGES ON akeneo_pim.* TO 'akeneo_pim'@'%' WITH GRANT OPTION;

FLUSH PRIVILEGES;

exit

Step 3: Install PHP and there required extension

In this step, we add the Ondrej PPA repository.
Install the PHP8.1 version and there required extension.

sudo apt install software-properties-common

sudo add-apt-repository ppa:ondrej/php

sudo apt-get update

sudo apt-get install php8.1-cli php8.1-apcu php8.1-bcmath php8.1-curl php8.1-opcache php8.1-fpm php8.1-gd php8.1-intl php8.1-mysql php8.1-xml php8.1-zip php8.1-mbstring php8.1-imagick

Now we set the memory limit and date.timezone in php.ini for php CLI and FPM

vim /etc/php/8.1/cli/php.ini

memory_limit = 1024M

date.timezone = UTC

vim /etc/php/8.1/fpm/php.ini

memory_limit = 512M

date.timezone = UTC

Enable apache rewrite module and proxy_fcgi

sudo a2enmod rewrite proxy_fcgi

sudo a2enmod rewrite

sudo systemctl restart apache2

Step 4: Install Composer

We install curl, wget, zip, unzip, and net-tools package,
We install Composer with the required version.

sudo apt-get install curl wget zip unzip net-tools -y

sudo curl -sS https://getcomposer.org/installer | php -- --version=2.5.8

sudo mv composer.phar /usr/local/bin/composer

composer -V

Step 5: Install Elasticsearch

We download the GPG key for Elasticsearch packages
Add the Elasticsearch repository to the system
Install elasticsearch after the installation reload the daemon and enable the elastic search service

sudo apt-get install apt-transport-https

sudo wget -qO – https://artifacts.elastic.co/GPG-KEY-elasticsearch | apt-key add –

sudo echo “deb https://artifacts.elastic.co/packages/8.x/apt stable main” | tee -a /etc/apt/sources.list.d/elastic-8.x.list

sudo apt-get update

sudo apt-get install elasticsearch

sudo systemctl daemon-reload

sudo systemctl enable elasticsearch.service

sudo systemctl start elasticsearch.service

sudo systemctl status elasticsearch.service

Verify the proper functioning of Elasticsearch by executing the below command.

1 2	curl -XGET 'http://localhost:9200' sudo systemctl restart elasticsearch.service

you can run the below commands to increase the MAX_MAP_COUNT Linux kernel setting. Proceed as follow.

sudo sysctl -w vm.max_map_count=262144

sudo echo "vm.max_map_count=262144" | tee /etc/sysctl.d/elasticsearch.conf

sudo systemctl restart elasticsearch

Step 6: Install Node

Here we install Node version 18.x

sudo curl -sL https://deb.nodesource.com/setup_18.x -o nodesource_setup.sh

sudo bash nodesource_setup.sh

sudo apt-get install -y nodejs

node -v

Step 7: Install Yarn

Here we install Yarn

curl -sL https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add -

echo "deb https://dl.yarnpkg.com/debian/ stable main" | tee /etc/apt/sources.list.d/yarn.list

apt update && apt-get install yarn

yarn -v

Now create a user for Akeneo, you can set a password, and rest of the field simply press enter

1	sudo adduser akeneo

Download the PIM in the user directory

Download the Akeneo PIM as your required version, here we download version 7
Extract the tar file.
And fill in your DB details in .env.local file to communicate with the database.

cd /home/akeneo

wget https://download.akeneo.com/pim-community-standard-v7.0-latest-icecat.tar.gz

tar -xvzf pim-community-standard-v7.0-latest-icecat.tar.gz

cd pim-community-standard

cp -r .env .env.local

Now make the changes in the (.env.local) file as per your configuration.
When you open the (.env.local) file you will see a file like below, now you need to change it accordingly below SS for your reference.

AKENEO_PIM_URL=http://localhost:8080 #use your public_IP or domain as well.

APP_DATABASE_HOST=mysql #define localhost or RDS string as per you uses.

APP_DATABASE_NAME=akeneo_pim #define your akeneo database.

APP_DATABASE_PASSWORD=akeneo_pim #define your akeneo db password.

APP_DATABASE_USER=akeneo_pim #define your akeneo db user.

APP_INDEX_HOST=elasticsearch:9200 #change as localhost:9200

Now create a virtual host file for Apache Click here

Here we create virtual hosting for our domain in this case we are using public IP, you can define your own domain.
Define the document root and directory path, where you want to install the PIM.

1	sudo vim /etc/apache2/sites-available/akeneo-pim.local.conf

After creating a virtual host for Akeneo, Add the below syntax in apache.conf to define the user home directory.

Make changes in the Apache envvars file as per your user

user need to define in php fpm as user, group, listen.owner, and listen.group

1	vim /etc/php/8.1/fpm/pool.d/www.conf

change the permission as per your user

Set the owner and group owner for php fpm.
Enable the conf file which you create for your domain and restart the Apache service.

sudo chown -R akeneo:akeneo /etc/php/8.1/fpm/pool.d/www.conf

sudo chown -R akeneo:akeneo /var/run/php/php8.1-fpm.sock

service php8.1-fpm restart

cd /etc/apache2/sites-available

a2ensite akeneo-pim.local.conf

apache2ctl -t

a2enmod rewrite

systemctl restart apache2

Go to the user home directory where you define the document root path

cd /home/akeneo/pim-community-standard

apt-get install make

NO_DOCKER=true make

Now define the user and directory permission

1	chown -R akeneo:akeneo pim-community-standard

Now hit the URL “http://your_public_IP/” on the browser, and finally, you have successfully set up Akeneo PIM.

Need Support?

Thank You for reading this Blog!

For further more interesting blogs, keep in touch with us. If you need any kind of support, simply raise a ticket at https://webkul.uvdesk.com/en/.

You may also visit our Odoo development services and quality Odoo Extensions.

For further help or query, please contact us or raise a ticket.