Product Documentation

Appliance ELM

Jan 11, 2018

The Citrix App Layering appliance, also known as Enterprise Layer Manager (ELM), is a virtual appliance that coordinates communication in the App Layering environment and manages copies of your Layers and Image Templates. Based on CentOS, the appliance hosts the Management Console, a friendly interface where you create Layers and use those Layers to publish Layered Images.

You can log into the appliance and modify the administrator password, network address, NTP servers, and Time Zone settings by using the Appliance Configuration utility.

Before you start

Make sure that:

  • The App Layering Appliance is running in your hypervisor.
  • You have the password for an account with administrator privileges

Log into the appliance using an account with administrator privileges

Using either your hypervisor console or SSH, log into the appliance as administrator (default password Unidesk1).

Note: If the appliance is in Azure, type /opt/sbin/cfg_launcher, and press Enter.

This opens the Appliance Configuration utility.

Change the administrator password

The App Layering Appliance (aka Enterprise Layer Manager) is managed using three administrative accounts.

  • Administrator account for the Management Console - The account for the management console, which is hosted on the App Layering Appliance.
  • root user account for the appliance - The default Linux super user account, which has access to all commands and files on the appliance's Linux OS. WARNING: This password is required if you ever need to reset your other administrative accounts.
  • administrator account for the appliance - The account for the command line utility where you can change the appliance's network setting, date, time, ntp server, or time zone.

Use these steps to change the password for any of the appliance's administrative accounts.

  1. If this is the first time you are logging into the management console on a freshly installed appliance, take a moment to familiarize yourself with the administrative accounts for the appliance.
  2. For each account, enter the new password and then re-enter it in the Confirm Password field.
  3. On the Confirm and Complete tab, click Change Credentials.

Configure networking (includes Static IP Address option)

You can change the appliance's IP address and/or its DNS servers. When the appliance is first deployed, the DNS settings are retrieved through DHCP. If DHCP is not available and you will be using static IP addresses, once you select Static, you will be prompted to enter the IP addresses for your DNS servers.

  1. Log in to the Appliance Configuration utility, as described above.
  2. At the Action prompt, enter C (for Configure Networking), and press Return.
  3. At the next prompt, type D for Dynamic (DHCP) or S for Static.
    If you choose Static, you will be prompted for the IP address and Subnet mask, along with default addresses for the Gateway and DNS addresses.
  4. When prompted, enter Y to save settings.
  5. At the Action prompt, enter Q to quit.
  6. Restart the appliance.

Synchronize the system clock with NTP servers

You can synchronize the system clock on the ELM by configuring NTP servers. You can specify how many NTP servers you need, with 6 being the maximum. And, you can add and remove NTP servers, as needed. Where possible your existing servers will be used as defaults.

  1. Log in to the Appliance Configuration utility, as described above.
  2. At the Action prompt, enter N for NTP servers change, and press Return. A list of your current NTP servers is displayed.
  3. At the prompt, specify how many NTP servers you need by typing a number from 0 to 6.
    0 - All servers will be removed (you will be warned).
    1-6 - You will be prompted to accept or replace each of the current servers. 
  4. For each server, press Enter to accept the current value. Or, enter a new server address (Example: 3.pool.ntp.org). Once the last address is entered, an NTP Server Summary is displayed.
  5. Enter S to save the settings.
  6. At the Action prompt, enter Q to quit.
  7. Restart the appliance.

Change the Time Zone

  1. Log in to the Appliance Configuration utility, as described above.
  2. At the Action prompt, enter T for Timezone change, and press Return. The current time zone is displayed.
  3. Press Enter to display available timezones. The first bunch of time zones are displayed in alphabetical order, starting with the
  4. Advance through the timezone codes until you see yours:
    Enter - Advances one line at a time.
    Page Up Page Down - Displays the next or previous screen full of choices.
    Or search the timezones:
    Type Slash (/) and part of the name you are looking for.
  5. When your timezone is displayed, press Q to get to the prompt.
  6. Type the number for your timezone. The timezone you entered is displayed.
  7. Press Enter to complete the change.
  8. At the Action prompt, enter Q to quit.
  9. Restart the appliance.