Adding APOC to Neo4J via Docker Compose

[VoLKyyyOG]

Hey all!

New to Amundsen and docker-compose. I was wondering how one might install APOC for Neo4J server in the docker-amundsen.yml. I'm picking up an existing code base and working on exporting the backend database.

I understand that the installation steps are here:

• https://neo4j.com/labs/apoc/4.1/installation/#neo4j-server
• https://neo4j.com/developer/docker/

I then modified the existing docker-amundsen.yml to include:

      ...
      container_name: neo4j_amundsen
      environment:
        - NEO4J_AUTH=...
        - NEO4J_apoc_export_file_enabled=true
        - NEO4J_apoc_import_file_enabled=true
        - NEO4J_apoc_import_file_use__neo4j__config=true
        - NEO4JLABS_PLUGINS='["apoc"]'
      ulimits:
      ...
      volumes:
          - ./example/docker/neo4j/conf:/var/lib/neo4j/conf:Z
          - ./example/docker/neo4j/plugins:/var/lib/neo4j/plugins:Z
          - ./example/backup:/backup:Z
          - neo4j_data:/data

AFAIK, the :Z in volumes is used here to map our bastions.

Relevant Information:

• Amundsen Neo4J Server Version: 3.5.26
• This means I need APOC Version 3.5.0.11

Current Steps:

1. Once saved, I ran docker-compose -f PATH_TO_THE_YML up and launched the Neo4J UI via http://localhost:7474/browser.
2. Logged in with the specified credentials (i.e default neo4j and test) and ran a query which worked.
3. I then tried to call the apoc package with CALL apoc.help('keyword') but it returns error Neo.ClientError.Procedure.ProcedureNotFound -> There is no procedure with the name apoc.help registered for this database instance. Please ensure you've spelled the procedure name correctly and that the procedure is properly deployed.

I have a hunch its something to do with volumes and the plugins not being properly specified, though, I'm not there in figuring out the root cause.

Would appreciate any guidance or pointers.

Cheers!

[VoLKyyyOG]

Relevant SO thread: https://stackoverflow.com/questions/36897634/there-is-no-procedure-with-the-name-apoc-help-registered-for-this-database-ins

AFAIK this corresponds to amundsen/example/docker/neo4j/conf/neo4j.conf where you can set the config:

dbms.directories.plugins=/var/lib/neo4j/plugins

Looks like its a corresponding .jar issue with both apoc 3.5.0.11 and 3.5.0.17 (https://github.com/neo4j-contrib/neo4j-apoc-procedures/releases?q=3.5.26+&expanded=true)

https://community.neo4j.com/t/cannot-install-apoc-3-4-0-4-on-neo4j-community-3-5-1/4071/4

[VoLKyyyOG]

OKAY so I have figured out the issue after following the following steps, I hope this resolves any issues that you may have:

• The APOC plugin must be directly downloaded to amundsen/docker/neo4j/plugins
• Because Amundsen cannot use neo4j:4.1.x and is stuck on neo4j:3.5.26, we will need apoc 3.5.0.17 (latest as of April 2022).
• However, it is known that the github .jar downloaded by curl results in a redirect. Please ensure you check the sha1sum of the downloaded file here. For my specific version, I was expected sha1sum=dc66fb7f967bd4e6a96fd007b76176b1e775ab0e.
• To do so, run curl -O -L https://github.com/neo4j-contrib/neo4j-apoc-procedures/releases/download/3.5.0.17/apoc-3.5.0.17-all.jar in the plugins directory.
• Now, it should work!

[MrwanBaghdad]

You can configure the extensions provided by neo4j labs by passing the NEO4JLABS_PLUGINS env variable as explained in the docker image's entry point script
In short for your case, the env var needs to be passed is NEO4JLABS_PLUGINS='["apoc"]'