To install an RPM package on a RedHat Linux distribution platform, you can use yum or its newer option dnf. For this description we will use dnf.
NOTE: It is assumed that any necessary support software, such as Docker, have already been installed on the server. Links to that are provided in the Installing iCR section.
NOTE: dnf requires that you have superuser privileges in order to install new packages. So all commands will be preceded with the sudo directive.
The first step is to tell the package management infrastructure where to find the OpenRefactory repository containing the iCR RPM packages. This is accomplished with the following command:
sudo wget -O /etc/yum.repos.d/icr.repo https://rpm.openrefactory.com/icr.repo
Then, you need to update the state of the RPM repositories with this command:
sudo dnf repolist
From this you will see that icr is in the list of available repositories. Now, install iCR using the following command: sudo dnf install icr-4.2.0
Once the installation begins, you should see progress initiated with output similar to:
Last metadata expiration check: 0:04:20 ago on Fri Nov 15 01:08:19 2024.
Dependencies resolved.
========================================================================================================================================
Package Architecture Version Repository Size
========================================================================================================================================
Installing:
icr noarch 4.2.0 icr 15 k
Transaction Summary
========================================================================================================================================
Install 1 Package
Total download size: 15 k
Installed size: 17 k
Is this ok [y/N]: y
Downloading Packages:
icr-4.2.0.noarch.rpm 78 kB/s | 15 kB 00:00
----------------------------------------------------------------------------------------------------------------------------------------
Total 78 kB/s | 15 kB 00:00
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
Preparing : 1/1
Installing : icr-4.2.0.noarch 1/1
Running scriptlet: icr-4.2.0.noarch 1/1
This shows that the package installation has begun and the package is being downloaded. The iCR package is large and will take a while, likely minutes to download before further progess is shown. Once downloaded you should see progress similar to this:
This shows that all of the required Docker compoenets are installed into the local Docker registry and are available for use. You can check that everything is OK by running the command: docker images
You should see the following images displayed:
REPOSITORY TAG IMAGE ID CREATED SIZE
openrefactory/icr-unified-navrev 4.2.0 c1b5bedbc355 15 hours ago 1.94GB
openrefactory/icr-python-iso 4.2.0 436009669c96 44 hours ago 2.52GB
openrefactory/llm-middleware 1.0.0 dbed893d6b8a 3 days ago 1.23GB
openrefactory/icr-go-iso 4.2.0 cfc8e7d6b0ac 4 days ago 764MB
openrefactory/icr-java-iso 4.2.0 7d8c947f8090 4 days ago 1.94GB
mongo 6.0 a1ed927d524d 3 weeks ago 716MB
openrefactory/icr-worker 4.2.0 54f53a62b303 5 months ago 1.1GB
Once the Docker containers are installed, the installation also sets up the icr command for you so that you can immediately use it to do any other confiuration that may be required. How to use the icr command is outlined in the following section Managing your Service. The required End User License Agreement (EULA) must be reviewed. It is assumed that going forward with using iCR implies that you have read and accepted the EULA. You can find the EULA along with the complete SBOM for all of the libraries included in iCR in the /usr/share/icr-release directory.
If there becomes a reason for you to require iCR to be removed from your platform, you may do so using the following command: sudo dnf remove icr
NOTE: If you decide to remove the iCR package, please be aware that deleting the package will ALSO delete the results of any analyses that were completed in the past and all historical data will be removed.
With iCR correctly installed, you will need to configure it before you can begin analyzing your projects. This is covered in the following section: Managing Your Service.
