Installing Enterprise Edition on CentOS, RHE, and Fedora

{toc:location=top|maxLevel=3|minLevel=3|type=flat|separator=pipe|style=border:1}


h3. 1. Install the Server Using YUM

h4. 1.1 Configure YUM Repository

*YUM* is the easiest way to keep programs up-to-date on RedHat-compatible distributions. *YUM* downloads and installs the latest version of a program. You should configure the *YUM repository* to manage installations of and [upgrades|Upgrading Enterprise Edition for Linux] to CDP Server Enterprise Edition.

First, create a YUM {{.repo}} file with the R1Soft repository information. Save the file in the {{yum.repos.d}} directory, which is typically located in {{/etc/}}.

1. Open the new file with a text editor such as *vi* or *nano*:

{code}# cd /etc/yum.repos.d
# vi r1soft.repo{code}
or
{code}# nano -w /etc/yum.repos.d/r1soft.repo {code}

!advanced_1-1_cat_nano.png!

2. Insert the following text into the file and save the file:

{code}[r1soft]
name=R1Soft Repository Server
baseurl=http://repo.r1soft.com/yum/stable/$basearch/
enabled=1
gpgcheck=0{code}

{note:title=Tip}{{$basearch}} is a Yum variable, i.e., the base architecture (32-bit, 64-bit, etc.).{note}

!all_1-1-2_nano_yum.png!

3. To verify what is written to the file, use the following command:

{code}# cat /etc/yum.repos.d/r1soft.repo {code}


!advanced_1-1_cat_nano1.png!

h4. 1.2 Install the Package

1. With the installed YUM repository, you can use the following command to install the CDP Enterprise Server:

{code}#yum install r1soft-cdp-enterprise-server{code}

!4-2_ent_inst-12.png!

2. Then, enter "y" to install all the dependencies of the package.

!4-2_ent_inst-2.png!

3. Once complete, you can use the help command to list all available options:

----
h3. 2. Install the Server Manually (Using rpm)


h4. 2.1 Download CDP Enterprise Edition

See [Obtaining Linux CDP Enterprise Edition].

h4. 2.2 Make Sure You Can Unzip the Download

Most Linux distributions come with the *unzip* utility pre-installed. To determine if you have the *unzip* utility, run:

{code}# which unzip{code}

This should return an output similar to the following:

{code}# which unzip
/usr/bin/unzip{code}

!unzip-ad-310.png!

If it returns the following output, you need to install the *unzip* utility first:

{code}unzip: Command not found.{code}

To install unzip on RHE, CentOS, and Fedora:

{code}# yum install unzip{code}

!install standard.png!

h4. 2.3 Extract the ZIP File

We recommend creating a temporary directory to which you can extract the contents of the ZIP file.

1. Use the {{mkdir}} command to create a temporary directory (in our case, {{cdp}}).

{code}# mkdir cdp{code}

2. Use the {{mv}} command to move the archive to that directory. Note that Linux file names are case-sensitive. Make sure you type the name correctly (in our case, "*r1soft-enterpriseedition-linux64-4.2.0.zip*").

{code}# mv r1soft-enterpriseedition-linux64-4.2.0.zip cdp{code}

3. Use the {{cd}} command to go to that directory.

{code}# cd cdp{code}

4. Use the {{unzip}} command to extract the files.

{code}# unzip r1soft-enterpriseedition-linux32.zip{code}

!4-2_ent-ed_unzip.png!

h4. 2.4 Install the Packages


{note:title=Notice}You must be a Linux root user to install CDP Enterprise Edition.
{note}
The archive you have extracted contains two folders: one with {{.deb}} packages (in our case, "*deb-linux32*") and one with {{.rpm}} packages ("*rpm-linux32*"). If you are installing on RedHat and CentOS, select the {{.rpm}} package.

Each folder contains a set of CDP components:
* {{r1soft-cdp-enterprise-edition}}
* {{r1soft-setup}}
* {{r1soft-cdp-agent}}
* {{r1soft-cdp-server}}

You will need to install all of them in one step. Use the {{cd}} command to go to the folder with the packages (in our case, {{deb-linux32}}) and run the following command:

*RPM 32-bit (x86)* / *RPM 64-bit (x86_64)*


{code}rpm -i *.rpm{code}

!04_310.png!


{info:title=Note}The installed files are located in the {{/usr/sbin/r1soft}} directory. The server startup script is {{/etc/init.d/cdp-server}}.
{info}

