Home > Cloud Cruiser Express 3 > Installing Cloud Cruiser Express (public) > Installing the Cloud Cruiser Express application

Installing the Cloud Cruiser Express application

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

  • Installs the application server.
  • Configures the database and creates the financial schema.
  • Configures and schedules jobs to collect and load data from Windows Azure Pack.
  • Imports default resources to use with Windows Azure Pack, with sample pricing.
  • 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.

The application server is installed as a system service that you can manage from the Services administrative tool. The service’s name is Cloud Cruiser .

When installing the Cloud Cruiser Express 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, right-click the base directory, select Properties, and change the access permissions.

To install the Cloud Cruiser Express application
  1. Launch the installation wizard by double-clicking the downloaded CCExpress-installer-<version>.exe file.
  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 .
    CAUTION: 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.

     
  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
    Properties

    (optional) Additional connection parameters needed to establish a database connection. If using a named instance of SQL Server, specify it here by entering instancename=<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.

    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 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 Azure Pack Parameters screen, fill out the required information:

    Name

    Name for this data source.

    You are only allowed one data source with Cloud Cruiser Express, so its name is not important.

    Usage Server

    Hostname or IP address of the Windows Azure Pack Usage API computer.

    This is the server from which Cloud Cruiser Express collects subscription and usage data. It is the same as the Admin Site computer unless you have installed these Windows Azure Pack components separately.

    User

    The username for your Usage API user account.

    Unless you have changed this name with a
    Set-MgmtSvcSetting command, it is UsageClient .

    Password

    The password for the User.

    If you have not yet set a password for your Usage API user account, do so before continuing. For instructions, see Setting the Windows Azure Pack API password.

    Comments

    (optional) Comments that will be displayed in the user interface when managing parameters. Limited to 250 characters.

  9. Click Next.
    The installer verifies the credentials you provided by logging in to the Windows Azure Pack Usage API. If the login attempt is unsuccessful, the message Credentials are invalid. Continue anyway? appears. If you are unable to correct the error at this time and choose to continue with the installation, you must later provide working credentials as documented in Completing an installation that did not connect to Windows Azure Pack.
  10. At the Install Summary screen, click Next .
    The installer unpacks files to the install path you specified.
  11. At the Installation screen, click Next after the installation completes.
    The installer creates objects on your database server.
  12. At the System Configuration screen, click Next after the processing completes.
  13. At the Installation Finished screen, click Done .
  14. 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 a batch job. 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 .

If you provided working Windows Azure Pack credentials, then after installation Cloud Cruiser Express collected subscription and usage data for the current day, and you can view the charges for this usage on the Home page of the Cloud Cruiser Express Portal or by running a report.

What to do next

If you want to use Windows authentication with SQL Server then continue to the next section, Configuring Windows authentication with SQL Server. Otherwise go to Registering the REST API endpoint with Windows Azure Pack.

You must to post a comment.
Last modified
09:48, 25 Apr 2014

Tags

This page has no custom tags.

Classifications

This page has no classifications.