"Unable to create workspaces directory" reported by ESP WEB UI
Article ID: 443930
Updated On:
Products
Issue/Introduction
After upgrading to ESP WEB UI 2.0.0, the WEB UI STC failed with error below:JVMJZBL1023N Invoking org.springframework.boot.loader.launch.JarLauncher.main()...JVMJZBL2010E Exception occurred invoking org.springframework.boot.loader.launch.JarLauncher.main()JVMJZBL2007E Stack trace follows:java.lang.reflect.InvocationTargetException...Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'workspacesRootInitializer' defined in URL [jar:nested:/###/webUI/esp-webui.jar/!BOOT-INF/classes/!/com/broadcom/esp/bff/rest/workspaces/WorkspacesRootInitializer.class]: Unable to create workspaces directory '/###/webUI/workspaces'.This was caused by exception 'java.nio.file.FileSystemException: workspaces: '...........JVMJZBL1047W JZOS batch launcher completed with Java exception, return code=100
Environment
Component: ESP WEB UI
Release: 2.0
Cause
This issue occurs when the product zFS filesystem is mounted as Read-Only (R/O).
By default, the ESP Web UI attempts to create a /workspaces directory within the server's root installation path. If the filesystem does not allow write operations, the workspacesRootInitializer bean fails to initialize, causing the JVM to terminate with RC 100.
Resolution
To resolve this, you must redirect the workspace directory to a writable location using the bff.rest.workspaces.root property.
1. Identify the WEBPROP member used by your ESP Web UI started task.
2. Add the following property to define a custom, writable path for the workspaces:bff.rest.workspaces.root=/your/writable/path/workspaces/
Note: Ensure the user ID associated with the ESP Web UI STC has full Read/Write/Execute permissions for this path.
3. Save the changes to the WEBPROP member.
4. Restart the ESP Web UI started task.
Additional Information
Feedback
