Skip to content
This repository was archived by the owner on Nov 28, 2022. It is now read-only.

Commit a1f7c09

Browse files
authored
WIP [0.9.0]: Added to Troubleshooting's Projects stuck in starting or stopped state (#360)
* added content to Signed-off-by: Jacob Berger <jacob.berger@ibm.com> * applied feedback Signed-off-by: Jacob Berger <jacob.berger@ibm.com> * last change Signed-off-by: Jacob Berger <jacob.berger@ibm.com>
1 parent 94c2c85 commit a1f7c09

File tree

1 file changed

+37
-0
lines changed

1 file changed

+37
-0
lines changed

docs/_documentations/troubleshooting.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -158,6 +158,43 @@ You might occasionally see projects stuck in the `Starting` or `Stopped` state e
158158
1. In the **Codewind Explorer** view, right-click your project and select **Build**.
159159
2. Wait for the project state to return to **Running** or **Debugging** in the **Codewind Explorer** view.
160160
161+
<!--
162+
Action/Topic: Checking the application status
163+
Issue type: bug/info
164+
Codewind version: 0.9.0
165+
Issue link: https://github.com/eclipse/codewind/issues/1269
166+
-->
167+
## How to stop the app from continuously pinging
168+
With all the stacks and templates Codewind offers, some template applications come with no server, like Appsody Node.js. The backend in PFE expects all applications to have a server. Thus, the backend continuously pings the port of the application retrieved from the application's container information. Since no server is available to ping on that port, the application times out and is stuck on `Starting`.
169+
170+
**Workaround** Disable the pinging of your application stuck on the `Starting` state:
171+
1. Edit the `.cw-settings` file under the application, and set the key `internalPort` to `-1`.
172+
- This key forces the application to stop, stops pinging the application, and bypasses the timeout error.
173+
2. Once you implement the server into the application, resume the application ping and run it by setting `internalPort` to `""` for the default port of the container. Or you can choose a specific port you want to ping.
174+
175+
<!--
176+
Action/Topic: Checking the application status
177+
Issue type: bug/info
178+
Codewind version: 0.9.0
179+
Issue link: https://github.com/eclipse/codewind/issues/1269
180+
-->
181+
## How to create a .cw-settings file if it does not exist
182+
Prior to the 0.9.0 release, non-Codewind stacks, like Appsody and OpenShift Do (odo), did not come with a .cw-settings. If you have a project from those stacks from a previous release, you need to create the .cw-settings file. The file must reside under the project root directory.
183+
184+
**Workaround** Create a template .cw-settings file with the following contents:
185+
186+
```
187+
{
188+
"contextRoot": "",
189+
"internalPort": "",
190+
"healthCheck": "",
191+
"isHttps": false,
192+
"ignoredPaths": [
193+
""
194+
]
195+
}
196+
```
197+
161198
<!--
162199
Action/Topic: Creating a project and/or Checking the application and build statuses
163200
Issue type: bug/info

0 commit comments

Comments
 (0)