Home > Cloud Cruiser 4 > Installing > Installing the Cloud Cruiser application

Installing the Cloud Cruiser application

Table of contents
No headers

This article is part of To install Cloud Cruiser:

4. Install 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.

Before you begin

If you will use a named instance of SQL Server, ensure that the SQL Browser service is running prior to starting the Cloud Cruiser installer. 

To install the Cloud Cruiser application

  1. Launch the installation wizard.​

    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.

    • 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>.jar
      You must run the Linux installer in GUI mode. Console mode is not supported. You also have options for controlling whether the installer runs as an upgrade.
  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.
    To make the best use of disk space, consider installing Cloud Cruiser on its own partition. If you install Cloud Cruiser on the primary partition (such as the C drive on Windows systems), consider creating your working directory on a separate partition. For example, if you install Cloud Cruiser on the C drive, consider creating your working directory on the D drive.

    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 to Cloud Cruiser as the default admin user, which has administrator rights. The admin user is the only Cloud Cruiser user created by the installer.

    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

    (SQL Server only) 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.

    If you are using a named instance of SQL server, provide any port number. the SQL Browser will resolve the port number as needed after installation.

    Additional URL
    Properties

    (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 Active Directory domain of the machine where you are currently installing. In this case, the Application User, Reporting 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 a user Cloud Cruiser uses to connect to the database. The installer creates this user and schema in the database.

    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.

    Password

    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.

    Reporting User

    Name of a user Cloud Cruiser uses for Cloud Cruiser Analytics reporting. The installer creates this user and schema in the database.

    You will specify this user when setting up the data source for Cloud Cruiser Analytics.

    Leave blank if using an Integrated Security Domain.

    If the specified user already exists, the install will delete the existing user.

    Password

    The password to create for the Reporting 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 this user has the sysadmin role.

    DBA Password

    The password for the DBA User.

    Leave blank if using an Integrated Security Domain.

     
  8. At the Install Summary screen, click Next.
    The installer unpacks files to the install path you specified.
  9. At the Installation screen, click Next after the pack installation completes.
    The Processing screen appears, updating you with the progress of the installer as it creates objects on your database server.
  10. When the installer has completed its processing, click Next.
  11. At the Installation Finished screen, click Done.
  12. (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.

    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.

    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.

  13. (Linux only) Configure the Cloud Cruiser application to start automatically when the machine starts:
    1. Copy the ccapp file from the <intall_directory>/bin directory to the /etc/init.d directory.
    2. Run the following command:
      update-rc.d ccapp defaults
  14. (Linux only) After restarting Cloud Cruiser, complete one of the following actions to ensure that the DISPLAY variable set for the X Window System used for installation does not interfere with Cloud Cruiser report displays:
    • Unset the DISPLAY variable.
    • Add the following line to the CATALINA_OPTS section of the ccserver.sh file:
      -Djava.awt.headless=true

You have successfully installed the application server.

What to do next

To install Cloud Cruiser:

You might also want to log in to the Cloud Cruiser Portal to start configuring the product. For instructions, see Accessing the Cloud Cruiser Portal.

Last modified

Tags

Classifications

This page has no classifications.
© Copyright 2018 Hewlett Packard Enterprise Development LP