Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

error message #1177

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions docs/installation/standalone.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -347,6 +347,17 @@ Later we will access KubeVela on local machine, we will install vela CLI on loca

</details>

<details>
<summary>possible error and troubleshooting</summary>

```
Installing VelaD:
Error: "velad: command not found" - This may occur if the velad binary is not in your system PATH. To resolve this, make sure that the binary is in your system PATH by following the installation instructions carefully.
Error: "velad is not executable" - This may occur if the velad binary does not have the correct permissions. To resolve this, make sure that the binary has executable permissions by running the following command: "chmod +x velad".
```

</details>

### 3. Install VelaUX

VelaUX is a dashboard for KubeVela. It is a web application that runs in your cluster. You can access it with your browser.
Expand Down Expand Up @@ -396,6 +407,17 @@ VelaUX needs authentication. The default username is `admin` and the password is

It requires you to override with a new password for the first login, please make sure to remember the new password.

<details>
<summary>possible error and troubleshooting</summary>

```
Installing VelaUX:
Error: "unable to find velaux addon" - This may occur if there is an issue with locating the velaux addon. To resolve this, make sure that the velaux addon is installed properly by running the "vela addon enable ~/.vela/addons/velaux" command. If the issue persists, check the advanced installation arguments for the velaux addon.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What command will report "unable to find velaux addon"?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If vela addon enable ~/.vela/addons/velaux report "unable to find velaux addon"

Copy link
Member

@chivalryq chivalryq Feb 23, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

make sure that the velaux addon is installed properly by running the "vela addon enable ~/.vela/addons/velaux

This is a bit confusing. VelaD packed a velaux addon with it and unzip it to ~/.vela/addons/velaux when velad install. Advice here should be more clear.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"To resolve the "unable to find velaux addon" error during VelaUX installation, you can try running the following command to enable the velaux addon: "vela addon enable ~/.vela/addons/velaux". This addon should have been installed automatically by VelaD during its installation process. If the issue persists, try reinstalling VelaD."

Is this clear?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This addon should have been installed automatically by VelaD during its installation process.

This is wrong! addon is unpacked to local directory, not "enabled" (or installed) by velad install by default. User can decide to enable it or not. If they do, they can run vela addon enable ~/.vela/addons/velaux.

Besides, you said "vela addon enable ~/.vela/addons/velaux" causes this error. You shouldn't ack user to run it again to solve it.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Understood!

Error: "vela port-forward: command not found" - This may occur if the vela CLI is not properly installed or added to your system PATH. To resolve this, make sure that the vela CLI is installed and added to your system PATH by running the "velad install" command.
```

</details>

### 4. Access cluster From Local (Optional)

You can access KubeVela with your local machine. Make sure you add `--bind-ip` when executing `velad install` command in the last step on the server.
Expand Down