censhare WP uses Webpack technology and requires Keycloak for identity management. Follow this tutorial to set up censhare WP. |
There are some important changes regarding the installation and configuration of censhare WP. Besides the censhare Server, you must set up additional components to enable the communication between the censhare Server, Keycloak, and the censhare clients.
You should be familiar with:
How to administrate Keycloak
How to install and update RPM packages
How to administrate services that run with systemd.
systemd is used to run the relevant services. systemd is a system and service manager for Linux operating systems. |
For all components besides the database, censhare provides RPM packages.
To retrieve the required RPMs, you need access to the RPM repository. If you do not have any credentials, create a support ticket. |
Download the packages of the latest version with a command similar to this:
curl --user repo-user https://rpm.censhare.com/artifactory/webpack-release/2021.2.1/webpack-2021.2.1.tar.gz -o webpack-2021.2.1.tar.gz |
Component | Use | RPM package |
---|---|---|
censhare Server and database | ||
censhare Server | Application server Soft dependencies on the different censhare Server versions are listed in: | https://rpm.censhare.com/censhare-release-rpm/stable/censhare/2021/2/
|
database | PostgreSQL or Oracle | |
Authentication and identity management | ||
Keycloak | Mandatory Identity provider, authentication solution. censhare provides Keycloak v16.1.1 as RPM package. Existing Keycloak installations can be incorporated. censhare WP supports Keycloak as of v9 but we recommend to use the latest version 16.1.1. | https://rpm.censhare.com/tools-release-rpm/keycloak-16.1.1-3-8.el7.x86_64.rpm or https://rpm.censhare.com/tools-release-rpm/keycloak-16.1.1-8.el7.src.rpm |
censhare tools | ||
Cloud Gateway | Mandatory The Cloud Gateway is used to route the incoming requests from the web browser. The requests are directed to:
| https://rpm.censhare.com/tools-release-rpm/
|
Static Resource Server | Mandatory Distributes webpack bundles | https://rpm.censhare.com/tools-release-rpm/
|
Google Cloud AI microservice | Optional Provides Google Cloud AI analysis in censhare | https://rpm.censhare.com/tools-release-rpm/
|
Social Media microservice | Optional Required to publish content from censhare to social networks (Twitter, Facebook, YouTube) | https://rpm.censhare.com/tools-release-rpm/
|
webpack for web browser | ||
webpack | Mandatory 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. | https://rpm.censhare.com/artifactory/webpack-release/2021.2.1/webpack-2021.2.1.tar.gz |
censhare Clients | ||
censhare Clients | The censhare clients (Java-based and Admin) and censhare Service Client can be used as before. There are no changes regarding installation or configuration. | For example: https://rpm.censhare.com/censhare-release-rpm/stable/censhare/2021/2/
|
Add the repositories for the RPM packages to the system:
Go to /etc/yum.repos.d/
If no repository for censhare Server exists, create it with suffix repo. For example censhare-server.repo
[censhare-server] name=censhare-server baseurl = https://USER:PASSWORD@rpm.censhare.com/censhare-release-rpm/stable/censhare/2021/2/1 enabled=0 gpgcheck=1 gpgkey = https://repos.censhare.com/6CAE093C.pub |
If no repository for the censhare tools exists, create it with suffix repo. For example censhare-tools.repo
[censhare-tools] name=censhare-tools baseurl=https://user:password@rpm.censhare.com/tools-release-rpm/ enabled=0 gpgcheck=1 gpgkey=https://rpm.censhare.com/public/6CAE093C.pub |
Import the GPG key into your system. It is required to verify your downloads.
rpm --import https://rpm.censhare.com/public/6CAE093C.pub |
Update to censhare 2021.2.1 or the latest available version into the censhare-server repository:
rpm -i censhare-Server-2021.2.1-34.0.noarch.rpm # or yum install --enablerepo="censhare*" censhare-Server # or yum update --enablerepo="censhare*" censhare-Server |
You can use PostgreSQL or Oracle databases. If you already have a running censhare instance, skip this step.
For information on installing the database:
curl http://localhost:9000/ws/rest/service/webserver/rest/csLocale -u censhare: |
Update to censhare 2021.2.1 or the latest available version into the censhar-server repository :
rpm -i censhare-Service-Client-2021.2.1-34.0.noarch.rpm # or yum install --enablerepo="censhare*" censhare-Service-Client # or yum update --enablerepo="censhare*" censhare-Service-Client |
If you already have a running Keycloak installation, skip this step.
If you need to install Keycloak, go to the location where you installed censhare WP:
rpm -i keycloak-16.1.1-8.el7.x86_64.rpm # or yum install --enablerepo="censhare*" keycloak # or yum update --enablerepo="censhare*" keycloak |
rpm -i censhare-cloud-gateway-1.0.14-0.noarch.rpm # or yum install --enablerepo="censhare*" censhare-cloud-gateway |
rpm -i censhare-static-resource-server-2.0.37-0.noarch.rpm # or yum install --enablerepo="censhare*" censhare-static-resource-server |
Install Google Cloud AI:
rpm -i censhare-google-ai-1.1.2-0.noarch.rpm # or yum install --enablerepo="censhare*" censhare-google-ai-microservice |
Install Social Media service. For more information, see Installation details.
rpm -i censhare-social-media-1.0.3-0.noarch.rpm # or yum install --enablerepo="censhare*" censhare-social-media |
The censhare clients and censhare Service Client can be used as before. There are no changes regarding installation or configuration.
Update to censhare 2021.2.1 or the latest available version.
For more information, see Install censhare clients.
yum list *censhare* |
yum check-update --enablerepo="censhare*" |
yum update --enablerepo="censhare*" PACKAGE_NAME # for example yum update --enablerepo="censhare*" censhare-static-resource-server # or yum update all --enablerepo="censhare*" |
|