此内容没有您所选择的语言版本。

Chapter 5. Installing Red Hat Offline Knowledge Portal


Before installing Red Hat Offline Knowledge Portal in a disconnected environment, you must temporarily connect to the Internet from a secure system to download the Red Hat Offline Knowledge Portal container image and obtain your access key. Then, you can transfer the image to your disconnected environment by using the secure methods specified by your organization.

Red Hat Satellite subscription required

Red Hat Offline Knowledge Portal is a separate, complimentary product available as an add-on to your Red Hat Satellite subscription. You do not need to install Red Hat Satellite to use Red Hat Offline Knowledge Portal.

To confirm whether you have an active Red Hat Satellite subscription, search for Stock Keeping Unit (SKU) MCT3718 in Red Hat Subscription Manager. If you want to buy a Red Hat Satellite subscription with the Red Hat Offline Knowledge Portal Add-On, contact the Red Hat Sales team.

Prerequisites

Procedure

  1. To get your access key, navigate to the Red Hat Offline Knowledge Portal Access Key Generator, and select the Generate key button.

    Important

    You only need one access key. After you generate your access key, the Red Hat Offline Knowledge Portal Access Key Generator retrieves the key already bound to your Red Hat account.

    If your access key is compromised, report a bug to unbind your access key, so you can generate a new one.

  2. To download Red Hat Offline Knowledge Portal from your terminal using Podman:

    1. If needed, log in to registry.redhat.io using your Customer Portal, Red Hat Developer, or Registry Service Account credentials:

      $ podman login registry.redhat.io
      username: <username>
      Password: <password>
      Login Succeeded!
      Copy to Clipboard Toggle word wrap
    2. Pull the image:

      $ podman pull registry.redhat.io/offline-knowledge-portal/rhokp-rhel9:latest
      Copy to Clipboard Toggle word wrap
  3. To convert the image to a file that you can transfer to your offline environment, save the image to a tar file:

    podman save --format oci-archive -o rhokp.tar rhokp-rhel9:latest
    Copy to Clipboard Toggle word wrap
  4. To load the image in your offline environment:

    podman load -i rhokp.tar
    Copy to Clipboard Toggle word wrap
  5. To use your own SSL/TLS certificates, you must create a local httpd-ssl/ directory to store your certificates:

    httpd-ssl/ 
    1
    
    ├── certs
    │   └── <cert_filename>.pem 
    2
    
    └── private
       └── <key_filename>.pem
    Copy to Clipboard Toggle word wrap
    1
    The directory name must be exact.
    2
    Your cert and key filenames must have a .pem extension.
    Important

    Red Hat Offline Knowledge Portal reverts to the default SSL/TLS key pair if it cannot detect the certificate files.

  6. Enter the following podman run command with your access key:

    $ podman run --rm -p 8080:8080 -p 8443:8443 \
    -v ./httpd-ssl:/opt/app-root/httpd-ssl:Z \ 
    1
    
    --env "ACCESS_KEY=<your_personal_access_key>" \ 
    2
    
    --name <red_hat_offline_knowledge_portal> \ 
    3
    
    -d registry.redhat.io/offline-knowledge-portal/rhokp-rhel9:latest
    Copy to Clipboard Toggle word wrap
    1
    If you’re using your own SSL/TLS certificates rather than the default, this portion of the command mounts a volume for the SSL/TLS certificates in your local httpd-ssl/ directory.
    2
    The podman run command includes your access key. Without the correct access key, you cannot view encrypted content or use certain features, such as search.
    3
    The --name parameter is optional.
  7. Wait about 30 seconds for the container to start.

Validation

  1. In your browser, access Red Hat Offline Knowledge Portal at http://localhost:8080 or https://localhost:8443.
  2. To examine the Podman container log, run the following command:

    $ podman logs <container>
    Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat