Consumption Analytics Documentation

Home > Documentation for older versions > Cloud Cruiser 3 > Installing > Installing the Cloud Cruiser application

Installing the Cloud Cruiser application

Cloud Cruiser's automated installation wizard performs the following tasks:

  • Installs the application server.
  • Configures the database and creates the chargeback schema.
  • If you specify a data source:
    • Configures and schedules jobs to collect and load data from your data source.
    • Imports default resources to use with your data source.
    • Runs the collection and load jobs once to give you financial data to view before the first scheduled job run, which is usually overnight.
  • Starts the application server.

When installing the Cloud Cruiser application, the system sets permissions to all directories for administrators by default. If a user without administrator permissions installs the application, the user has read-only access to installed directories and is unable to modify the content. To change this, after installing right-click the base directory, select Properties, and change the access permissions.

If you are using a SQL Server database hosted on Microsoft Windows Azure, perform the procedure in the Knowledge Base article Installing with an Azure SQL database instead of this one.

To install the Cloud Cruiser application

  1. Launch the installation wizard.​
    • In a Windows environment, double-click the ccinstall-<version>.exe file.
    • In a Linux environment, open a terminal window to the installation location and run the command:
            java -jar ccinstall-<version>-standard.jar
      You must run the Linux installer in GUI mode. Console mode is not supported.

    If you are using a SQL Server database with Windows authentication, you must run the installation wizard as a Windows user with DBA privileges. If a user with lesser database privileges runs the wizard, it fails to create the required database objects.

  2. At the Welcome screen, click Next.
  3. On the License Agreement screen, read through the agreement and indicate your acceptance before clicking Next.
  4. At the Target Paths screen, specify the installation and working directory paths and click Next.

    On Windows, do not specify your home directory, usually C:\Users\<username>, as the Install path. By default this directory contains a shortcut named Templates that conflicts with the name of a directory the installer creates. This conflict causes an error and a failed installation. If you want to install Cloud Cruiser under your home directory, specify a subdirectory such as C:\Users\<username>\CloudCruiser.

  5. At the User Data screen, enter the required information and click Next.

    Product Name

    Name for the product that will appear under the Cloud Cruiser logo in the upper left corner of the Cloud Cruiser Portal.

    After installation, you can change this name in the Configuration page of the Cloud Cruiser Portal.

    Tomcat Port

    Port to use for the Tomcat application server

    Admin E-mail Address

    Email address of the person who will log in as the default admin user, which has administrator rights.

    Admin User Password

    Password to set for the admin user

    Time Zone

    Time zone to use for billing periods. Usage times are also displayed in this time zone.

    You should usually set this to the local time zone of the Cloud Cruiser computer. If you have users in several different time zones who will view reports, consider using Coordinated Universal Time (UTC) instead.

  6. At the Database Type screen, make a selection and click Next .
  7. At the Database Settings screen, enter the required information and click Next .
    The database settings vary slightly depending on the database type you chose:

    Database Host


    Hostname or IP address of the machine where the database server is running.

    If using a named instance of SQL Server, do not enter it here. See the Additional URL Properties field.

    Database Name

    Name of the database to be created for Cloud Cruiser.

    If the database you specify exists, the installer will delete and rebuild it.

    Service Name

    (Oracle only) Name of the Oracle service.

    Database Port

    Name of the port on which the database server is listening for connections.

    Additional URL

    (optional) Additional connection parameters needed to establish a database connection. If using a named instance of SQL Server, specify it here by entering instance=<instanceName>.

    Integrated Security Domain

    (SQL Server only) If using Windows authentication, enter the local name of the machine where you are currently installing. In this case, the Application User, DBA User, and their passwords are not needed.

    If using Mixed Mode authentication, leave this blank and fill out the remaining fields.

    Application User

    Name of the user and database schema to be created.

    Cloud Cruiser connects to the database as this user. Leave blank if using an Integrated Security Domain.

    If the specified user already exists, the install will delete the existing user and all existing schema data.


    The password to create for the Application User.

    Leave blank if using an Integrated Security Domain.

    For SQL Server, this password must comply with SQL Server's default password policy. For more information, see SQL Server Application User Password policy.

    DBA User

    Username of an existing database administrator account.

    The installer will log into the database server as this user to create the Application User and to create and populate the database named above. The DBA User’s credentials are not stored. Leave blank if using an Integrated Security Domain.

    On SQL Server, this is typically the sa user. If you specify a user other than sa , make sure that user has the sysadmin role.

    DBA Password

    The password for the DBA User.

    Leave blank if using an Integrated Security Domain.

  8. At the Collector Type screen, make a selection and click Next.
    If you do not want to install a collector at this time, choose Default Installation and skip to step 11.
  9. At the collector’s Parameters screen, fill out the required information.
    Cisco Intelligent Automation for Cloud fields and options
    HP Cloud Service Automation fields and options
    HP CloudSystem Matrix fields and options
    Windows Azure Pack fields and options
    Microsoft System Center 2012 SP1 fields and options
    VMware vSphere fields and options
    OpenStack Ceilometer fields and options
  10. Click Next .
  11. At the Install Summary screen, click Next .
    The installer unpacks files to the install path you specified.
  12. At the Installation screen, click Next after the installation completes.
    The installer creates objects on your database server.
  13. At the System Configuration screen, click Next after the processing completes.
  14. At the Installation Finished screen, click Done .
  15. (Windows only) Modify the permissions to the installation directory and its subdirectories to allow Write access to your user account and any others that will administer Cloud Cruiser.
    Without this step, you have read-only access to the installation directory tree and will be unable to perform certain tasks, including modifying batch jobs and properties files. From a File Explorer window, right-click the base directory, click Properties > Security , and edit the permissions for your user account or a group to which it belongs, adding Write .

You have successfully installed the application server and collectors.

What to do next

You might want to do one or more of the following:

Last modified



This page has no classifications.

 (c) Copyright 2017-2020 Hewlett Packard Enterprise Development LP