diff --git a/elements/ironic-agent/README.rst b/elements/ironic-agent/README.rst
index 0484adc1..f1fb4258 100644
--- a/elements/ironic-agent/README.rst
+++ b/elements/ironic-agent/README.rst
@@ -16,6 +16,15 @@ Beyond installing the ironic-python-agent, this element does the following:
   in order to support source based installation of ironic-python-agent and its
   dependencies.
 
+This element outputs three files:
+
+- ``$IMAGE-NAME.initramfs``: The deploy ramdisk file containing the
+  ironic-python-agent (IPA) service.
+- ``$IMAGE-NAME.kernel``: The kernel binary file.
+- ``$IMAGE-NAME.vmlinuz``: A hard link pointing to the ``$IMAGE-NAME.kernel``
+  file; this is just a backward compatibility layer, please do not rely
+  on this file.
+
 .. note::
    The package based install currently only enables the service when using the
    systemd init system. This can easily be changed if there is an agent
diff --git a/elements/ironic-agent/cleanup.d/99-ramdisk-create b/elements/ironic-agent/cleanup.d/99-ramdisk-create
index a53800ee..7f8fcdbe 100755
--- a/elements/ironic-agent/cleanup.d/99-ramdisk-create
+++ b/elements/ironic-agent/cleanup.d/99-ramdisk-create
@@ -24,4 +24,10 @@ sudo find . -name "*.pyc" -or -name "*.pyo" -delete
 sudo find . -path ./sys -prune -o -path ./proc -prune -o -path './tmp/*' -prune -o -path './boot/*' -prune -o -path './root/*' -prune -o -path './usr/lib/locale/*' -prune -o -path './usr/share/doc/*' -prune -o -path './usr/share/man/*' -prune -o -path './usr/share/info/*' -prune -o -path './usr/share/licenses/*' -prune -o -path './usr/share/misc/*' -prune -o -print | sudo cpio -o -H newc | gzip > ${IMAGE_PATH}.initramfs
 
 select_boot_kernel_initrd $TARGET_ROOT
-sudo cp $BOOTDIR/$KERNEL ${IMAGE_PATH}.vmlinuz
+sudo cp $BOOTDIR/$KERNEL ${IMAGE_PATH}.kernel
+
+# TODO(lucasagomes): Create a hard link for the .vmlinuz file to keep
+# it backward compatible. Remove it after it has been consistent and
+# documented in both places for at least one full OpenStack release cycle
+echo "WARNING: The kernel extension .vmlinuz has been deprecated. Please rely on the file with the extension .kernel instead."
+sudo ln ${IMAGE_PATH}.kernel ${IMAGE_PATH}.vmlinuz