Get PIM Enterprise Edition (EE) archive

This document provides step by step instructions to obtain an archive of the PIM Enterprise Edition.

#Give access to the project console

#The project console

The project console is the place in your Portal where you can manage the accesses to your project such as the Enterprise Repository and get the bootstrap archive. It can also be used to configure your cloud instances and helpdesk access.

#Add developers to the project console

Supervisors or project managers can allow developers to work on the Akeneo PIM project source code.

The users that are allowed to access the project console are named the console users.

As a supervisor, you are able to create new users on the portal and add them to the console user group so that they can access the project console. You can do it by going to My Company / Contacts / Add Contact, fill in the form, select the Console user group and activate it by clicking on the red X in the user list.

On a project, both the customer and the system integrator that are identified with the project are autonomous to give access to get the Enterprise Edition.

#Access to the project on the project console

If you don't have access to the project and if you are neither a supervisor nor a project manager, you should ask the Project Manager to get you listed under the Enterprise Repository / SSH Key Access subtab. You can check who the project manager is in the properties tab of the Project, you can also check who the supervisor is within your company by going on My Company / General Information and looking in the Supervisors section.

  • To access the Console, from the Portal, go to Project console / Projects
  • Choose the corresponding project

Projects list

#Give access to the Enterprise Repository

When you start a project, you need to get the bootstrap archive from the Enterprise Repository. You will need to install Akeneo PIM from this archive which can only be done by users whose ssh keys have been added to the Enterprise Repository. The access to the Enterprise Repository is handled by composer and git.

#Import my public key

Each user wanting to get the bootstrap archive has to share their SSH public key with Akeneo first.

  1. Login to your Portal
  2. Click on your Username in the top right corner.
  3. Select Manage Public Keys
  4. Click on Add a new public key
  5. Give the key a name, an email and the associated public key file content (usually located at ~/.ssh/id_rsa.pub)
  6. Click on save

Import public key as console user

#Add permissions to install the project with the public keys

As a project manager or a supervisor, you can allow console users to access the project by selecting their SSH Key for the project. Each developer who accesses the Enterprise Repository needs to have their ssh key authorized. Each SSH Key needs to be linked to a console user.

  1. On the left menu, go to Project console / Projects and select your project.
  2. Go to the Enterprise Repository tab, and SSH Key Access sub-tab.

SSH Key Access list

  1. Click on Add contact key
  2. Select a contact

Select a contact

Only active users created under your company, with a console user profile are going to be listed.

Then you have two possibilities: select a user's existing public key, or add a new public key to the user

Public key choice

  • First option, select an existing public key already attached to your contact profile: click on Select existing Public Key

Selection of an existing public key

  • Second option, click on Import a new Public Key and fill in the public key details.

Import of a new public key for a user

  1. After the form has been filled, click on Add contact key
  2. Each time a console user joins a new project, an email is sent to inform them of the access granted.

The authorization is effective soon after the change on the project console. During this time, you can see that the action is in progress with the status Activation pending.

#Request an archive on the Enterprise Repository

Once the users have access to the Enterprise Repository, they will be able to request an archive.

  1. On the leftside menu, go to Project console / Projects and select your project.
  2. Open the Enterprise Repository / Properties sub-tab.
  3. Look for the Get archive by email button on the right side of the screen.
  4. Click on it, you will be invited to select one PIM EE version.

Selection of a version

Once this is done, a completeness message will be displayed. The bootstrap archive will be sent to your email within 5 minutes. Sometimes it could take a bit more time, but always check your spam folder before requesting the bootstrap again.

We strongly recommend that you choose the latest LTS version.

Then you can install the project by following the installation guide.

#Get the log of the activities on the Enterprise Repository

On the Enterprise Repository, on the Activity Log sub-tab, you can see the history of all the actions done: archive access granted, archive download, ssh key access changes...

Enteprise repository activity log