

# Step C: Install the Elemental Live software
Strong passwords

The guide has been updated in several sections to include a recommendation to set always set a strong password.New options for enabling the OCR conversion feature

The installer now includes more options for enabling this feature, specifically to support setup on a node that doesn't have access to the internet.

Perform these steps on each AWS Elemental Live hardware unit, either directly at the hardware unit or from your workstation via SSH. 

**Topics**
+ [

## About Installer Options
](#install-live-sw-about-options)
+ [

## Setting up OCR Conversion in Versions 2.22.0 to 2.23.0
](#install-live-sw-ocr-2220)
+ [

## Setting up OCR Conversion in Versions 2.23.1 and later
](#install-live-sw-ocr-2231)
+ [

## Installing the Software
](#install-live-sw-procedure)

## About Installer Options


To install Elemental Live, you run the installer. The installer has options that control the way the installer works:
+ *Action options *instruct the installer to perform an action. For example, `--cleandb` instructs the installer to clean out the database.
+ *Skip options *instruct the installer to omit specific prompts. For example, `--skip-tz` instructs the installer to skip the timezone prompt.

To display built-in help about all the options, log in with the *elemental* user credentials, then enter this command at the Linux command line:

```
[elemental@hostname ~]$ sudo sh ./elemental_live_cpu_2.25.4.12345.run --help
```

### The skip-all Installer Option


The installer has a `--skip-all` option that skips all the prompts and performs the default choice for all options.

You should only use this option after you have followed the following procedure, and you have read the built-in help carefully.

The `--skip-all` option means that the installer won't present prompts. It will perform some actions using default information.

## Setting up OCR Conversion in Versions 2.22.0 to 2.23.0


The installer for Elemental Live versions 2.22.0 to 2.23.0 includes an option to set up the feature to convert captions using OCR conversion. (For information about the OCR feature, see [Support for OCR Conversion](https://docs.aws.amazon.com/elemental-live/latest/ug/support-for-ocr.html) in the *AWS Elemental Live User Guide*.)

**To set up this feature**

**Note**  
The Elemental Live node must have a connection to the internet. It needs this connection because the installer must download the OCR libraries from the internet. These libraries are language dictionaries used in the conversion.  
If the node doesn't have an internet connection, consider upgrading to a version after version 2.23.0. Newer versions of Elemental Live include more options for installing the OCR feature.

Run the installer with these options: 
+ With the `--install-ocr` option. You won't be presented with prompts to set up OCR. Instead, the installer will automatically set it up.
+ You can include or omit the `--skip-all` option, depending on whether you want to be presented with prompts for other features.

**To omit the feature**

If you don't want to set up this feature, run the installer with these options:
+ Without the `--install-ocr` option. The installer won't set up the OCR feature. 
+ You can include or omit the `--skip-all` option.

## Setting up OCR Conversion in Versions 2.23.1 and later


The installer for Elemental Live version 2.23.1 and later includes several options to set up the feature to convert captions using OCR conversion. (For information about the OCR feature, see [Support for OCR Conversion](https://docs.aws.amazon.com/elemental-live/latest/ug/support-for-ocr.html) in the *AWS Elemental Live User Guide*.)

Setting up this feature involves three steps:
+ Downloading the OCR libraries from the internet. These libraries are language dictionaries that are used in the captions conversion.
+ Installing the libraries on the node.
+ Enabling the OCR feature.

**To set up the feature on a node with access to the internet**

Run the installer with these options:
+ With the `--install-ocr` option. The installer will download the libraries from the internet, install them on the node, and enable the OCR feature. You won't be presented with prompts to set up OCR.
+ You can include or omit the `--skip-all` option, depending on whether you want to be presented with prompts for other features.

**To set up the feature on a node without internet access**

1. Download the OCR libraries file [live-ocr-tesseract-data.zip](http://d3v4cjmjhvrkiz.cloudfront.net/live-ocr-tesseract-data.zip).

   Keep the file zipped.

1. Use a method such as SCP to move the zipped file to a location on the Elemental Live node that you are setting up. For example, move to this location:

   `/home/live-ocr-tesseract-data.zip`

1. Run the installer with these options:
   + With the `--install-ocr-zip` option. This option includes a parameter for the folder where you copied the libraries file. For example: 

     `-- install-ocr-zip /home/live-ocr-tesseract-data.zip`

      You won't be presented with prompts to set up OCR.
   + You can include or omit the `--skip-all` option, depending on whether you want to be presented with prompts for other features.

**To omit the feature**

If you don't want to set up this feature, run the installer with these options:
+ Without the `--install-ocr` option. The installer won't install or enable the OCR feature.
+ With the `--skip-ocr` option. If you don't include this option, you will be presented with prompts to install OCR, even though you didn't include the `--install-ocr` option.
+ You can include or omit the `--skip-all` option, depending on whether you want to be presented with prompts for other features.

## Installing the Software


**To install the software**

1. At the Linux command line, log in with the *elemental* user credentials. 

1. Decide which options you want to include with the installer. You can include options in the command to automate some of the installation. To display built-in help about all the options, enter this command:

   ```
   [elemental@hostname ~]$ sudo sh ./elemental_live_cpu_2.25.4.12345.run --help
   ```

1. Run the installer as follows. Use the actual file name of your `.run` file, rather than the example below.

   For GPU and CPU versions of the software.

   ```
   [elemental@hostname ~]$ sudo sh ./elemental_production_live_2.25.4.12345.run  options
   ```

   For CPU-only versions of the software.

   ```
   [elemental@hostname ~]$ sudo sh ./elemental_production_live_cpu_2.25.4.12345.run options
   ```

1.  Follow the prompts. This table specifies the prompts that appear when you don't include any options for the installer.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/elemental-live/latest/installguide/install-lv-ig-install-sw.html)

   When the software install is complete, this message appears:

   ```
   Installation and configuration complete!
   ```

1. Start a web browser and start the Elemental Live web interface by typing the following:

   ```
   https://<hostname>
   ```

   Make sure the web interface displays.