Installing the Cloud Cruiser Express application

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.