diff --git a/README.md b/README.md index 912f0717e..8104588be 100644 --- a/README.md +++ b/README.md @@ -46,7 +46,7 @@ With a user logged in to existing Kubernetes or Openshift environment with Forkl # set this variables if you use a different cluster. export INVENTORY_SERVER_HOST=https://virt-konveyor-forklift.apps. export SERVICES_API_SERVER_HOST=https://virt-konveyor-forklift.apps. -export CONSOLE_IMAGE=quay.io/openshift/origin-console:4.15 +export CONSOLE_IMAGE=quay.io/openshift/origin-console:4.18 # Run the web console locally (uses the enviorment variables we defined above) yarn console @@ -58,6 +58,19 @@ yarn build yarn start ``` +#### How to find the cluster address + +The cluster address will be the part of the address after the `apps.` or `api.` in the cluster services or API service address. + +For example, if your cluter API address is `api.example.com:6443`, the cluster address will be `example.com`, and +the inventory service address will be: + +``` bash +export INVENTORY_SERVER_HOST=https://virt-konveyor-forklift.apps.example.com +``` + +Note: use this method to find the inventory and services address when using an Openshift cluster, when using K8s use the inventory service address. + ## Setup a local cluster for development Forklift console plugin requires the user to be logged into an openshift or kubernetes cluster, if you do not have access to one, you can setup your own using [Openshift local]( https://developers.redhat.com/products/openshift-local/overview) or use the CI script to build a local [KinD](https://sigs.k8s.io/kind) cluster. diff --git a/docs/cli-tools.md b/docs/cli-tools.md index 8a6147ab0..cd2a5df28 100644 --- a/docs/cli-tools.md +++ b/docs/cli-tools.md @@ -87,3 +87,21 @@ sudo install crc-linux-2.10.1-amd64/crc /usr/local/bin/crc crc setup crc start ``` + +## How to increase the inotify.max_user_watches and inotify.max_user_instances sysctls + +When running the forklift development on local workstation machine, you may hit inotify limits. + +To edit the `inotify` limits edit the file `/etc/sysctl.conf` and add the limits you need, for example: + +``` +# Add this lines to /etc/sysctl.conf +fs.inotify.max_user_watches=524288 +fs.inotify.max_user_instances=8192 +``` + +And then restart the service: + +```bash +sudo sysctl -p +``` \ No newline at end of file diff --git a/docs/setup-local-nfs-server.md b/docs/setup-local-nfs-server.md new file mode 100644 index 000000000..c2c9f4caf --- /dev/null +++ b/docs/setup-local-nfs-server.md @@ -0,0 +1,16 @@ +# Local NFS server for forklift CI tasks + +Some forklift CI tasks require an NFS server running on the localhost exporting the directory /home/nfsshare, +to set up this NFS server on fedora, see the bash example below: + +``` bash +sudo dnf install nfs-utils -y + +sudo mkdir -p /home/nfsshare +sudo chown -R nobody:nobody /home/nfsshare +sudo chmod 777 /home/nfsshare +sudo bash -c 'echo "/home/nfsshare *(insecure,rw,no_root_squash)" >>/etc/exports' +sudo exportfs -a + +sudo systemctl restart nfs-server +```