Administration Guide > Installation > New Installation > ONE Installer - Single-Box Installation

ONE Installer - Single-Box Installation

The ONE Installer allows a fast single-box setup for demonstrations, testing, or feature previews on-site.
Prerequisites are kept to a minimum (for example a databaseA database is an organized collection of data including relevant data structures. and userIn the Automation Engine, a user is an instance of a User object, and generally the user is a specific person who works with Automic products. The User object is assigned a user ID and then a set of access rights to various parts of the Automation Engine system and product suite. These access rights come in the form of Automation Engine authorizations and privileges, Decision user roles and EventBase rights and ARA web application object rights. You can manage all these centrally in the ECC user management functions. See also, Unified user management., a local loginAn Automation Engine object type that stores account credentials used by agents on target systems. and free local ports are required).
The installer is available for Automic Workload Automation (AWA) as well as for Automic Release AutomationAutomic Release Automation (ARA), is an end-to-end solution for planning, coordinating and automating software release processes, including automated deployment of applications across large-scale server environments and covers all mentioned use cases. [Formerly called "Application Release Automation", "Release Manager" and "Deployment Manager"] (ARA).

The following contains an overview of the steps the ONE Installer will pass and the necessary user interactions for a few individual steps.

Updating from previous AE or ARA versionsAn application version holds zero or more deployment packages and may have dependencies to zero or more application versions of the same (or to different) applications is not supported.

Requirements

Component

Requirement

Operating Systems

Windows:

Windows Server 2012, 2012 R2

Linux: RedHat Enterprise Linux 5, 6
SuSE Linux Enterprise Server 11

Database

Microsoft SQL Server 2012, 2014
Oracle 11.2, 12c

Ports

The following ports and port ranges need to be free respectively:

2217-2221 (for CP connections)
2270-2279 (for WP connections)
8005, 8009, 8080 (for Tomcat connections used by the ECCAbbreviation for the Enterprise Control Center)
8871 (ServiceManagerA program that facilitates the starts and stops of Automation Engine components.)


Prerequisites

You have to prepare the following before starting the ONE Installer:

On Windows: Make sure you do not have a Windows service for the ServiceManager registeredThis is the status of a task that runs within a group and is waiting for its start. prior to running the installation.

On UNIX: You must execute the installer with root privilegesPrivileges in the Automation Engine refer to user rights to work with certain frontend and user interface functions. You grant privileges to users in the Automation Engine..

On Windows: You require administrative rights to execute the installer.

On UNIX: Executing the installer from network shares with NFS is not recommended.

 

Installed Packages and Components:

Additional Action packs and/or RA solutions will be installed, if present. The contents of packagesDelivery package, a bundle of functionality. is determined by Automic and may vary between releases.

The ONE Installer installation provides the following:

The installation will set up an AE system with additional client and user account besides the system client.
During the attended mode and the CLI mode installation you will be asked to enter the necessary information.

The ONE Installer creates a log file in the root installation folderTop level entities such as Environment, Deployment Target, Activity, … are stored in folders. The permissions a user has on an entity depend on the permissions that are set on the folder for the entities. (e.g., C:\Automic\install.log).

 

Post-installation Task (Optional)

As a performance enhancing taskAn executable object that is running. Tasks are also referred to as activities. you can change Max Perm Size and Heap Size of your Tomcat prepared by the ONE Installer as described in Installing and Preparing the Apache Tomcat Web Server.

 

Available Installation Modes

  1. Attended installation using the graphical user interfaceA graphical user interface (GUI) is a human to machine interface based on windows, icons and menus which can be operated by a computer mouse in addition to a keyboard. In contrast to command line interface (CLI)..
  2. Unattended installation using a file containing the required information.
  3. Command line interface installation

 

I. Attended Mode:

  1. Unzip the delivered files to a local directory of your choice and start the installer using install.exe/install.sh
    The installer will automatically install all components you downloaded and unpacked, depending on the packages present.

  2. After starting the installer, the second screen will display the installation overview.


  3. The ONE Installer checks, if the preconditions are fulfilled.
    On the left hand side of the pane you see a short listShows entities in a grid view of the installation steps.
    If the ONE Installer finds discrepancies, it will attempt to fix the preconditions.

  4. You will be asked to define the database you chose to install (MS SQL or Oracle).

  5. The installer will then check whether the necessary database drivers are present.

  6. You will be asked to point the installer to the JDBC driver of your database.
    Use the provided download link, if you need to download the latest version.

    Point to JDBC (example for Microsoft, if MS SQL has been selected as database before).

  7. Enter the database connection values for the AE database.
    You can test the connection using the button provided. ONE Installer will test the connection automatically as soon as you click 'Next'.

  8. Decide in which directory the files should be installed. The default is C:\Automic, but you can change that to any local path.
    Spaces in paths are not allowed, so take care to define a path without spaces.

  9. Point to the path of your license file you got from Automic.

  10. You will be asked to confirm the license information pertaining to the external software (e.g. Oracle Java) that will be installed.

  11. Enter the client data for the first client the ONE Installer will create.
    Choose a client number between 0001 and 9999 (0000 is reserved for the system client), a user nameName of the Automation Engine user., the departmentDepartment name to which the Automation Engine user belongs. and a password.

  12. Enter the credentials which the agentA program that enables the de-centralized execution of processes (such as deployments) on target systems (computers or business solutions) or a service that provides connectivity to a target system (such as for databases or middleware). An agent is also an object type in the Automation Engine. [Formerly called "Executor."] See also: host should use to execute jobs on the machine on which the ONE Installer is running and the Automation EngineThis component drives an Automation Engine system and consists of different types of server processes.will be installed.
    Take care to enter the correct user credentials, as the information will not be checked in this step.

  13. The installation will start and a progress bar and information about the installation progress will be visible.

