Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commit 06c86cc

Browse files
Merge pull request #43 from oracle/rm/Linux-install
linux install
2 parents 11db22a + 152fcbf commit 06c86cc

File tree

2 files changed

+65
-0
lines changed

2 files changed

+65
-0
lines changed

‎documentation/1.0/content/setup/install.md‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,47 @@ description: "Install the WKT UI application and check for updates."
99
1. Download the latest WebLogic Kubernetes Toolkit UI (WKT UI) application installers from the [GitHub Releases section](https://github.com/oracle/weblogic-toolkit-ui/releases) of this repository.
1010
2. Simply run the appropriate installer for your operating system.
1111

12+
If you download and run the `AppImage` file, you get the added benefits of 1.) Not requiring an installation or root access and 2.) Being able to participate in the auto-update functionality like MacOS and Windows.
13+
14+
15+
**NOTE**: On Linux, to get _all_ the dependencies and have them installed in the correct order, you need to use the package manager to install the `rpm` or `deb` file.
16+
First, be sure to review the Linux prerequisites [here]({{< relref "/setup/prerequisites.md" >}}).
17+
18+
- For RPM-based systems, download the latest `wktui` `rpm` package from https://github.com/oracle/weblogic-toolkit-ui/releases, then use either `yum` or `dnf`; for example:
19+
```
20+
sudo yum -y localinstall wktui_1.0.0_amd64.rpm
21+
```
22+
23+
- For Debian-based systems, download the latest `wktui` `deb` package from https://github.com/oracle/weblogic-toolkit-ui/releases, then run:
24+
```
25+
sudo apt install ./wktui_1.0.0_amd64.deb
26+
```
27+
28+
#### Helpful Hints
29+
30+
- When launching the WKT UI application, if you see this:
31+
```
32+
libGL error: No matching fbConfigs or visuals found
33+
libGL error: failed to load driver: swrast
34+
```
35+
This is harmless and can be removed by setting the environment variable:
36+
37+
`export LIBGL_ALWAYS_INDIRECT=1`
38+
39+
40+
- If you are storing credentials in the OS native store, and you see this failure message:
41+
```
42+
Error occurred in handler for 'save-project': Error: Failed to save credential for image.
43+
imageRegistryPushUser: Error: No such interface "org.freedesktop.Secret.Collection" on object at path /
44+
org/freedesktop/secrets/collection/login
45+
at /tmp/.mount_WebLogpIPFto/resources/app.asar/app/js/credentialManager.js:92:32
46+
```
47+
You can solve it by running this command (only once) before launching the WKT UI application:
48+
49+
`dbus-update-activation-environment --systemd DBUS_SESSION_BUS_ADDRESS DISPLAY XAUTHORITY`
50+
51+
### Application Startup
52+
1253
Application startup detects Internet connectivity to GitHub. If it fails to connect, a `Network Configuration` dialog appears in which you can set or modify your proxy settings, test your changes, and then restart the application.
1354
1455
Launching the application displays a thorough "Introduction" to the WKT UI. Step through it or dismiss it; you can peruse it at any time using `Help > Show Introduction`.

‎documentation/1.0/content/setup/prerequisites.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,3 +35,27 @@ In addition to these local software dependencies, you will need a Kubernetes clu
3535
containerized WebLogic Server domain and its applications. If you do not already have a model, then you can either write
3636
one by hand using the WKT UI application or discover the model from an existing domain. Most likely, you'll want to start
3737
with a WebLogic domain that can be used to discover the model from the domain.
38+
39+
#### Linux Prerequisites
40+
41+
For RPM-based systems, such as Oracle, RedHat, CentOS, and some others:
42+
43+
For storing credentials in the OS native credentials store, you must have a desktop environment. If your system does not have a graphical desktop environment,
44+
you can install one; for example, installing GNOME Desktop on Oracle Linux:
45+
46+
https://support.oracle.com/knowledge/Oracle%20Linux%20and%20Virtualization/2717454_1.html
47+
48+
For storing credentials as an encrypted project file, and for a minimum GUI requirement, make sure the following packages are installed in your system:
49+
```
50+
sudo dnf update
51+
sudo dnf install libxshmfence libdrm.x86_64 libgbm alsa-lib xauth atk-devel.x86_64 java-atk-wrapper.x86_64
52+
sudo reboot
53+
```
54+
For Debian-based systems, such as Ubuntu and Debian:
55+
56+
For storing credentials in the OS native credentials store, you must have a desktop environment. If your system does not have a graphical desktop environment,
57+
you can install one; for example, installing GNOME on Ubuntu 20x:
58+
```
59+
sudo apt install gnome-session gdm3
60+
sudo reboot
61+
```

0 commit comments

Comments
(0)

AltStyle によって変換されたページ (->オリジナル) /