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 | A name for the Application.
Corresponding schema names created on the CAST Storage Service/PostgreSQL instance General constraints:
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)
|
---|---|
Domain Name | A domain name:
A domain is a method of grouping Applications together primarily to assign user roles.
|
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.