Install Dependent Software

In document Platfora Installation Guide (Page 35-39)

If using the TAR installation package to install Platfora, you must install all of the dependencies yourself. This section provides instructions for manually installing the prerequisite software on a Platfora node.

If you are provisioning a Platfora master node, you must install all dependencies.

If you are provisioning a Platfora worker node, you can skip the task for installing PostgreSQL. PostgreSQL is only needed on the Platfora master node.

Confirm Linux OS Utilities

Platfora requires several standard Linux utilities to be installed on your system and in your environment PATH. Check your system for the required utilites before installing Platfora.

Most Linux operating systems already have these utilities installed by default. • rsyncsshscptailtarcpwgetntp

sysctl (/usr/sbin must be in your PATH)

To verify that a utility is installed and can be found in the PATH, you can check its location using the which command. For example:

$ which rsync $ which tar $ which sysctl

If a utility is not installed, you will need to install it before installing Platfora. Check your OS documentation for instructions on installing these utilities.

Install Java

The Platfora server requires a Java Runtime Environment (JRE) version 1.7 or higher. Platfora recommends installing the full Java Development Kit (JDK) for access to the latest Java features and diagnostic tools.

The instructions in this section are for installing version 1.7 of the Open Java Development Kit (OpenJDK).

You must have root or sudo permissions to install Java. 1. Check if Java 1.7 or higher is already installed.

$ java -version

If java is not found, you will need to install it. 2. Install OpenJDK using your OS package manager.

On Ubuntu Systems:

$ sudo apt-get install openjdk-7-jdk On RedHat/CentOS Systems:

$ su -c "yum install java-1.7.0-openjdk"

3. Set the JAVA_HOME environment variable in the platfora user’s profile file. For example, where java_directory is the versioned directory where Java is installed:

$ echo "export JAVA_HOME=/usr/lib/jvm/java_directory/jre" >> /home/ platfora/.bashrc

$ echo "export PATH=$JAVA_HOME/bin:$PATH" >> /home/platfora/.bashrc $ source /home/platfora/.bashrc

4. Make sure JAVA_HOME is set correctly for the platfora user: $ su - platfora

$ echo $JAVA_HOME

Confirm Python Installation

The Platfora management utilities require Python version 2.6.8, 2.7.1, or 2.7.3 through 2.7.6. Python version 3.0 is not supported. Most Linux operating systems already have Python installed by default, but you need to make sure the version is compatible with Platfora.

To check if the correct version of Python is installed: $ python -V

If Python is not installed (or you have an incompatible version of Python) you will need to install or upgrade/downgrade it before installing Platfora. Check your OS documentation for instructions on installing or upgrading/downgrading Python to version 2.6.8 or higher 2.x version.

Install PostgreSQL (Master Only)

Platfora stores its metadata catalog in a PostgreSQL relational database. PostgreSQL version 9.2 or 9.3 must be installed (but not running) on the Platfora master server before you start Platfora for the first time. Platfora worker nodes do not require a PostgreSQL installation.

You must have root or sudo permissions to install PostgreSQL.

Install PostgreSQL 9.2 on Ubuntu Systems

These instructions are for installing PostgreSQL 9.2 on Linux Ubuntu operating systems. 1. Install the dependent libraries:

$ sudo apt-get install libpq-dev

2. Add the PostgreSQL repository to your system configuration:

$ sudo add-apt-repository ppa:pitti/postgresql $ sudo apt-get update

3. Install PostgreSQL 9.2:

$ sudo apt-get install postgresql-9.2 4. Stop the PostgreSQL service.

$ sudo service postgresql stop

5. Remove the PostgreSQL automatic start-up scripts:

$ sudo rm /etc/rc*/*postgresql

6. Create and change the ownership on the directory where PostgreSQL writes its lock files:

$ sudo mkdir /var/run/postgresql

$ sudo chown platfora /var/run/postgresql

7. Update the platfora user’s PATH environment variable to include the PostgreSQL executable directory and /usr/sbin:

$ echo "export PATH=/usr/lib/postgresql/9.2/bin:/usr/sbin:$PATH" >> / home/platfora/.bashrc

$ source /home/platfora/.bashrc

Install PostgreSQL 9.2 on RedHat/CentOS Systems

These instructions are for installing PostgreSQL 9.2 on RedHat Enterprise Linux (RHEL) or CentOS operating systems.

1. Download the appropriate PostgreSQL 9.2 YUM repository for your operating system. Go to the PostgreSQL yum repository website, copy the URL link for the appropriate YUM repository configuration, and download it using wget.

For example, to download the YUM repository configuration for PostgreSQL 9.2 on a 64-bit RHEL 6 operating system.

$ wget http://yum.pgrpms.org/9.2/redhat/rhel-6-x86_64/pgdg- redhat92-9.2-7.noarch.rpm

2. Add the PostgreSQL YUM repository to your system configuration:

3. Install PostgreSQL:

$ sudo yum install postgresql92 postgresql92-server 4. If it is enabled, disable the PostgreSQL automatic start-up.

Each operating system has its own technique for auto starting PostgreSQL. If your system uses chkconfig to manage init scripts, you can remove PostgreSQL from the chkconfig control using the following command:

chkconfig --del postgresql

For some operating systems, the PostgreSQL start.conf file configures the auto-start of a specific PostgreSQL cluster.

5. Create and change the ownership on the directory where PostgreSQL writes its lock files:

$ sudo mkdir /var/run/postgresql

$ sudo chown platfora /var/run/postgresql

6. Update platfora user’s PATH environment variable to include the PostgreSQL executable directory and /usr/sbin:

$ echo "export PATH=/usr/pgsql-9.2/bin:/usr/sbin:$PATH" >> /home/ platfora/.bashrc

$ source /home/platfora/.bashrc Confirm OpenSSL Installation

Platfora uses OpenSSL for secure communications between the Platfora worker servers and its metadata catalog database. If you decide to enable SSL for the Platfora catalog, which is optional, you will need OpenSSL version 1.0.1 or higher on your Platfora nodes.

As an optional security feature, you can choose to enable SSL communications between the Platfora metadata catalog and the Platfora worker nodes. If you decide to enable this, you will need to have: • SSL-enabled PostgreSQL. If using the RPM installation packages, Platfora provides an optional

platfora-security package that contains SSL-enabled PostgreSQL. If using the TAR

installation packages, the packages provided in the PostgreSQL public repo come with SSL enabled. • OpenSSL. If using the RPM installation packages, Platfora provides an optional platfora-

security RPM package that pulls this dependency from the public repo. If using the TAR installation packages, you will have to install the openssl package yourself.

Many Linux operating systems already have OpenSSL installed by default, but you need to make sure the version is compatible with the version that PostgreSQL uses.

1. Check that OpenSSL version 1.0.1 or higher is installed.

$ openssl version

2. If OpenSSL is not installed (or you have an incompatible version) you will need to install or upgrade it before enabling SSL for the Platfora catalog. Check your OS documentation for instructions on installing or upgrading the openssl package.

In document Platfora Installation Guide (Page 35-39)