Application onboarding without Fast Scan - Add a new Application

To add a new Application, your Console login must have the Admin or Application Owner role.

Move to the  Console screen, if you are not already there:

Click the Add Application button:

No existing Applications

Existing Applications

A floating dialog box will prompt you to fill in details for the new Application:

Application Name

name for the Application.

  • The following characters are not authorized in Application names : \ / : * ? " < > | &
  • Identical Application names are not authorized.
  • Application names are case insensitive, therefore attempting to create an application called TEST when test already exists will result in an error.

Corresponding schema names created on the CAST Storage Service/PostgreSQL instance

General constraints:

  • Three schemas are required using the following suffixes, except where a GUI is used as explained below:
    • _mngt = Management schema
    • _local = Analysis schema
    • _central = Dashboard schema
  • A valid CAST Storage Service/PostgreSQL schema name is a string of 63 or fewer characters.
  • The schema name must begin with a letter or an underscore (_).
  • Subsequent characters can be letters, underscores or digits (0-9).
  • Schema names beginning with "pg_" are reserved for system purposes and therefore cannot be used.

Taking into account the constraints mentioned above, Console does the following list of transformations to generate a prefix from the given application name, in this example: *8App_Prod! (main.app)

  • take the application name and put it in lower case: *8-app_prod! (main.app)
  • replace space, dash "-" or dot "." and replace with an underscore: *8_app_prod!_(main_app)
  • remove all invalid characters (the characters that are not letters, underscores or digits (0-9)): 8_app_prod_main_app
  • if the prefix starts with a digit or "pg_", add an underscore before: _8_app_prod_main_app
  • if the prefix is longer than 55 characters (63 - 8 characters for suffix) reduce it to 55 by removing the last characters, giving:
    • _8_app_prod_main_app_mngt
    • _8_app_prod_main_app_local
    • _8_app_prod_main_app_central
  • if a schema with the chosen prefix already exists:
    • if the prefix is longer than 52 characters (55 - 3 characters for counter) reduce it to 52 by removing the last characters
    • for a counter from 01 to 99 add counter suffix and check if schema exists:
      • _8_app_prod_main_app_01
      • _8_app_prod_main_app_02
      • ...
      • _8_app_prod_main_app_99 
    • if all possible schemas exist then generate schema prefix from the application guid, giving the following:
      • uuid_5446d035_7d96_4f16_853e_a1b89e044029_mngt
      • uuid_5446d035_7d96_4f16_853e_a1b89e044029_local
      • uuid_5446d035_7d96_4f16_853e_a1b89e044029_central
Domain Name

domain name:

  • if this is the first Application you are adding, no domain names will exist - you can therefore either enter the name of a domain and this will be created when the Application is added, or leave the field blank in which case the Application will not belong to any domain (listed under No Domain).
  • if you have already added an Application and created a domain at the same time, or you have manually added a domain, all existing domains will be offered in a drop down list. Selecting one will assign the new Application to the existing domain.

A domain is a method of grouping Applications together primarily to assign user roles.

  • A "domain" is a method of grouping Applications together so that user roles can be assigned to all the Applications in a given Domain. Domains are managed in the Administration Center.
  • Following characters should not be used in Domain names: \ / : * ? " < > | ( )
License Key (Console ≥ 2.x only)

This field is visible in Console ≥ 2.2 only when the Named Application license key scope has been chosen by the administrator when Console was first initialized (see Complete start-up wizard - v. 2.x). It enables you to input the specific license key for the Application you are creating. The license key MUST match the name of the Application you are creating.

This field is not visible in Console 1.x.
CSS Server (Console ≥ 2.x)

This field is visible in Console ≥ 2.2 only, when more than one CAST Storage Service/PostgreSQL instance has been added and configured for analyses in Administration Center - Settings - CSS and Measurement settings. It enables you to choose which CAST Storage Service/PostgreSQL instance will store the database schemas required for the new Application. By default, the CAST Storage Service/PostgreSQL instance with the lowest number of CAST related schemas already stored on it will be used (i.e. it will be preselected). 

The PostgreSQL database name is shown to help you choose the correct host:

This field is not visible in Console 1.x.
Nodes (Console ≥ 2.8 - Enterprise mode)

This field is visible in Console ≥ 2.8 Enterprise mode only, when more than one Node has been added and configured for analysis purposes (see Administration Center - Nodes). It enables you to choose which Node will ALWAYS be used for the new Application. By default, this will be set to Any, meaning Console will function in load balancing mode, as explained in more detail in Administration Center - Applications - Application Details.

Nodes (Console 1.x)

Choose the Node on which you want to add the Application. All schemas required for the new Application will be installed on the CAST Storage Service/PostgreSQL server associated with the selected node (this was configured during the Node package - back-end installation):

This field is not visible in Console ≥ 2.0: Nodes are stateless and a load balancing mechanism is in place, therefore, the Node is chosen automatically by Console. Console will always choose the Node running the most recent release of AIP Core for the add application action. If multiple Nodes are running the same most recent release of AIP Core, then Console will choose the least busy Node.
Manage Version History
Available in Console ≥1.26.

This option determines the Delivery Mode that will be used for your application. By default the option will be ticked, meaning that the application is created in a standard way and all version history is retained. Unticking the option will cause the application to be created using a "rapid" delivery mode, where no version history is retained. See AIP Console - Delivery Modes for more detailed technical information about the different modes available.

It is not possible to change modes once you have created an application.

Click Add to start the process:

The process will begin (click to enlarge) - you can stop it any time using the STOP button:

A successful addition is shown below (click to enlarge) - you can click the "View Log" options to view the log for each step in the process:

What is installed with a new Application?

When you add a new Application, the following actions are performed:

  • A Delivery folder (a central location specific to the Application used for storing successive and compressed versions of an Application's source code) dedicated to the new Application is created in the specified location (either a shared folder or on the Node itself (v1.x only).
  • Three Application schemas are created on the CAST Storage Service/PostgreSQL server associated to the Node - these schemas are created from dumps shipped with AIP Core, therefore their release number will match the release of AIP Core used on the Node. These schemas are used to store the analysis data. Details about these schemas can be seen by users with the Admin role in Administration Center - Applications - Application Details. The names used for the three schemas will mirror the Application name as shown below, except in situations detailed previously in this document:
    • Management schema (<appname>_mngt)
    • Analysis schema (<appname>_local)
    • Dashboard schema (<appname>_central) - note that if you using AIP Core for CAST Imaging, this schema is not created.
  • No CAST extensions are installed at this time. See Application - Extensions for more information.