Installing Data Center Console on Linux

Unlike CDP Server products that are installed in one step, Data Center Console (DCC) requires some configuration *prior* to installation as well as some additional manual steps *after* the initial install of the software package.

See previous step in: [Prerequisites for Installing Data Center Console].

Follow the below instructions to install and configure Data Center Console on Linux.

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

----
h3. Installing Data Center Console on Linux

There are two ways of installing Data Center Console on Linux - automatic from repository and manual. Before installing Data Center Console, make sure your machine matches the following recommended system requirements:
* *Operating System*: 64-bit only, Linux 2.6
* *Physical Memory*: 4 GB
* *Free Disk Space*: Not less than 10 GB
{note:title=Notice}You should install Data Center Console on an independent host that does not have a CDP Server installed.

{code}vim /etc/yum.repos.d/r1soft.repo{code}

2. Insert the following text into the file:

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

{note:title=Tip}If you do not know how to work with text editors in a Linux SSH session, run the following command:
{{cat >}} {{/etc/yum.repos.d/r1soft.repo}}
Paste the string from the clipboard and press Ctrl-D.
{note}
As a result, the content of the file {{/etc/yum.repos.d/r1soft.repo}} will look like the following:

!d01.png!

3. Save the file and exit.

4. Execute the following command to install Data Center Console.

{code}yum install r1soft-cdp-datacenter-console{code}

!4-2_datacenter-console_inst-1a.png!

Type "Y" to confirm the download.

!4-2_datacenter-console_inst-2aa.png!

h4. Automaitc installation on Debian or Ubuntu

1. Configure APT repository, then download and install the R1Soft apt gpg key by executing the following commands:

{code}echo deb http://repo.r1soft.com/apt stable main >> /etc/apt/sources.list
wget http://repo.r1soft.com/r1soft.asc
apt-key add r1soft.asc

{code}
2. Download repository metadata into the local cache for faster search by executing the command

{code}apt-get update

{code}
3. Install Data Center Console by executing the following command:



{code}apt-get install r1soft-cdp-datacenter-console{code}

!4-2_datacenter_inst-2_deb2.png!

h4. Manual installation on CentOS

1. Extract the downloaded archive with the following command:

{code}unzip R1Soft-DataCenter-Console.zip{code}

!3182-78.png!

2. The archive you have extracted contains two folders: one with {{.deb}} packages (in our case, "*deb-linux64*") and one with RPM packages ("*rpm-linux64*"). On CentOS, you need to change working directory to the one containing RPM packages:

{code}cd rpm-linux64
{code}\\

After changing the working directory, install Data Center Console by executing the command



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

!3182-80.png!

h4. Manual installation on Debian or Ubuntu

1. Extract the downloaded archive with the following command:
\\

{code}unzip R1Soft-DataCenter-Console.zip
{code}\\
\\

2. The archive you have extracted contains two folders: one with {{.deb}} packages (in our case, "*deb-linux64*") and one with RPM packages ("*rpm-linux64*"). On Debian or Ubuntu, you need to change working directory to the one containing {{.deb}} packages:

{code}cd deb-linux64
{code}

 After changing the working directory, install Data Center Console by executing the command
{code}dpkg -i *.deb
{code}
!3182-79.png!

You will need to perform the following steps before you can launch Data Center Console.

----
h3. Installing MySQL Java Connector

Next, you need to add a JBDC connector. 


1. Download the MySQL Connector file using the {{wget}} command:

{code}wget http://mysql.llarian.net/Downloads/Connector-J/mysql-connector-java-5.1.18.zip{code}

!d04.png!

{note:title=Notice}
At the time of writing this document 5.1.18 the latest version of MySQL Java Connector. When you will install Data Center Console, newer version may become available. Using the latest version is recommended.
{note}
2. Unpack the downloaded archive:

{code}unzip mysql-connector-java-5.1.18.zip{code}

!d05.png!

3. Copy the {{jar}} file to the configuration folder:

{code}cp mysql-connector-java-5.1.18-bin.jar /usr/sbin/r1soft-datacenter-console/conf/database-drivers{code}

----
h3. Configuring Database Properties

1. Open the {{/usr/sbin/r1soft-datacenter-console/conf/server.properties}} file in your favorite Linux text editor: {{vim}}, {{emacs}}, {{pico}}, or {{mcedit}}.

{code}vim /usr/sbin/r1soft-datacenter-console/conf/server.properties{code}

2. Replace the database name, <username>, and <password> fields with the relevant values for your system.

!d06.png!

3. Save the file and exit.

----
h3. Starting the Data Center Console

1. Run the following command to start Data Center Console:
{code}/etc/init.d/cdp-console start{code}
!d07.png!

2. Check the log file to verify that Data Center Console has started successfully:
{code}tail -f /usr/sbin/r1soft-datacenter-console/log/server.log{code}
!4-2_datacenter_serverlog_deb2.png!

----
h3. Accessing Data Center Console for the First Time

1. Open a Web browser and enter the following URL:

{code}http://localhost:8080{code}

2. In the login form, enter the default username ("admin") and password ("admin"), and then click "Login."

!bas.png!

{excerpt:hidden=true}Instructions on how to install and configure the Data Center Console on Linux.{excerpt}