Versions Compared

Old Version 2

changes.mady.by.user Jonė Š.

Saved on

compared with

New Version Current

changes.mady.by.user Agne P.

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Expand
titleHow to run Teamwork Cloud in FIPS Mode?

You may encounter an error message similar to the one shown below when running Teamwork Cloud in FIPS Mode. PKCS12 keystore creation and usage are blocked in FIPS Mode for Java 11 and older versions.

Code Block
PBES2 AlgorithmParameters not available

First, make sure the initial installation was able to generate a self-signed certificate and keystore. Look for keystore.p12 and teamworkcloud.crt files in <install_root>/MagicCollaborationStudio/TeamworkCloud/configuration. If these files were not generated, run the genkey script in <install_root>/MagicCollaborationStudio/TeamworkCloud/script/linux. Check for the keystore.p12 and teamworkcloud.crt files again and change ownership to twcloud (or other username that you chose during installation.) Once these two files are generated, version 2024x should be able to run in FIPS Mode.

If the genkey script is not able to generate the self-signed certificate and keystore, set the system Java version to 17 (alternatives --config java) and try again.

For 2022x Refresh 2, append the following line to the end of the jvm.options file located in <install_root>/MagicCollaborationStudio/TeamworkCloud.

Code Block
-Dcom.redhat.fips=false

This configuration will allow Teamwork Cloud to Magic Collaboration Studio to use PKCS #12 keystore in FIPS Mode. Similar configurations will have to be set for Cassandra if encrypted communication is enabled.

...

Expand
titleHow to install and use Temurin OpenJDK or another Java release on Linux?

Download the desired version of Temurin OpenJDK (https://adoptium.net/temurin/releases/). For most cases, the JRE package is adequate.

Unpack the tar.gz file on the Linux server (/opt path is recommended)

Add the newly-installed Java release as an alternative:

Code Block
languagebash
themeDJango
linenumberstrue
alternatives --install /usr/bin/java java <path to new java>/bin/java <priority number>

Set as the default system Java:

Code Block
languagebash
themeDJango
linenumberstrue
alternatives --config java
Expand
titleHow do I upgrade Teamwork Cloud to a newer version?
Open the upgrade path diagram in a new tab and use it to determine what steps are required for the upgrade. Upgrading from older versions will require database migration and Cassandra upgrade. Minor upgrades will only involve uninstalling the current version and installing the latest version.
 Expand
titleDoes 2021x Refresh 2 work with Cassandra 4.1?
Magic Collaboration Studio 2021x Refresh 2 Hot Fix 5 supports Cassandra 4.0.X out of the box. For 2021x Refresh 2 to connect to Cassandra 4.1.X, add the following parameter to the end of the application.conf file in <install_root>/<product>/configuration.
 Code Block
esi.persistence.cassandra.enable-check-version = false
...
 Expand
titleIs offline installation possible for Linux?
It is possible to install Magic Collaboration Studio without internet access, provided that the prerequisite packages are available locally. Access to a locally-managed repository server is a recommended for offline installation. Linux packages often have dependencies that are pulled and installed automatically when connecting to a repository. Manual download of Linux packages may require a trial-and-error process of retrieving dependencies. 
Access to repository server
If you have access to a locally-managed repository server, go through the installation sections and download all prerequisite packages listed. Edit the installation scripts and replace all hyperlinks with local path to the downloaded package. Finally, execute the installation script. The local repository server will resolve all packages and dependencies needed during installation.
Manual installation
If your only option is to manually install all packages needed, then you will need to first download all the prerequisite packages from a machine with internet access. Then, as each package is installed, you will need to make a note of the dependencies required. This will be an iterative process in order to find all the dependencies that are needed to complete the installation.
To prepare for manual installation, an internet-accessible machine is initially needed to download all the required packages. This machine should mirror the environment of the deployment server. A mirrored environment will accurately resolve package dependencies. Use the DNF Download Plugin (dnf-plugins-core) to retrieve packages. 
 Code Block
languagebash
themeDJango
linenumberstrue
sudo dnf download –resolve <package-name>
The command structure above will download the main package and any dependencies that is required. Dependencies are dictated by the Linux environment. If the deployment server has a very different Linux environment than the download machine, then resolving package dependencies can be a tedious process.
 Expand
titleWhat is causing the System Error when trying to access the web login page?
Image Added
This error is typically due to an incorrect address entry in the authentication whitelist. Verify addresses specified for authentication.redirect.uri.whitelist in authserver.properties file are correct.