search string side menu

ELMA365 On-Premises > ELMA365 On-Premises Enterprise > Install add-on components for ELMA365 / Install R7-Office document server

Install R7-Office document server

The R7-Office Document Server is used for online work, includes viewers and editors for text documents, spreadsheets, and presentations. It is fully compatible with the .docx, .xlsx, .pptx formats, and allows editing documents in real-time.

Начало внимание

Prior to installation, register the full domain name and obtain an SSL certificate issued for it.

Конец внимание

The installation consists of three steps:

  1. Download the Helm chart and configuration file.
  2. Fill out the configuration file.
  3. Install the r7-office chart using Helm in the Kubernetes cluster.

Step 1: Download the Helm chart and configuration file

For installation via the internet, obtain the configuration file values-r7office.yaml by executing the command:

helm repo add elma365 https://charts.elma365.tech
helm repo update
helm show values elma365/r7office > values-r7office.yaml

Getting the configuration file for installation in a closed-loop environment without internet access

  1. On a computer with internet access, download the archive of the latest version of the r7-office  chart from the ELMA365 repository by executing the following command:

helm repo add elma365 https://charts.elma365.tech
helm repo update
helm pull elma365/r7office

  1. Copy the obtained chart archive r7office-X.Y.Z.tgz to the server where the installation will be performed.
  1. Unpack this chart and copy the default configuration file values.yaml  to values-r7office.yaml:

tar -xf r7office-X.Y.Z.tgz
cp r7office/values.yaml values-r7office.yaml

Step 2: Fill out the configuration file

Fill out the configuration file values-r7office.yaml for installing r7-office.

## r7office settings
r7office:
  ingress:
    ## Enabling the host in ingress
    enabled: true
    className: ""
    annotations:
      kubernetes.io/ingress.class: nginx
    ## Annotations for cert-manager operation
    # certmanager.io/cluster-issuer: letsencrypt
    hosts:
      ## Annotations for cert-manager operation
      - host: example.ru
        paths:
          - path: /
            pathType: ImplementationSpecific
    ## Enable encryption; when using cert-manager, specify the certificate used secretName letsencrypt
    tls:
      - secretName: elma365-onpremise-tls
        hosts:
          - example.ru
  ## Enable the creation of a secret with your own certificates
  ## Specify the path to the certificate in the lines key: and cert:
  secret:
    enabled: true
    key: "files/my_cert.key"
    cert: "files/my_cert.crt"
  ## Set the value to true when using self-signed certificates for your storage
  unautorizedStorage: false
  ## Number of replicas for high availability
  replicaCount: 1
  ## Enabling the use of JWT token
  jwtEnabled: false
  ## If a license file is present, set the enable: parameter to true
  ## Specify the path to the license in the line licensePath:
  license:
    enable: false
    licensePath: "files/license.lic"
...

Filling out connection parameters to the private registry for installation in a closed-loop environment without internet access

To connect to the private registry you need to:

  1. Download ELMA365 images and upload them to your local image registry. For more details, see Download ELMA365 images.
  1. Set the address and path for the parameter r7office.image.repository.
  1. Specify the name of the secret with access rights to the private registry in the parameter r7office.image.pullSecrets. The secret must be created manually and encrypted in Base64.

## r7office settings
r7office:
...
  ## Connection parameters to the private registry
  image:
    ## Address and path for the private registry
    repository: registry.example.com/r7office/documentserver-ee
    tag: "7.3.3.59"
  ## Secret with access rights to the private registry must be created manually, encrypted in Base64
  pullSecrets:
    - myRegistryKeySecretName

where repository format is:

  • address is registry.example.com;
  • path is /documentserver-ee.

Step 3: Install the r7-office chart using Helm in the Kubernetes cluster

Perform the installation of the r7-office chart in namespace r7office.

For online installation:

helm upgrade --install r7office elma365/r7office -f values-r7office.yaml -n r7office

For offline installation without internet access, go to the directory with the downloaded chart and execute the command:

helm upgrade --install r7office ./r7office -f values-r7office.yaml -n r7office

Начало внимание

The installation of the R7-Office component does not automatically include the integration of the document server with the ELMA365 application.

After installation, integrate the R7-Office document server with the R7-Office module in the ELMA365 application.

For full functionality, purchase the R7-Office license.

Конец внимание

Delete r7-office chart using helm in a Kubernetes cluster

Начало внимание

Before deleting the R7-Office component, disable the use of the R7-Office module in the ELMA365 application.

Конец внимание

To delete the r7-office chart in namespace r7office, execute the command:

helm uninstall r7office -n r7office

install-cert-manager.html install-onlyoffice.html

Found a typo? Highlight the text, press ctrl + enter and notify us