After successful installation, the ECC login page opens in your default Internet browser. Log in with the user credentials that you specified during the installation.

 

II. Unattended Mode

In order to use the installer in unattended mode, you can start the installation and use a configurationA set of constituent components that make up a system. This includes information on how the components are connected including the settings applied. file.
Call it by using the following arguments in the directory you extracted the files to:

On Windows: install.exe –q –varfile <path-to-varfile> -dir <path-to-installation-directory>
On Linux: install.sh –q –varfile <path-to-varfile> -dir <path-to-installation-directory>

You can choose name and extension of the varfile. Defining an installation directory path is optional.
Special characters have to be escaped out, as shown below.
The parameters have to be entered and used as shown in the example.

Example .varfile

JDBC_DRIVER_JAR=C\:\\app\\oracle12c\\product\\12.1.0\\dbhome_1\\jdbc\\lib\\ojdbc7.jar
DB_SERVER$Integer=1

DB_CODESET$Integer=0
DB_DATABASE=aedb
DB_HOST=localhost
DB_PORT=1521
DB_USER=aedbuser
DB_PASSWORD=aedbpassword
CLIENT=100
USERNAME=AUTOMIC
DEPARTMENT=AUTOMIC
PASSWORD=AUTOMIC
LOGIN_USER=automationuser
LOGIN_PASSWORD=automationpassword
LICENSE_FILE=C\:\\path\\path\\licence.txt

The .varfile Parameters:

Name

Description

DB_SERVER

Type of the database server to use.

0 : Microsoft SQL-Server
1 : Oracle 

DB_HOST

Name or address of the database server that the new AE installation should use.

DB_PORT

IP port that is used to connect to the AE database.

DB_DATABASE

Name of the database (MSSQL) or SID/Service-Name (Oracle) that the AE installation should use.

DB_CODESET$Integer

This setting is only used for installations that use an Oracle database (DB_Server = 1).

0 : UTF-8
1 : ISO-8859-15

DB_USER

Name of the database user in the AE database.

DB_PASSWORD

Password of the database user in the AE database.

JDBC_DRIVER_JAR

Location of a JDBC driver file that should be used to connect to the AE (and Automic Release Automation) database.
This file has to match the choice in DB_SERVER and the installed database and Java versions.

LICENSE_FILE

Location of the Automic license file that should be used by the newly installed system.

CLIENT

Client number of the AE client that is created by the installer.

USERNAME

User name of the AE user that is created by the installer. (Use AE allowed characters.)

DEPARTMENT

Department of the AE user that is created by the installer. (Use AE allowed characters.)

PASSWORD

Password of the AE user that is created by the installer.

LOGIN_USER

User name for a login objectLogin objects store account credentials used by agents on nodes. Account credentials can be related to single nodes or shared between a set of nodes (E.g. shared account). that will be used by the OS agent. This should match an user account on your local system.

LOGIN_PASSWORD

Password for the user account specified in LOGIN_USER.

 

III. Command Line Mode

The installation steps will be the same as in GUI mode. You will have to enter the required information or confirm actions, using the displayed commands or options.

  1. In order to start the installer, in Windows (or Linux) open a command line window in the directory you unpacked the files to and then use the following commands:
    Windows: start /wait install.exe -c
    Linux: install.sh -c
  2. A short installation overview will be displayed.
  3. The installer then will check if preconditions have been fulfilled and attempt to fix them, if discrepancies exist.
  4. Define the database that you installed (MS SQL or Oracle).
  5. Point the installer to the JDBC driver of your database.
  6. Enter the connection values for the database.
  7. Choose the installation path. Default is C:\Automic, but you can define a path of your choice.
    Spaces in paths are not allowed so take care that the installation path does not contain spaces.
  8. Point the installer to your license file you received from Automic.
  9. Confirm the license information pertaining to the external software (Oracle Java) that will be installed.
  10. Enter the client data for the first client the ONE Installer will create.
    Choose a client number between 0001 and 9999 (0000 is reserved for the system client), a user name, the department and a password.
  11. Enter the agent's credentials to execute jobs on the machine on which the ONE Installer is running and the Automation Enginewill be installed.
    Take care to enter the correct user credentials, as the information will not be checked in this step.
  12. The installation will start, and after successful installation, the ECC login page opens in your default Internet browser.
    Login with the user credentials that you specified during the installation.

 

The system that has been installed is a basic Automation Engine system.
For high redundancy or more sophisticated setups please continue with the additional pages of the installation chapter.

 

Comments

The installation sets up the ServiceManager to be started automatically on system boot as a Windows Service or Linux daemon scriptA particular Automation Engine object type.. All other Automic processes are then automatically started by the ServiceManager. It is possible that not all processes can be started at boot time.

Example:
Tomcat cannot start because another process has already reserved the required port 8080, which results in the ECC not being available. In order to check that all processes could be started, do one of the following:

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH