RPM installation packages

Introduction

For all components except the database and the load balancer, censhare provides RPM packages.

Below is a simplified architecture diagram showing which components are included and which you need to get from a 3d-party provider.

Prerequisites

To retrieve the required RPMs, you need access to the RPM repository. If you do not have any credentials, create a support ticket.

Packages

About the main packages | click to read more

censhare-Common

It will setup a user corpus on your system and create the home directory /opt/corpus for the software. It also provides the startup scripts rccss which can be used as an alternative startup method instead of systemd.

censhare-ImageTools

It has all the dependencies to tools that are needed to create image and office previews. So when you install it, it will also require to install LibreOffice-Online, Ghostscript, ImageMagick, wkhtmltoimage and ExifTool. For LibreOffice-Online an own startup service loolwsd will be installed and activated within systemd. Another dependency is censhare-Common, which will be installed via yum as well.

censhare-Service-Client

As dependencies, the packages censhare-Common and censhare-ImageTools will be installed first. You can install it on the same system with a censhare-Server or standalone on another server. The censhare.serviceclient systemd serivce will be enabled. The software will be installed below /opt/corpus and you can start configure it as user corpus with following command.

censhare-Server

As dependencies, the package censhare-Common will be installed first. If you want the censhare-Server to create image previews by itself (recommended only as fallback, if a Service-Client isn't available), you can also install the package censhare-ImageTools , but it isn't a required dependency.

The package itself installs the censhare-Server software without any configuration. All links will be created and a work directory will be created from the work-template . The censhare.server systemd service will be enabled.

Ensure to use the packages of the latest version. The versions stated here are the latest ones at the time of writing and are not updated on a regular basis.

But the censhare-tools are updated continuously. Always use the latest versions of the tools or check the censhare-product/censhare-Server/redistributed.txt of your product delivery for the latest version.

Component	Use	Required	RPM package and directory
censhare Server			censhare-release-rpm
censhare Server	Application server Soft dependencies on the different censhare Server versions are listed in: `/opt/corpus/censhare/censhare-Server/redistributed.txt`	mandatory	https://rpm.censhare.com/censhare-release-rpm/stable/censhare/2023/1/ `censhare-Server-<version>-<buildID>.0.noarch.rpm`

Database			3d-party download
Relational database	PostgreSQL or Oracle	mandatory	Please download from the respective 3d-party download portal
Authentication and identity management			tools-release-rpm
Keycloak	Identity provider, authentication solution. censhare provides Keycloak 21 as RPM package. If you already use Keycloak, follow instruction on this page to upgrade.	mandatory	https://rpm.censhare.com/tools-release-rpm/

censhare tools			tools-release-rpm
Compatible CGW & SRS versions Starting from the censhare version 2022.2 onwards we use Java 17 and for CGW/SRS major version 3. For the exact latest version of both tools, please check what is available in the RPM repository.
Cloud Gateway	The Cloud Gateway is used to route the incoming requests from the web browser. The requests are directed to: Keycloak server for authentication Static Resource Server to serve the static parts of the user interface censhare Server to serve requested data	mandatory	https://rpm.censhare.com/tools-release-rpm/ `censhare-core-cloud-gateway-3.x.x-0.noarch.rpm` Update installations may require additional steps due to the change in package naming from `cloud-gateway` to `core-cloud-gateway`. If your installation is affected, follow these steps.
Static Resource Server	Distributes webpack bundles		https://rpm.censhare.com/tools-release-rpm/ `censhare-static-resource-server-3.x.x-0.noarch.rpm`

Other services			tools-release-rpm
Mail Service	Provides Modern Mail service authentication OAuth 2.0 (Exchange Online)	optional	https://rpm.censhare.com/tools-release-rpm/ `censhare-core-mail-0.4.4-0.noarch.rpm`
Google Cloud AI microservice	Provides Google Cloud AI analysis in censhare	optional	https://rpm.censhare.com/tools-release-rpm/ `censhare-google-ai-1.1.4-0.noarch.rpm`
Social Media microservice	Required to publish content from censhare to social networks (Twitter, Facebook, YouTube)	optional	https://rpm.censhare.com/tools-release-rpm/ `censhare-social-media-1.0.3-0.noarch.rpm`

webpack for web browser			censhare-release
webpack	Bundles static resources to serve them to the web browser. The webpack files contain the user-language specific static files of the user interface. For each language, separate webpack files are necessary. Also, for any other customizations in the custom folder, separate webpack files are needed. For update instructions, see Release frontend bundles (partner login required).	mandatory	https://rpm.censhare.com/censhare-release/censhare-Server/v2023.1.1/webpack-2023.1.1.tar.gz

censhare Clients			censhare-release-rpm
censhare Clients	Service Client The following clients – or their installers – need to be downloaded from the Download Portal: censhare Client Admin Client Render Client	mandatory	https://rpm.censhare.com/censhare-release-rpm/stable/censhare/2023/1/ `censhare-Service-Client-<version>-<buildID>.0.noarch.rpm`