The following sections contain workarounds for issues that you might encounter when you use Codewind. If you don’t see your issue here, please check our GitHub repository. If you still don’t see your issue, you can open a new issue in the repository.
- Installing Codewind
- Creating a new project
- Importing a project
- Understanding Application Metrics
- Checking the application and build statuses
- Editing your project
- Disabling development on specific projects
Installer fails with mount issues on Windows
If you try to install Codewind on Windows 10 and use Docker, you might see the following error:
ERROR: for codewind-performance Cannot start service codewind-performance: b"error while creating mount source path '/host_mnt/c/codewind-workspace': mkdir /host_mnt/c: file exists" ERROR: for codewind-performance Cannot start service codewind-performance: b"error while creating mount source path '/host_mnt/c/codewind-workspace': mkdir /host_mnt/c: file exists" Encountered errors while bringing up the project.
Workaround: Enter the following command and install again:
- Enter the
docker volume rm -f /host_mnt/ccommand.
- Restart Docker and run the installer again.
If the command and another installation attempt don’t succeed, complete the following steps instead:
- Uninstall Codewind and remove all the images with the
docker system prune -acommand.
- From the Docker settings dialog box, reset Docker to the factory default to resolve the mount issues.
For more information, see this issue about Docker mounts on Windows.
Docker Shared Drive not accepting OS credentials for Windows
When using OS authentication setups (for example, AzureAD), Docker Shared Drive might not accept your OS credentials.
Workaround: Create a new user account.
- Navigate to Settings -> Accounts -> Family & other people -> Add someone else to this PC -> I don’t have this person’s sign-in information -> Add a user without a Microsoft account.
- Create the new account with the same username but without the prefix (for example, if your AzureAD account is
AzureAD/BobSmith, your new local account should be
BobSmith). Use the same password as your other account.
- Select your new local account and click Change account type. Select the dropdown menu and select Administrator. Share the drive again in Docker.
Unable to create multiple Codewind workspaces on Docker Desktop Kubernetes
When running a Docker Desktop local Kubernetes cluster, multiple Codewind workspaces may fail to start.
Workaround: Use only one Codewind Che workspace on Docker Desktop for the time being, or use an alternative local Kubernetes cluster such as Minikube or Minishift. Due to how Docker Desktop handles networking, multiple Codewind workspaces may cause a collision on the port that it’s running on.
Creating a new project
Projects created never start after installing Codewind
Intermittently, after installing Codewind on Windows, projects can be created, but they never start and instead remain in the Starting state. A Docker issue for Windows exists where, although it shows a volume is mounted, it does not allow any writing to the volume. To check if this issue is present, verify that a
codewind-workspace exists (in your $HOME directory on Mac/Linux, or the root of your C: directory on Windows) and verify you can see your project folders created within.
Workaround: This issue can appear for many reasons, so you have many possible workarounds. First, open the
Shared Drives directory to confirm that you have a shared drive. If you have one selected, unselect it, click Apply, and then try creating projects again. If you’re still noticing the problem, and you’re using an ID for the shared drive that is not your current user, check that the ID being used doesn’t have an expired password that requires a password reset. Reset the password if necessary.
Codewind Che extension loses connectivity to the Codewind pod
The Codewind Che extension might lose connectivity to the Codewind pod during a Lagom or Swift project build if you have multiple projects in the workspace for each runtime type. When this issue occurs, the project tree says Disconnected.
Workaround: Refresh the projects list to have the tree repopulate. If the issue persists, refresh the webpage.
Importing a project
Imported project never builds or starts
To view the status of the imported project, enter the following command:
docker logs codewind-pfe
Workaround: If you see the following messages, the imported project is likely not a valid Codewind project.
build-log requested, no build log found for project <project name> build-log requested, no build log found for project <project name> build-log requested, no build log found for project <project name> build-log requested, no build log found for project <project name> No containerId for running project <project name>
For more information about valid Codewind projects, see Imported projects and supported project types.
Understanding Application Metrics
Application Monitoring unavailable after Project Import
After importing an application, when you click
App Monitor, the dashboard is not displayed and results in a
Cannot GET /appmetrics-dash/ error. If this error appears, the application was not created by Codewind or previously had AppMetrics integration.
Profiling markers do not appear
If you have the Codewind Language Server for Node.js Profiling extension enabled and have run a load test, profiling markers still might not appear. Ensure that your project and load run conform to the following requirements to use profiling:
- Your project exists in Theia or VS Code. Profiling is available only in Theia and VS Code.
- Your project is a Node.js project that was created through Codewind.
- Your project has
Run Loadexecuted on it.
- The load run successfully completed. Profiling data is written to the
load-test/<datestamp>/profiling.jsonfile in your Codewind project only on a successfully completed load run. If the load run was cancelled, it won’t be written to the workspace.
- The load run ran for a minimum of 45 seconds to gather enough profiling data to generate the
- If a function runs quickly, in less than 5 milliseconds with the default configuration, then the function might not run during any of the samples, so it might not be included in the profiling data for that load run.
- Profiling is not disabled. To enable profiling, access the profiling in one of the following ways:
- Right-click in the editor and select
- Open the command palette with
cmd+shift+pon a Mac or
ctrl+shift+pon Windows. Then, select
Codewind: Profiling: Toggle Profiling.
- Toggle the
Codewind Profiling: Show Profilingsetting in the extensions settings.
- Right-click in the editor and select
Workaround: Review the preceding list and ensure that your project conforms to all of the items in the list.
Checking the application and build statuses
Microprofile project gets updated twice upon file change
If you modify files in Microprofile projects, sometimes the project gets double updates. You might see the application status changed from Running to Stopped twice. If you notice this status change, the default polling rate, which is 500 ms, is too short for the application monitor.
Workaround: Increase the polling rate in the
server.xml file to 1000 ms or longer.
<applicationMonitor pollingRate="1000ms" />
Editing your project
Theia editor might not work correctly in Microsoft Edge
Theia, the open source code editor used by Che, currently has limited support for Microsoft Edge. The Theia team is aware of the issue and is working to fix it.
Workaround: Use a different web browser.
New projects sometimes do not show in Theia hierarchy view
Sometimes when a new project is created, it doesn’t show up in the hierarchy view within Eclipse Che.
Workaround: Refresh the page in the browser.
Context Root / Application Endpoint not correct
If you create or bind a project which has a context root set in
.cw-settings, such as a project using the Lagom template, the context root is not picked up initially. This also happens after restarting Codewind.
Workaround For Eclipse. add the context root to the URL in your browser. For example, the browser might open with
localhost:34567 instead of
localhost:34567/mycontextroot so type
mycontextroot. For VS Code and Theia, edit and save the
.cw-settings file, and the context root updates.
Disabling development on specific projects
Turning off auto build has no effect for Node.js projects when you run Codewind locally
If you turn off
auto build for a Node.js project when you run Codewind locally, it has no effect. Changes you make to your code automatically start or restart a build even though
auto build is disabled.