Skip to content

Commit cfd14cb

Browse files
authored
Adds option to install UCX in offline mode (#3959)
<!-- REMOVE IRRELEVANT COMMENTS BEFORE CREATING A PULL REQUEST --> ## Changes <!-- Summary of your changes that are easy to understand. Add screenshots when necessary --> ### Linked issues <!-- DOC: Link issue with a keyword: close, closes, closed, fix, fixes, fixed, resolve, resolves, resolved. See https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword --> Resolves #3418 ### Functionality - [ ] added relevant user documentation
1 parent ed964a6 commit cfd14cb

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

docs/ucx/docs/installation/index.mdx

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -200,6 +200,15 @@ PIP_INDEX_URL="https://url-to-company-hosted-pypi.internal" databricks labs inst
200200

201201
During installation reply *yes* to the question "Does the given workspace block Internet access"?
202202

203+
In case if host has no access to github, then ucx installation will not be able to download the files locally and fail.
204+
In order to address that, follow the steps below
205+
- install ucx on a host which has access to github using the instruction above
206+
- zip the installation from ~/.databricks/labs/ucx
207+
- copy the zip file to the target host and unzip
208+
Now the installation can be done in offline mode (ensure databricks cli is upgrade to version v0.244.0 or higher)
209+
```commandline
210+
PIP_INDEX_URL="https://url-to-company-hosted-pypi.internal" databricks labs install ucx --offline=true
211+
```
203212

204213

205214
## Upgrading UCX for newer versions
@@ -237,4 +246,4 @@ Databricks CLI will confirm a few options:
237246
- Whether you want to remove all ucx artefacts from the workspace as well. Defaults to no.
238247
- Whether you want to delete the inventory database in `hive_metastore`. Defaults to no.
239248

240-
![macos_uninstall_ucx](/img/macos_4_databrickslabsmac_uninstallucx.gif)
249+
![macos_uninstall_ucx](/img/macos_4_databrickslabsmac_uninstallucx.gif)

0 commit comments

Comments
 (0)