Knowledge Base/Engine Yard Cloud Documentation/Deploy your Application

Add UNIX Packages to Your Application

Jane Day
posted this on March 01, 2012 03:50 PM

Updated: May 28th, 2013

You can add additional software packages to your application within Engine Yard Cloud. Packages are added at the account level. After a package is applied to specific environment, it cannot be removed from that environment. (Although, after a package is dissociated from an application, new environments for that application do not have the package.)

To configure additional software packages for your application

  1. In the dashboard, click the name of the environment you want to modify.

  2. Click the Edit Unix Packages link.

  3. Search for your package.

    For example rabbitmq for RabbitMQ.

    Results appear in the Available UNIX Packages list.

  4. Click Add ->.

    The package appears in the Selected UNIX Packages list.

  5. To install the package on an existing environment:

    a. Click Go to dashboard.

    b. Click the environment name.

    c. Click Apply.

  6. To install the package on new environment:

    a. Click Go to dashboard.

    b. Create and boot a new environment for the application.

Tip: To search for exact packages and versions, first run eix-sync on one of your instances, then emerge -s "package_name" to search for specific packages and see what versions are available. Alternatively, eix packagename can be used to show more results.

To remove a software package

  1. In the dashboard, click the name of the environment to remove the software package from.

  2. Click the Edit Unix Packages link.

  3. Click x Remove for the package.

    This removes the package from the UI but does not remove the package from any currently running environments.

More information

For more information about...                                    See...
Create an environment  Create an environment.                                                       

If you have feedback or questions about this page, add a comment below. If you need help, submit a ticket with Engine Yard Support.

 

Comments

User photo
Jason Ivers
RepAnalyzercom-LLC

Is this still applicable?  When I click the name of my application from the dashboard, I don't see the icons I used to see for adding gems and Unix packages (gems are in the Gemfile, anyway).

Is it possible, if this is still the correct documentation that you could either post or send me a screenshot showing where I'm supposed to find the "Unix Packages icon"?  I don't even see Unix or Package(s) anywhere in the source, let alone on the actual page.

March 05, 2013 07:43 PM
User photo
Keri Meredith
Engine Yard Inc.

Hi Jason, The docs need to catch up to the UI, which just changed last week. There is an additional step or two now:

Go to your app and click the Edit link. The gems and UNIX icons have moved to this page.

The icons were moved because if you want to add gems to your application, best practice is to use Bundler. This also avoids versioning issues.

It is also uncommon to have an installation that needs custom UNIX packages without custom Chef. If you're writing custom Chef, then best practice is to install the packages in Chef rather than using the link.

Hope this clarifies for you. Thanks for the doc reminder. kjm

March 05, 2013 10:28 PM
User photo
Keri Meredith
Engine Yard Inc.

We changed the UI - now you can find the link on the environment page itself. Doc updated accordingly. kjm

May 28, 2013 10:54 PM
User photo
Marcin Kucharski
auss

Was it moved again ? :) I do not see it :)

June 27, 2013 01:18 AM
User photo
Keri Meredith
Engine Yard Inc.

Hi Marcin, Sorry about this.

It's on the Environment page. (I can't see my trial testing account now, so cannot exactly duplicate your situation.)

Here's where I see it:

Screen_Shot_2013-06-27_at_1.35.01_AM.png

June 27, 2013 01:37 AM
User photo
James Pollard
eunev

Is there a way we can tell what version a unix package with add? For example the unix package for 'media-gfx/imagemagick' just says 'media-gfx/imagemagick'. Would this install imagemagick 6.8.6.8?

November 14, 2013 06:49 PM