Deploying OpenText Intelligent Viewing pre-requisites manually
If you are opting to install OpenText Intelligent Viewing (OTIV) on Windows, you will need to install pre-requisites. Normally these would be deployed with a package manager like Chocolatey. However, in some cases, when it is not possible to use a package manager to install the pre-reqs; you will need to install the pre-reqs manually.
Note: Although, OpenText Directory Services (OTDS) is required, the installation of OTDS is not included in this guide as it has its own installation documentation here
In short, this guide will go through the following pre-reqs:
- OpenJDK11
- Erlang and RabbitMQ
- Node.JS (LTS)
- Postgres 11
Let’s begin with OpenJDK!
OpenJDK11
Download OpenJDK11:
https://download.java.net/java/GA/jdk11/9/GPL/openjdk-11.0.2_windows-x64_bin.zip
Extract the ZIP, on an easy to access location, like C:\OpenJDK11
Create JAVA_HOME Path
- On run command or Start Menu search bar, type “sysdm.cpl” (without the quotes) and then hit enter
- That should open the System Properties window
- Go to the “Advanced tab”
- Click on “Environment Variables”
- Under the “System variables” section click on “New…”
- The variable name must be “JAVA_HOME” (without the quotes)
- The path must be the place where OpenJDK11 was extracted.
- Click “Ok” to add the new System Variable.
See the sample image for guidance.
Add Java bin to the system path
- On run command or Start Menu search bar, type “sysdm.cpl” (without the quotes) and then hit enter
- That should open the System Properties window
- Go to the “Advanced tab”
- Click on “Environment Variables”
- Under the “System variables” section look for and select the variable named “Path” (without the quotes)
- Click on “Edit…”
- On the “Edit environment variable“ window click on “New”
- Type the path to where OpenJDK11 was extracted and append \bin at the end of it
- Click “Ok”
Note: You can also type %JAVA_HOME%\bin
See the sample image for guidance.
Erlang and RabbitMQ
Erlang
RabbitMQ has its own pre-req, called Erlang which needs to be installed before deploying RabbitMQ
Download Erlang:
https://www.erlang.org/downloads
Note: You need Erlang 24.0 or newer
Install Erlang
To run the installer, simply double click on the downloaded exe file, and follow the prompts
Make note of the Installation path, you will need it in the next step
If you change any of the defaults make sure to keep a note with the changes
Configure ERLANG_HOME
- On run command or Start Menu search bar, type “sysdm.cpl” (without the quotes) and then hit enter
- That should open the System Properties window
- Go to the “Advanced tab”
- Click on “Environment Variables”
- Under the “System variables” section click on “New…”
- The variable name must be “ERLANG_HOME” (without the quotes)
- The path must be the place where Erlang got installed, by default it’s “C:\Program Files\erl-24.1”
- Click “Ok” to add the new System Variable.
See the sample image for guidance.
RabbitMQ
Download RabbitMQ
Download RabbitMQ Server (Any version above 3.8)
https://github.com/rabbitmq/rabbitmq-server/releases/
For this post we used version 3.9.7
Deploy RabbitMQ
- Extract the ZIP, on an easy to access location, like C:\RabbitMQ
- Open a command prompt with admin rights
- Navigate to the new location of RabbitMQ on the command prompt
- Access the sbin folder
- Run the following commands
rabbitmq-service install
rabbitmq-service start
rabbitmq-service stop
Configure RabbitMQ
- Using the explorer navigate to “%HOMEPATH%” (without the quotes)
- Copy the file ".erlang.cookie"
- Navigate to C:\Windows\system32\config\systemprofile\
- Paste the file .erlang.cookie there (if there is already a file with the same name rename it first)
Start RabbitMQ from Services.msc
Node.js
NodeJS has frequent updates, therefore, you should use the LTS release.
Download NodeJS (LTS 64bit)
https://nodejs.org/en/download/
Install NodeJS (LTS 64-bit)
To run the installer, simply double click on the downloaded exe file, and follow the prompts
Make note of the Installation path, you will need it in the next step
If you change any of the defaults make sure to keep a note with the changes
Add NodeJS to the path
- On run command or Start Menu search bar, type “sysdm.cpl” (without the quotes) and then hit enter
- That should open the System Properties window
- Go to the “Advanced tab”
- Click on “Environment Variables”
- Under the “System variables” section look for and select the variable named “Path” (without the quotes)
- Click on “Edit…”
- On the “Edit environment variable” window check if there is already an entry for NodeJS, if not Click on “New”
- Type the path to where NodeJS was installed
- Click “Ok”
See the sample image for guidance.
Postgres 11
Download Postgres 11
https://www.enterprisedb.com/downloads/postgres-postgresql-downloads
Run the Installer
To run the installer, simply double click on the downloaded exe file, and follow the prompts
Note1: You do not need the Stack Builder.
Note2: During the Install you will be prompted to create a password, please make sure to remember the password used.
If you change any of the defaults make sure to keep a note with the changes
The installer will also install any missing runtimes required for Postgres, like Visual C++ 2015-2019 Redistributable
Configure Postgres to be used with OTIV
After Postgres is installed Open PgAdmin4
The first time pgAdmin is opened it will take some time
Login with the password entered during the install
Create a Database
- Right click on Databases
- Select Create > Database…
- Type in the name of the database
- Click on the create
See the sample images for guidance.
Add pgCrypto Extension
- Right click on the newly created database
- Click on Create > Extension
- Click on Name and use the search box to look for “crypto” (Without the quotes)
- Select the pgcrypto from the list
- Click on Save
See the sample images for guidance.
This concludes all the steps needed to manually install the pre-reqs for OpenText Intelligent Viewing.
For more helpful content feel free to visit the OpenText Forums.
Cheers!
Comments
-
This is a comprehensive installation guide. Thank you!!
One questions - I can't much information on where Intelligent Viewing should be installed? Can IV be installed on the same server as Content Server, or what the most optimal way/place to install IV, without requiring it's own server?
0 -
For a Dev or Test system it's ok to install Intelligent Viewing on the same system as Content Server, however for a Production environment it is recommended that Intelligent Viewing is installed on it's own system
0 -
Can we install Intelligent Viewer with High Availability? Any article or documentation for such HA installation?
0 -
Yes, you can install IV in High Availability, here is an article that has a sample configuration on how to configure NGINX to be a Load balancer for IV.
https://support.opentext.com/csm?id=kb_article_view&sysparm_article=KB0787066
0 -
@Daniel Mejia could you make the KBA available to customers? It is not viewable to me. Either is has not been released or it is still in viewing mode like many KBAs which has not been released lately.
0 -
Hi @Bruno Le , please use the search function in support.opentext.com to find "KB0787066". The link shared previously is just the employee one.
0 -
@Karen Weir there is no difference for a KBA article besides of the permissions. Indeed if I search for KB0787066 I get no results because the KBA is in review state or other state that is not released for customers.
0 -
Thanks for confirming @Bruno Le ! @Daniel Mejia could you advise when the article permissions will be updated?
0 -
Is there any reliable way to make intelligent Viewing work using SSL? can you guide us in this regard
1
Categories
- All Categories
- 122 Developer Announcements
- 52 Articles
- 148 General Questions
- 146 Thrust Services
- 56 OpenText Hackathon
- 35 Developer Tools
- 20.6K Analytics
- 4.2K AppWorks
- 9K Extended ECM
- 917 Cloud Fax and Notifications
- 83 Digital Asset Management
- 9.4K Documentum
- 30 eDOCS
- 178 Exstream
- 39.8K TeamSite
- 1.7K Web Experience Management
- 7 XM Fax
- Follow Categories