{info:title=Note}You do not need to install the kernel module on the Server.
{info}




----
h3. {anchor:login}3. Configure and Start the CDP Server Web-based User Interface

1. You must *define a username and password* for the CDP Server Web Interface before you can begin using CDP Enterprise Edition.

{code}# r1soft-setup --user DESIRED_USERNAME --pass DESIRED_PASSWORD{code}

After running this command, you will see an output similar to the following:

{code}# r1soft-setup --user admin --pass r1soft
Server username and password set
The R1Soft CDP Server must be restarted for these changes to take effect
Use '/etc/init.d/cdp-server restart' to restart.{code}

!install standard 5.png!

2. *Configure Ports* if necessary.

By default, the embedded web server in CDP Enterprise Edition required for the Web-based Interface will listen on TCP ports 80 (HTTP) and 443 (HTTPS). These ports are frequently used by your Linux server (e.g., by Apache). If you are already using ports 80 and 443, you will need to define different ports. Ports 8080 (HTTP) and 8443 (HTTPS) are recommended alternatives to standard 80 and 443. However, you can choose any other valid and unused TCP port.

{code}# r1soft-setup --http-port 8080 --https-port 8443{code}

!install standard 6.png!

{info:title=Note}You may need to change the firewall rules, depending on where you are connecting to the Web Interface from.
{info}

See also: [Configuring Enterprise Edition on Linux].

3. Start the Web Interface (CDP Server):

{code}# /etc/init.d/cdp-server restart{code}

!install standard 7.png!

You should now be able to connect to the CDP Enterprise Edition Web Interface using Firefox or Internet Explorer. See [Accessing Enterprise Edition Web Interface].




----
h3. Next Steps

* [Configuring Enterprise Edition on Linux]
* [Installing Agent on Windows]
* [Installing Agent on Linux]
* [Accessing Enterprise Edition Web Interface]
* [Activating CDP Enterprise Edition]
* [Adding the Server Key to Linux Agent]
* [Adding the Server Key to Windows Agent]
* [Configuring Heap Memory]

{excerpt:hidden=true}Instructions on how to install CDP Server 4.2.0 Enterprise Edition on CentOS, RHE, and Fedora using rpm and yum.{excerpt}

h3. 1. Install the Server Using YUM

h4. 1.1 Configure YUM Repository

*YUM* is the easiest way to keep programs up-to-date on RedHat-compatible distributions. *YUM* downloads and installs the latest version of a program. You should configure the *YUM repository* to manage installations of and [upgrades|Upgrading Enterprise Edition for Linux] to CDP Server Service Provider and Enterprise Editions.

First, create a YUM {{.repo}} file with the R1Soft repository information. Save the file in the {{yum.repos.d}} directory, which is typically located in {{/etc/}}.

1. Open the new file with a text editor such as *vi* or *nano*:

{code}# cd /etc/yum.repos.d
# vi r1soft.repo{code}
or
{code}# nano -w /etc/yum.repos.d/r1soft.repo {code}

!advanced_1-1_cat_nano.png!

2. Insert the following text into the file and save the file:

{code}[r1soft]
name=R1Soft Repository Server
baseurl=http://repo.r1soft.com/yum/stable/$basearch/
enabled=1
gpgcheck=0{code}

{note:title=Tip}{{$basearch}} is a Yum variable, i.e., the base architecture (32-bit, 64-bit, etc.).{note}

!all_1-1-2_nano_yum.png!

3. To verify what is written to the file, use the following command:

{code}# cat /etc/yum.repos.d/r1soft.repo {code}


!advanced_1-1_cat_nano1.png!

h4. 1.2 Install the Package

1. With the installed YUM repository, you can use the following command to install the CDP Enterprise Server:

{code}#yum install r1soft-cdp-enterprise-server{code}

!4-2_ent_inst-12.png!

2. Then, enter "y" to install all the dependencies of the package.

!4-2_ent_inst-2.png!

3. Once complete, you can use the help command to list all available options:

{code}#r1soft-setup --help{code}

!install standard 209.png!

4. Now, proceed to the [Step 3|#login].
----
h3. 2. Install the Server Manually (Using rpm)


h4. 2.1 Download CDP Service Provider (Enterprise) Edition

See [Obtaining Linux CDP Enterprise Edition].

h4. 2.2 Make Sure You Can Unzip the Download

Most Linux distributions come with the *unzip* utility pre-installed. To determine if you have the *unzip* utility, run:

{code}# which unzip{code}

This should return an output similar to the following:

{code}# which unzip
/usr/bin/unzip{code}

!unzip-ad-310.png!

If it returns the following output, you need to install the *unzip* utility first:

{code}unzip: Command not found.{code}

To install unzip on RHE, CentOS, and Fedora:

{code}# yum install unzip{code}

!install standard.png!

h4. 2.3 Extract the ZIP File

We recommend creating a temporary directory to which you can extract the contents of the ZIP file.

1. Use the {{mkdir}} command to create a temporary directory (in our case, {{cdp}}).

{code}# mkdir cdp{code}

2. Use the {{mv}} command to move the archive to that directory. Note that Linux file names are case-sensitive. Make sure you type the name correctly (in our case, "*r1soft-enterpriseedition-linux64-4.2.0.zip*").

{code}# mv r1soft-enterpriseedition-linux64-4.2.0.zip cdp{code}

3. Use the {{cd}} command to go to that directory.

{code}# cd cdp{code}

4. Use the {{unzip}} command to extract the files.

{code}# unzip r1soft-enterpriseedition-linux32.zip{code}

!4-2_ent-ed_unzip.png!

h4. 2.4 Install the Packages


{note:title=Notice}You must be a Linux root user to install CDP Service Provider (Enterprise) Edition.
{note}
The archive you have extracted contains two folders: one with {{.deb}} packages (in our case, "*deb-linux32*") and one with {{.rpm}} packages ("*rpm-linux32*"). If you are installing on RedHat and CentOS, select the {{.rpm}} package.

Each folder contains a set of CDP components:
* {{r1soft-cdp-enterprise-edition}}
* {{r1soft-setup}}
* {{r1soft-cdp-agent}}
* {{r1soft-cdp-server}}

You will need to install all of them in one step. Use the {{cd}} command to go to the folder with the packages (in our case, {{deb-linux32}}) and run the following command:

*RPM 32-bit (x86)* / *RPM 64-bit (x86_64)*


{code}rpm -i *.rpm{code}

!04_310.png!


{info:title=Note}The installed files are located in the {{/usr/sbin/r1soft}} directory. The server startup script is {{/etc/init.d/cdp-server}}.
{info}

{info:title=Note}You do not need to install the kernel module on the Server.
{info}




----
h3. {anchor:login}3. Configure and Start the CDP Server Web-based User Interface

1. You must *define a username and password* for the CDP Server Web Interface before you can begin using CDP Service Provider (Enterprise) Edition.

{code}# r1soft-setup --user DESIRED_USERNAME --pass DESIRED_PASSWORD{code}

After running this command, you will see an output similar to the following:

{code}# r1soft-setup --user admin --pass r1soft
Server username and password set
The R1Soft CDP Server must be restarted for these changes to take effect
Use '/etc/init.d/cdp-server restart' to restart.{code}

!install standard 5.png!

2. *Configure Ports* if necessary.

By default, the embedded web server in CDP Service Provider (Enterprise) Edition required for the Web-based Interface will listen on TCP ports 80 (HTTP) and 443 (HTTPS). These ports are frequently used by your Linux server (e.g., by Apache). If you are already using ports 80 and 443, you will need to define different ports. Ports 8080 (HTTP) and 8443 (HTTPS) are recommended alternatives to standard 80 and 443. However, you can choose any other valid and unused TCP port.

{code}# r1soft-setup --http-port 8080 --https-port 8443{code}

!install standard 6.png!

{info:title=Note}You may need to change the firewall rules, depending on where you are connecting to the Web Interface from.
{info}

See also: [Configuring Enterprise Edition on Linux].

3. Start the Web Interface (CDP Server):

{code}# /etc/init.d/cdp-server restart{code}

!install standard 7.png!

You should now be able to connect to the CDP Service Provider (Enterprise) Edition Web Interface using Firefox or Internet Explorer. See [Accessing Enterprise Edition Web Interface].




----
h3. Next Steps

* [Configuring Enterprise Edition on Linux]
* [Installing Agent on Windows]
* [Installing Agent on Linux]
* [Accessing Enterprise Edition Web Interface]
* [Activating CDP Enterprise Edition]
* [Adding the Server Key to Linux Agent]
* [Adding the Server Key to Windows Agent]