Nolio Automation Center Installation and Administration Guide 3.3

snottysurfsideServers

Dec 9, 2013 (3 years and 7 months ago)

3,581 views






© 2012 Nolio Ltd.
All rights reserved
The information contained herein is proprietary and confidential. No part of this document may be
reproduced without explicit prior written permission from Nolio Ltd.

Contents

Nolio Automation Center 3

Contents
Revisions ........................................................................................................................ 7
Preface ......................................................................................................................... 10
About this Document ....................................................................................................10
Intended Audience .......................................................................................................10
Related Documentation ................................................................................................10
Technical Support ........................................................................................................11
Introduction ................................................................................................................. 12
Nolio Automation Center Architecture .............................................................................12
System Requirements ..................................................................................................13
Hardware Requirements ...........................................................................................13
Recommended Hardware Configuration......................................................................13
Platform/ASAP Component Compatibility Matrix ..........................................................14
Database Prerequisites ............................................................................................15
MySQL Installation Requirements .........................................................................15
Microsoft SQL Server Installation Requirements .....................................................16
Oracle Installation Requirements ..........................................................................17
Web Browsers and Flash Player.................................................................................18
Ports and Protocols for Nolio Automation Center .........................................................18
Required User Credentials for Installation of Nolio Server .............................................19
Installing Nolio Server .................................................................................................. 21
Installing Nolio Server on GUI Platforms .........................................................................22
Nolio Server Service Management on Non-Windows Platforms ...........................................40
Performing Silent Installation of Server ..........................................................................40
Installing with varfile ...............................................................................................41
Installing without varfile ..........................................................................................41
Performing Custom Nolio Server Installation ............................................................... 44
When to Perform Custom Installation .............................................................................44
Selecting Components for Custom Server Installation .......................................................44
Installing Additional Nolio Execution Servers ...................................................................46
Installing Nolio Agent ................................................................................................... 49
Local Agent Installation ................................................................................................49
Required User Credentials for Installation of Nolio Agent ...................................................49
Performing Agent Installation using CLI ..........................................................................50
Installing Nolio Agent on GUI Platforms ..........................................................................51
Local Agent Installation in Silent Mode ...........................................................................60
Installation and Administration Guide Contents

4 Nolio Automation Center

Remote Agent Installation .............................................................................................61
Prerequisites ..........................................................................................................61
Windows ...........................................................................................................62
Linux/Solaris .....................................................................................................62
Running Remote Installation .....................................................................................63
Advanced Agent Configuration .......................................................................................65
Agent Service Management on non-Windows Platforms................................................66
Configuring Linux/Solaris for Automatic Startup of Agent .............................................66
Post-Installation Procedures ........................................................................................ 67
Controlling Nolio Server Service on Non-Windows Platforms ..............................................67
Uninstalling Nolio Automation Center .............................................................................68
Uninstalling Nolio Agent ................................................................................................68
Windows ................................................................................................................69
Linux/Solaris ..........................................................................................................69
Running Nolio Automation Center ................................................................................ 70
Launching the Client UI ................................................................................................70
Setting Up Nolio Automation Center ...............................................................................72
Overview ...............................................................................................................72
Workflow ...............................................................................................................73
Performing Nolio Automation Center Administration .................................................... 74
Overview ....................................................................................................................74
Logging in to Nolio Automation Center ............................................................................75
Navigating to the Administration Window ........................................................................77
Using the Administration Window ...................................................................................77
Managing ASAP Users and Permissions ........................................................................ 79
Overview ....................................................................................................................79
Understanding User Roles ........................................................................................80
Understanding Access Levels ....................................................................................80
Understanding Permissions.......................................................................................81
Understanding User Authentication............................................................................82
Understanding LDAP Authentication Attributes .......................................................82
Adding and Editing Users ..............................................................................................83
Adding Users Using a Batch File .....................................................................................86
Add Users Batch File Layout .....................................................................................87
Example ............................................................................................................88
Loading Users Using Batch File .................................................................................88
Importing Users from LDAP ...........................................................................................90
LDAP Browse Criteria Table ......................................................................................92
LDAP Attributes Table .........................................................................................93
Contents

Nolio Automation Center 5

Modifying the Default Administrative User's Details ..........................................................93
Deleting Users .............................................................................................................93
Adding and Editing User Groups.....................................................................................94
Deleting User Groups ...................................................................................................94
Adding Users to User Groups .........................................................................................94
Removing Users from User Groups .................................................................................95
Granting Permissions ...................................................................................................95
Granting Permissions for Server Groups .....................................................................95
Granting Permissions for Applications ........................................................................95
Granting Permissions for Environments .................................................................97
Managing Agents and Test Agents ................................................................................ 99
Overview ....................................................................................................................99
Execution Servers ...................................................................................................... 100
Adding and Editing Execution Servers ...................................................................... 100
Configuring an Execution Server ............................................................................. 102
Deleting Execution Servers ..................................................................................... 104
Nolio Agents.............................................................................................................. 104
Deleting Agents .................................................................................................... 104
Viewing Execution Server and Agent Details ............................................................. 105
Adding and Editing Agent Groups ............................................................................ 106
Deleting Agent Groups ........................................................................................... 107
Adding Agents to Agent Groups .............................................................................. 107
Removing Agents from Agent Groups ...................................................................... 107
Installing New Agents and Adding Agents to Execution Server in Remote Install ........... 108
Updating Agents ................................................................................................... 109
Upgrading Agents ................................................................................................. 109
Understanding the Upgrade Status Progress Display ............................................. 111
Nolio Test Agents ....................................................................................................... 111
Adding Agents to the Test Agents Group .................................................................. 111
Removing Agents from the Test Agents Group .......................................................... 112
Administration Tasks on Agents or Execution Servers ..................................................... 112
Collecting Execution Server and Agent Logs ............................................................. 113
Restarting an Agent .............................................................................................. 113
Managing Actions Inventory ....................................................................................... 115
Overview .................................................................................................................. 115
Managing Existing Actions ........................................................................................... 116
Adding and Editing Action Categories ....................................................................... 116
Deleting Action Categories ..................................................................................... 118
Installation and Administration Guide Contents

6 Nolio Automation Center

Adding Action Templates to Action Categories........................................................... 119
Removing Action Templates from Action Categories .................................................. 119
Managing Action Template Libraries ............................................................................. 120
Reloading Actions Libraries ..................................................................................... 120
Managing Published Processes ................................................................................... 121
Overview .................................................................................................................. 121
Publishing a Process ................................................................................................... 121
Viewing Published Processes ....................................................................................... 124
Promoting Published Processes .................................................................................... 125
Deleting Published Processes ....................................................................................... 126
Managing Application Services ................................................................................... 127
Updating Nolio Automation Center License .................................................................... 127
Displaying 3rd-Party License Agreements ..................................................................... 128
Changing Default Local Font ........................................................................................ 128
Enabling Design Auditing ............................................................................................ 129
Using MS SQL Server as Database for Nolio ................................................................ 130
Creating MS SQL Server Database ............................................................................... 130
Enabling TCP/IP Protocol and Restarting SQL Service ..................................................... 136
Enabling SQL Server Browser Service ........................................................................... 138
Using Oracle as Database for Nolio ............................................................................. 140
Creating Oracle Database ........................................................................................... 140
Checking for Oracle Listener Name............................................................................... 141
Installing Server using varfile .................................................................................... 143
Server varfile Template .............................................................................................. 143
Installing Agent using varfile ..................................................................................... 147
Agent varfile Template ............................................................................................... 147
Glossary ..................................................................................................................... 148
Index ....................................................................................................................... 150

Revisions

Nolio Automation Center 7


Ver. Date Description Topics
3.2 18-Apr-2011 Added the following functionality:


User Application permissions and management


Add users using a batch file


Import selected LDAP users into ASAP


Integrate with LDAP server


Define User Authentication: Basic or LDAP


Progress Status window during Agent Upgrade
All

Updated installation-related information:


Nolio Service owner should have permission to start a
service and write to the file system


During Remote Agent Installation, Agent executable
should be in the OS scripts folder


Hardware and software requirements


26-Apr-2011 Added descriptions of how to install Nolio components using
the CLI.
Installing Nolio
Agent
Installing Nolio
Server
3.2.1 15-Jun-2011 Reintroduced Platform/Component Compatibility Matrix.
Specified that document covers versions 3.2 and 3.2.1.
Introduction
3.2.2 20-Sep-2011 Added instructions for installing and configuring an Execution
Server.
Added functionality for email notification of non-ASAP users.

3.3 Dec-2011 Added following topics in Introduction chapter:


Recommended Hardware Configuration


Microsoft SQL Server Installation Requirements


Oracle Installation Requirements


Ports and Protocols for Nolio ASAP
Added following topics in Installing Nolio Server chapter:


Performing Custom Nolio Server Installation


Installing the Nolio Execution Server
Adding following topic to Managing Agents and Test Agents
chapter:


Configuring an Execution Server


Administration Tasks on Agents or Execution Servers

Revis ions
Installation and Administration Guide Revisions

8 Nolio Automation Center

Ver. Date Description Topics
Added following new topics to new Managing Application
Services chapter:


Changing Default Local Font


Enabling Design Auditing
Added Appendix: Parameters for Oracle Database
Added following topic to Installing Nolio Server:


Performing Silent Installation of Server
Added following topic to Installing Nolio Agent:


Performing Silent Installation of Server

Updated following topics:
Introduction chapter:


Hardware Requirements: Minimum number of required
processors.


Software Requirements: Ability to select database
vendor.


Required User Credentials for Installation of Nolio Server:
Linux and Solaris permissions and automatic startup.
Installing Nolio Server chapter:


Installing Nolio Server: Expanded explanation of Custom
Installation, warning to install into clean folder, and
pointer.


Installing Nolio Server on GUI Platforms: Entering
database connection details.
Installing Nolio Agent chapter:


Local Agent Installation: Warning to install into clean
folder.


Required User Credentials for Installation of Nolio Agent:
Linux and Solaris permissions and automatic startup.
Post-Installation Activities chapter:


Moved uninstalling Nolio Automation Center here


Removed the following topics from Managing Actions
Inventory chapter:


Adding Library Locations


Deleting Library Locations


Added Related Documentation topic.
Moved license oriented topics to new Managing Application
Services chapter.


Supported platform Oracle Enterprise Linux brand changed
to Oracle Linux.
Platform/ASAP
Component
Compatibility
Revisions

Nolio Automation Center 9

Ver. Date Description Topics

Updated installation process to include definition of user
credentials for Nolio Server service.
Installing Nolio
Server on GUI
Platforms

Added instructions for expanding and collapsing display of
Agent Groups.
Adding and
Editing Agent
Groups

Updated varfile template Appendix -
Installing Server
using varfile

Added commands for controlling Server service on
non-Windows platforms.
Controlling
Non-Windows
Nolio Server
Service

Feb-2012 Updated requirement for Agents on IBM AIX platforms that
IBM Java JRE 6 32-bit must be installed on target prior to
Agent setup.
Performing Agent
Installation using
CLI

Added note to disk space requirements where file transfers
are made; need 1.5 times the total size of files transferred per
hour.
Hardware
Requirements

Mar-2012
Added note for Linux systems that support for 32-bit
applications is required for installer.
Platform/ASAP
Component
Compatibility
Installing Nolio
Server
Local Agent
Installation


Installation and Administration Guide Preface

10 Nolio Automation Center

Preface
The Nolio Automation Center Installation and Administration Guide accompanies Nolio Automation
Center release V3.3.

About this Document
This document provides the necessary information for:


Installation and configuration of each of the modules that comprise Nolio Automation Center


Ongoing Nolio Automation Center administration
The material covered in the present document is the sole property of Nolio Ltd., and may not be copied
or reproduced in any fashion without explicit written permission from Nolio.
At the same time, Nolio Ltd. is not liable for any information, correct or incorrect, appearing in this
document that may result in damages incurred by the user regardless of whether or not such damages
resulted from the information provided herein, in conjunction with or totally independent from the use of
Nolio Automation Center.

Intended Audience
This documentation is intended for the following audience:


IT technicians who will manage the Nolio Automation Center data centers and personnel who are
responsible for the operational side of your organization's multi-tier applications, on all servers and in
all data centers. These readers are in charge of Nolio Automation Center installation.


Nolio Automation Center administrators who are responsible for the initial setup and the ongoing
administration of Nolio Automation Center.

Related Documentation
For information on upgrading Nolio Automation Center to the latest version, refer to the Nolio
Automation Center System Upgrade Guide supplied with this release.
For information on using Nolio Automation Center to develop automated processes and execute them,
refer to the Nolio Automation Center User's Guide.
For information on action templates and categories as installed, refer to the Nolio Automation Center
Actions Reference Guide.
For information on supported applications for actions, refer to Nolio Automation Center Applications
Support Matrix.
Preface

Nolio Automation Center 11

For detailed information on using the Release Deployment Dashboard, refer to Nolio Automation Center
Dashboard User's Guide.

Technical Support
If you have any questions, please feel free to contact Nolio technical support.


Telephone:


USA/Canada Toll free number: 1-888-869-8485


United Kingdom Toll free number: 0-800-680-0429


Email: support@noliosoft.com


Installation and Administration Guide Introduction

12 Nolio Automation Center

Chapter 1
In This Chapter
Nolio Automation Center Architecture............................................................................................................... 12
System Requirements

................................
................................
................................
................................
......

13

The Nolio Automation Center Installation and Administration Guide describes the installation process of
Nolio Automation Center version 3.3.
This chapter introduces Nolio Automation Center's architecture and details system requirements and
platform compatibilities for each of the Nolio Automation Center modules.


Nolio Automation Center Architecture
Nolio Automation Center is a platform for the automation of complex, multi-tier applications. It includes
the following modules:


Nolio Data Management Server (referred to as Data Management Server) - to which clients
connect in order to access Nolio Automation Center


Nolio Execution Server (referred to as Execution Server)


Nolio Agents (referred to as Agents)


Nolio Client UI (referred to as Client UI)
Execution Servers and Agents are the modules that work in the background to enable the
management and automation of such multi-tier application environments.
When a process is executed in Nolio Automation Center, the appropriate data and instructions are
channeled from the Data Management Server to the Execution Server that manages a specific Data
Center. For the purpose of managing the data center activities, the Nolio Automation Center also
includes any number of Agent modules, each of which controls a specific physical server involved in the
execution of a process. Each Agent receives the appropriate instructions passed to it by the Execution
Server and implements them on the server to which it is linked.
The Client UI is the user interface application that connects to and interacts with the Data Management
Server. It is downloaded and installed automatically upon accessing the Nolio Automation Center Web
server. It is installed using the Java Web Start technology which requires administrative user privileges
on the client machine.

Introduction
Introduction

Nolio Automation Center 13

Sys tem Requirements
The system requirements depend on the Nolio Automation Center components being installed.

Hardware Requirements
In the case where Nolio components are installed on the same machine, the MEMORY and
DISK-SPACE values should be summed.
The following values are the minimum requirements for the installation phase.
Note: Based on your system configuration and load, additional memory, disk space, and processors
might be required.

Component
RAM
Processors
Disk Space
(See Note)

Complete Installation 2 GB 2 CPUs 2 GB
Data Management Server 1 GB 1 CPU 1 GB
Execution Server 512 MB 1 CPU 300 MB
Agent 256 MB 1 CPU 300 MB
Client UI 512 MB


Release Deployment Dashboard 512 MB


Note: The above disk space requirements represent the minimum for the installation phase. For the
operational phase, you will need to consider additional disk space where file transfers are being made.
The additional disk space required is calculated at 1.5 times the total size of files transferred per hour.

Recommended Hardware Configuration
For systems which need to a handle load of 30 concurrent steps per second, it is recommended that
customers split the Nolio Data Management service and its database onto separate machines. For such
a configuration, it is recommended to allocate at least 2 CPUs and 4 GB RAM for the Data Management
server and to allocate 4 CPUs and 4 GB RAM for the Database server.
Systems that need to manage less than 30 concurrent steps can allocate fewer resources.
For low-level load systems, an All-In-One configuration (Data Management, Execution Server and Nolio
Agent) running on a single machine with 2 CPUs and 2 GB RAM will suffice.
Note: The above recommended requirements depend heavily on the specific configuration and load of
the Nolio system.

Installation and Administration Guide Introduction

14 Nolio Automation Center

Platform/ASAP Component Compatibility Matrix
The following table identifies the platforms which are supported for each ASAP component:
Table 1: Platform/Component Compatibility Table




Platform

ASAP Component
Nolio Data
Management
(Center)
Nolio
Execution
Server
Nolio Agent Client UI
AIX 6.1

Supported
(Requires IBM
Java JRE 6)

Linux
(Red Hat Enterprise
Linux 5.2 or higher,
CentOS, Fedora, Ubuntu,
SUSE, Oracle Linux 5
update 6)
Supported
(32 and 64bits
Kernel 1.6 or
higher)
Supported
(32 and 64bits
Kernel 1.6 or
higher)
Supported
(32 and 64bits
Kernel 1.6 or
higher)
Supported
(JRE 6 update 16
or higher)
Note: 32-bit application support is required for installer.
zLinux s390 SUSE 10 ES


Supported
(s390x - 64bits
only)

Solaris 9 x86
Solaris 9 SPARC

Supported
Solaris 10 x86
Solaris 10 SPARC
Supported Supported Supported
Windows 2000

Supported Supported
(JRE 6 update 16
or higher)
Windows 2003

Supported
(32 and 64 bits)
Supported
(JRE 6 update 16
or higher)
Windows 2003 R2 Supported
(32 and 64 bits)
Supported
(32 and 64 bits)
Supported
(32 and 64 bits)
Supported
(JRE 6 update 16
or higher)
Windows 2008
Windows 2008 R2
Supported
(32 and 64 bits)
Supported
(32 and 64 bits)
Supported
(32 and 64 bits)
Supported
(JRE 6 update 16
or higher)
Introduction

Nolio Automation Center 15





Platform

ASAP Component
Nolio Data
Management
(Center)
Nolio
Execution
Server
Nolio Agent Client UI
Windows 7
Windows VISTA
Windows XP

Supported Supported
(JRE 6 update 16
or higher)

Databas e Prerequisites
Nolio Automation Center requires a database to store data, changes, and configurations.
During installation you will be able to select one of the following database vendors:


MySQL


SQL Server


Oracle
Note: If you select SQL Server, the Data Management Server must be also installed on a Windows
machine.
Supported database versions are as follows:

MySQL
Oracle
MS SQL Server
Versions: 5.1.30 and higher
Note: InnoDB Storage Engine
must be enabled.
Versions: 10g and higher Versions: SQL 2005 and higher

MySQL Ins tallation Requirements
A database user must be created for use by the Nolio Automation Center application. The user has the
option to decide which database user ASAP will use. The database user may be root and it can be
'regular' user with the privileges described below.
The following scenarios are supported:


Install with root user


No special configurations are required.


User will need to supply the connection details for the MySQL database.


Install with non-root user
Installation and Administration Guide Introduction

16 Nolio Automation Center

Two options are supported:


A database will be created by the database administrator.


A database will be created by MySQL DBA with UTF-8 character set.


InnoDB storage is enabled in this MySQL instance.


A database user should be created with the following privileges:
GRANT ALL PRIVILEGES ON <db_name>.* TO <username>@<hostname>
IDENTIFIED BY ‘<password>’;
For example: GRANT ALL PRIVILEGES ON NOLIO_DB.* to nolio@localhost
IDENTIFIED by ‘nolio’;


A database will be created by Nolio as part of the installation.


A database user should be created by the MySQL DBA. The user should be granted
privileges to create a database and its objects, as follows:
GRANT CREATE, DROP, REFERENCES, EVENT, ALTER, DELETE, INDEX, INSERT,
SELECT, UPDATE, CREATE TEMPORARY TABLES, LOCK TABLES, TRIGGER, CREATE
VIEW, SHOW VIEW, ALTER ROUTINE, CREATE ROUTINE, EXECUTE ON *.* TO
<username>@<hostname>;
During installation, connection details will be requested.
The existence of a running database instance is a mandatory requirement for Nolio Automation Center.
Note: If the user selects to use an existing database, the installer will check if the database is empty. If
the database is not empty, or contains a non-Nolio schema, the installation will not complete and a
relevant message will display.

Micros oft SQL Server Ins tallation Requirements
Nolio Automation Center requires a dedicated database for its use. A dedicated database can be
created during the ASAP installation or previously by the DBA.
For Nolio to use MS SQL Server, the SQL Server configuration:


TCP Protocol should be in Enabled mode


SQL Server Browser Service should be started and in automatic startup mode
If the database is not empty, or contains a non-Nolio schema, the installation will not complete and a
relevant message will display.
In the database configuration phase of the ASAP installation, the following will be required:


Full MS SQL instance name: <HOSTNAME>\<INSTANCENAME>
Introduction

Nolio Automation Center 17



MS SQL DBA username which will be used to create the:


Connection to the MS SQL instance


Required dedicated database


Specific database login


Dedicated database name


Login name for database ownership
Windows and SQL authentication methods are supported during and after installation. During the
installation, you will have the option to select the desired authentication method.
Note: Selecting Windows authentication method for the initial MS SQL instance connection implies that
the logged-in user, running the installation, is permitted to log in to this instance and has DBA rights.
Alternatively, you may define the Nolio Server service owner to have the required permissions to
connect to the MS SQL Server instance.
For additional details, refer to Using MS SQL Server as Database for Nolio (on page 130) in the
Installation and Administration Guide Appendix.

Oracle Ins tallation Requirements
Nolio Automation Center requires a dedicated database user for its use. It is advisable that Nolio
database user will be assigned with a dedicated TABLESPACE.
The installation enables the creation of the database user and tablespaces. Alternatively, a DBA may
create the dedicated database user and tablespace before the installation.
During the installation, the user will be verified. If the user exists and already holds database objects
which are not part of Nolio schema, the installation will not complete and a relevant message will display.
It is also recommended that the Oracle instance to be used by ASAP will use a UTF encoding (UTF8 or
UTF16).
The installation will require the following inputs for the creation of the Nolio schema on Oracle:
1. Hostname or IP address of the Oracle Database
2. Oracle SID name, or Service name, as described in Using Oracle as Database for Nolio (on page
140) in Appendix.
3. Oracle Listener Port
4. Oracle Database user with DBA privileges, required for the initial connection verifying Oracle version
and creating the Nolio DB user, if required.
The DBA privileged username and password will not be stored anywhere.
Installation and Administration Guide Introduction

18 Nolio Automation Center

5. Tablespace name to be used by the Nolio DB user
For additional details, refer to Using Oracle as Database for Nolio (on page 140) in the Installation and
Administration Guide Appendix.

Web Brows ers and Flas h Player
The Nolio Release Deployment Dashboard is a Web-based application that requires Adobe Flash
Player 10 to be installed on each client machine.
If Adobe Flash Player was not previously installed on the client machine, a message will display warning
that the option to view portal and report graphs is disabled.
The supported Web browsers are:


Microsoft Internet Explorer 7.0 and higher


Google Chrome


Mozilla Firefox 3.6 and higher

Ports and Protocols for Nolio Automation Center
The following ports and protocols will be used by Nolio Automation Center:
Table 2: Ports and Protocols
Source /
Protocol
Direction
Target
Target
Port
Reason
Nolio UI
(HTTP/HTTPS)
From To ASAP 8080/8443 All communication between main Nolio UI
(and Dashboard) and Nolio Server (default
port)
NAC
(HTTP/HTTPS)
From To NES 8080/8443
Initial connection established between
ASAP and NES
NAG
(TCP/SSL)
From to
+
Bidirectional
NES 6600
Transfer of process results back to NES at
end of execution.
Also used during file transfer during a
process (default port)
NAG
(TCP/SSL)
From To NES 6900
If a NAG is installed on NES, recommended
to open up traffic from all NAG to NES on
6900 (default port). In this case, all NAG to
NES on 6600 must be bidirectionally
enabled.
Introduction

Nolio Automation Center 19

Source /
Protocol
Direction
Target
Target
Port
Reason
NES
(TCP/SSL)
Bidirectional NES 6600 If multiple NES exist AND NAG is connected
to various NES to work together in a single
process run, bidirectional communication
between those NES is required.
Additional ports:


NES To NAG 135 and
445
Remote agent installation on Windows
platforms
NES To NAG 22 Remote agent installation on Unix via SSH
NAC To LDAP/
LDAPS
389/636
(default)
Importing and authenticating users from an
LDAP source
NAC To SMTP 25
(default)
Sending e-mail notifications.
NAC To Database DB
listening
port
If database resides on difference machine
than the
Note: All port numbers are configurable. All source ports are random.

Required Us er Credentials for Ins tallation of Nolio Server
The following describes the user credentials required for installing Nolio Server:


Windows


For the installation process, the logged in user must have administrative privileges in order to
enable creation of the required Nolio Service.


The owner of the Nolio Server service is configured by default to run using the Local System
account.
However, during the installation phase, the Nolio Server service owner can be assigned to a
different user. The Server service owner user should:


Be part of the Administrator group on the Windows machine


Have 'Log on as a Service' right


Have write, read and execute permissions on the Nolio Automation Center installation folder


Linux and Solaris


Nolio can be installed by any UNIX user that has permissions to create and update files under
the installation directory.
Installation and Administration Guide Introduction

20 Nolio Automation Center



Installation files should be extracted, using the installer, to a dedicated folder that will include
only Nolio files.
For example, if the target location for Nolio will be under /opt, the Nolio files will be extracted by
the installer to /opt/NolioAutomationCenter. The UNIX assigned user should have write
permissions to the /opt folder.

Installing Nolio Server

Nolio Automation Center 21

Chapter 2
In This Chapter
Installing Nolio Server on GUI Platforms........................................................................................................... 22
Nolio Server Service Management on Non-Windows Platforms ........................................................................ 40
Performing Silent Installation of Server

................................
................................
................................
.............

40

The installation of the Data Management Server and the Execution Server is performed through a single
installation wizard, Nolio Server Setup. The Nolio wizard supports two types of installation:


Complete Installation: Installs all the components of the Nolio platform (Data Management Server,
Execution Server, Agent, and Demo application) on a single server.
In Setup Wizard, Installation Type Selection defaults to Complete installation.


Custom Installation: Installs selective components, generally either the Data Management Server
or the Execution Server separately, thus supporting distribution of the Nolio components across
multiple servers.
For a list of supported component combinations, refer to Selecting Components for Custom Server
Installation (on page 44).
For understanding the custom installation for any combination of Data Management and Execution
Server, without the Database, refer to When to Perform Custom Installation (on page 44).
Installing a Nolio Agent by itself is performed with a dedicated executable: nolio_agent_<OS>.
Note: For the installation package to be invoked on a Linux system, support for 32-bit applications must
be enabled.

Note: The installation process described in this section refers to platforms with graphical user interface
(GUI) capabilities. The non-graphical installation process provides the same configuration options
through a Command Line Interface (CLI).
Nolio Server service is set to start automatically on Windows platforms.
For Linux and Solaris platforms, refer to Controlling Nolio Server service on Non-Windows Platforms (on
page 67) for information on how to enable the Server service to start automatically on system restart.
To perform an ins tallation us ing the CLI:
1. Transfer the installation file to the target machine.
Ins talling Nolio Server
Installation and Administration Guide Installing Nolio Server

22 Nolio Automation Center

2. Grant “a+x” permission to the installation file:
chmod a+x nolio_server_<OS>_3_3_3_b<#>.sh
3. Execute the installation file:
./nolio_server_<OS>_3_3_3_b<#>.sh -c
4. Follow the instructions on screen.


Ins talling Nolio Server on GUI Platforms
Note: During the installation, you may define a user as the Nolio Server service owner. The defined user
must be an Administrator and have 'Log on as a service' user rights assignment in the domain security
policy settings.
To ins tall the Nolio Server on platforms with GUI capabilities:
1. For Linux and Solaris only: Grant "a+x" permissions to the
nolio_server_Linux/Solaris_3_3_3_b<#>.sh file.
2. Invoke the wizard service executable file. The Welcome window opens.

3. Click Next. The License Agreement window opens.
Installing Nolio Server

Nolio Automation Center 23

4. Read the terms of the License Agreement, and indicate your acceptance of them by selecting the
relevant radio button.

Installation and Administration Guide Installing Nolio Server

24 Nolio Automation Center

5. Click Next. The Production Activation Key window opens.

6. Enter the Product Activation Key which you received as part of the product download process.
Installing Nolio Server

Nolio Automation Center 25

7. Click Next. The Select Destination Directory window opens.

8. Specify the path of the installation root for this Nolio Automation Center module. It is recommended
that you accept the default directory displayed, but you can browse to an alternative directory
location on the target machine.
If the directory you specified does not already exist, it will be created now.
9. If default ports are not available, a dialog will display with a prompt for the addition of required ports.
Enter the new default ports.
Installation and Administration Guide Installing Nolio Server

26 Nolio Automation Center

10. Click Next. The Nolio Server Service Configuration window displays.

The ownership of the Data Management server and the central Execution Server are determined by
the owner of the Nolio Server service.
Note: The entered user must have administrative privileges and "Log on as a service" user rights
assignment in the domain security policy settings.
a. In the Service User Name box, enter the user name for the Nolio Server service.
b. In the Service User Password box, enter the password for the service user.
Installing Nolio Server

Nolio Automation Center 27

11. Click Next. The Installation Type Selection window opens.

12. Select either:


Complete Installation: to install all components on a single server (recommended).
OR


Custom Installation: to choose and configure Nolio components.
Review When to Perform Custom Installation (on page 44) for configurations and conditions.
Installation and Administration Guide Installing Nolio Server

28 Nolio Automation Center

13. Click Next. The System Requirements window opens, where you can review the list of software
and hardware requirements.

14. Click Next. The Advanced Communication Configuration window opens.

Installing Nolio Server

Nolio Automation Center 29

15. Specify the port to be used by the Nolio agent. The default port is 6900 when using the Full
Installation mode and 6600 when using the Custom Installation mode.
Note: This window will not appear if the Agent component was not selected in Custom Installation
mode.
16. Click Next. The Execution Server Configuration window opens.

17. Specify the port to be used by the Execution Server. The default port is 6600 (recommended). In this
window, you can also define whether you will use secure communication by selecting the check box.
Note: This window will not appear if the Execution Server component was not selected in Custom
Installation mode.
18. Click Next.
Installation and Administration Guide Installing Nolio Server

30 Nolio Automation Center

19. If Custom installation was selected and included the installation of an Execution Server, the Define
Node ID window opens.

The installation will provide a default value, usually es_<SERVER-NAME> or an IP.
a. Enter a unique name for the Execution Server (Custom Installation only).
b. Click Next.
Note: This window will appear only in Custom Installation mode and only if the Execution Server
component was selected. Refer to Installing Additional Nolio Execution Servers (on page 46) for
information on connecting the new Execution Server to the Nolio system.
Installing Nolio Server

Nolio Automation Center 31

20. The Choose Database Type window opens displaying the database vendors supported by Nolio.
By default, MySQL is the selected database.

21. Select the database type for the installation.
22. Click Next. The Database Connection Details window for the selected database type opens. The
Database Connection Details window displays the details for the pre-installed database instance.
The details are required to enable Nolio Automation Center to create the required schema and to
store configurations and changes. The installer will check the connection to the database and the
privileges of the supplied database user name.
The Installer will create the new database and schema or will connect to the previously created
database. If the previously created database is not empty or is not already populated with the Nolio
schema, the installer will stop and alert the user.
For complete details on the user and privilege requirements for different database installation types,
refer to Database Prerequisites (on page 15).
MySQL:
23. If MySQL was selected, the MySQL Connection Details window displays.
Installation and Administration Guide Installing Nolio Server

32 Nolio Automation Center

Enter the database connection details.

Installing Nolio Server

Nolio Automation Center 33

MS SQL Server:
24. If SQL Server was selected, the SQL Server Connection Details window displays.

a. In the Server Name box, type the SQL Server full instance name as it appears in the output after
executing the following SQL command:
select @@servername;


If the SQL Server instance to be used is a "default" instance, type the Server name or IP
address.


If the SQL Server instance to be used is a "named" instance, type <Server name>\<Instance
name>.
b. Select the authentication mode which will be used to connect to the SQL Server instance:
Windows Authentication or SQL Server Authentication.
If Windows Authentication was selected, the connection will use the Nolio Server service
owner.
c. If SQL Authentication was selected:
1. In the DBA Login box, enter the login of a DBA user.
2. In the DBA password box, enter the password for the DBA Login.
d. Click Next.
Installation and Administration Guide Installing Nolio Server

34 Nolio Automation Center

25. The Database connection details window displays.

a. In the Nolio Database Name box, enter a name for the Nolio specific database to create.
b. Select the authentication mode which will be used to connect to the SQL Server instance:
Windows Authentication or SQL Server Authentication.
If Windows Authentication was selected, the connection will use the Nolio Server service
owner.
If SQL Authentication was selected:
1. In the Nolio Database Login box, enter the login of a DBA user.
2. In the Nolio Database Password box, enter the password for the DBA Login.
c. Click Next.
Installing Nolio Server

Nolio Automation Center 35

Oracle:
26. If Oracle was selected, the Oracle Connection Details window displays.

a. In the Database host name or IP address box, enter database host name or IP address.
b. In the Database port box, enter the Oracle database listening port.
c. In the SID or Service Name box, enter the SID or Service name.
Note: The SID or service name is the one recognized by the Oracle Network Service. To
determine the right value, refer to the section in this guide.
Provide a database username and password for a DBA user. The credentials will be used to
connect to the database and to create the Nolio DB user and tablespace.
d. In the DBA user name box, enter the DBA user name.
e. In the DBA password box, enter the password for the DBA User name.
Installation and Administration Guide Installing Nolio Server

36 Nolio Automation Center

27. Click Next. The Database Connection Details window opens displaying the Nolio specific schema
details.

a. In the Nolio Database user name box, enter a user name to own the Nolio schema. The
installation will create the new user.
b. In the Nolio Database password box, enter the password for the user.
c. In the Tablespace Name, enter the tablespace name.
d. In the Tablespace Filename, enter the filename of the database.
The installer will check that the given schema does not exist. If it exists, the installer will check
whether it is empty and if so, the Nolio schema will be populated.
If the given tablespace and user are already assigned with non-Nolio objects, the installer will
stop the installation process.
Installing Nolio Server

Nolio Automation Center 37

28. Click Next. The Ready to Install window opens. The installer displays a list of components that are
about to be installed.

Installation and Administration Guide Installing Nolio Server

38 Nolio Automation Center

29. Click Next. The Installing window opens, displaying the progress of the installation. The progress
bar is automatically updated.

The Nolio Server startup window displays.

Installing Nolio Server

Nolio Automation Center 39

30. When installation progress is complete, click Next. The Select Start Menu Folder window opens.

31. Select how you would like shortcuts to be installed.
a. Specify the Program Group in which the shortcut(s) for the currently installed module will be
created. The default here is Nolio.
b. If you do not want to create a shortcut in the Windows Start Menu, select the relevant check box.
Installation and Administration Guide Installing Nolio Server

40 Nolio Automation Center

32. Click Next. The Completing the Nolio Automation Center Setup Wizard window opens,
indicating that installation is complete.

33. Click Finish.
Note: To configure the Nolio Agent to startup automatically under Solaris or Linux systems, refer to
Configuring Linux/Solaris for Automatic Startup of Agent (on page 66).

Nolio Server Service Management on Non-Windows
Platforms
The following commands are available on non-Windows platforms for the Nolio Server service startup
and shutdown:


Service startup: ./bin/startup.sh


Service shutdown: ./bin/shutdown.sh
Note: All commands refer to paths relative to the <Nolio Datamanagement HOME DIRECTORY>.

Performing Silent Ins tallation of Server
It is possible to perform a silent installation of the Nolio Data Management Server and Execution Server
by invoking a single installation executable, Nolio Server Setup, using the command line.
Installing Nolio Server

Nolio Automation Center 41

Required inputs are passed using one of the following methods:


In the command line


In a server input varfile
The template for the server input varfile is available in Installing Server using varfile (on page 143) in
the Appendix.
The Server Setup executable supports two types of installations: Complete and Custom.
Installing only an Agent is performed with a dedicated executable: nolio_agent_<OS>.

Ins talling with varfile
To perform an ins tallation us ing varfile:
1. Copy the content of the varfile template from Installing Server using varfile (on page 143) in the
Appendix and save it in a file called varfile response.varfile.
2. Update the required inputs in varfile response.varfile.
3. Transfer the installation file to the target machine.
4. Transfer the varfile response.varfile to the target machine.
5. For non-Windows machines, grant "a+x" permission to the installation file:
chmod a+x nolio_server_<OS>_3_3_3_b<#>.sh
6. Execute the installation file:
./nolio_server_<OS>_3_3_3_b<#>.sh –q –varfile response.varfile
Note: Additional flags can be added to the command line for logging more information.
./nolio_server_<OS>_3_3_3_b<#>.sh –q –varfile response.varfile
–Dinstall4j.alternativeLogfile=[path] -Dinstall4j.keepLog=true

Ins talling without varfile
Running the installation without an input varfile requires that the Server executable will be invoked
together with all inputs listed and filled with values in the same command line.
Before invoking the installation:


Get a list of all required input parameters from the varfile template found in Appendix - Installing
Server using varfile (on page 143).


Identify the parameter values needing update.
Installation and Administration Guide Installing Nolio Server

42 Nolio Automation Center



When entering the parameters in the command line, prefix each parameter name with a hyphen and
upper case letter 'V' (-V).
To perform an ins tallation without varfile:
1. Transfer the installation file to the target machine.
2. For non-Windows machines, grant "a+x" permissions to the installation file:
chmod a+x nolio_server_<OS>_3_3_3_b<#>.sh
3. Invoke the installation executable:
./nolio_server_<OS>_3_3_3_b<#>.sh –q –V<PARAMETERS>
Following is an example of an installation command line with input parameters marked with '-V'
prefix:
./nolio_server_Linux_3_3_3_b13.sh –q
-Vsys.programGroupDisabled$Boolean=true Vsys.programGroupName=NOLIO
-Vsys.programGroupAllUsers$Boolean=true -Vsys.languageId=en
-Vsys.installationDir=/opt/Nolio/NolioReleaseAutomation
-Vsys.component.12750$Boolean=true -Vsys.component.336$Boolean=true
-Vsys.component.28932$Boolean=true -Vsys.component.12751$Boolean=true
-Vnolio.db.isempty=true -Vnolio.db.database.name=nolio_db
-Vnolio.db.create$Boolean=true -Vnolio.db.password=mypassword
-Vnolio.db.port=3306 -Vnolio.db.user.name=root
-Vnolio.db.host.name=nolio-server -Vnolio.hiddenport$Boolean=false
-Vnolio.comm.conf.type$Integer=0 -Vnolio.os.arch=x86
-Vnolio.branding$Boolean=true -Vnolio.product.key=0123456789
-Vnolio.install.dm$Boolean=true -Vnolio.install.es$Boolean=true
-Vnolio.install.agent$Boolean=true -Vnolio.install.flows$Boolean=false
-Vnolio.install.type$Integer=0 -Vnolio.skip.install.mysql$Boolean=false
-Vnolio.nimi.port=6900 -Vnolio.nimi.secured$Boolean=false
-Vnolio.nimi.supernode=default -Vnolio.nimi.node.id=es_servername
-Vnolio.server.address=192.168.10.10 -Vnolio.server.name=nolio-srvname
-Vnolio.agents.supernode=192.168.10.10 -Vnolio.agent.jxta.node.name=
-Vnolio.execution.port=6600 -Vnolio.execution.name=192.168.10.10
Notes:
 Default port for the Execution Server is 6600 and for the agent 6900.
 Execution Server Node name should be unique.
 Fill in the database variables according to the selected database type. Refer to database name
definition procedure below.
To define the databas e name required for the ins tallation input:
1. If MSSQL was selected for the database:
Installing Nolio Server

Nolio Automation Center 43

The value of the parameter nolio.db.database.name should be
<SERVERNAME>\<INSTANCENAME> if this is a named instance, or just <INSTANCENAME> if
the instance is a default.
If Windows Authentication was selected and the supplied login does not have Administrator
privileges on the Data Management Server, the service will not start automatically and you will be
prompted to start the service manually after the files were extracted and the schema populated.
2. If Oracle was selected for the database:
The value of the parameter nolio.db.database.name should be either the SID name or the Service
Name. To determine the correct value, refer to Using Oracle as Database (on page 140).
The installer will check that the given schema does not exist. If it exists, the installer will check whether it
is empty, and if empty, the Nolio schema will be populated.
If the given tablespace and user are already assigned with non-Nolio objects, the installer will stop the
installation process.
Note: To configure the Agent to startup automatically under Solaris or Linux systems, refer to
Configuring Linux/Solaris for Automatic Startup of Agent (on page 66).

Installation and Administration Guide Performing Custom Nolio Server Installation

44 Nolio Automation Center

Chapter 3
In This Chapter
When to Perform Custom Installation ............................................................................................................... 44
Selecting Components for Custom Server Installation ...................................................................................... 44
Installing Additional Nolio Execution Servers

................................
................................
................................
....

46

The following topics describe how to perform a custom server installation.


When to Perform Cus tom Ins tallation
Custom installation is intended for users who want to:


Add an additional Execution Server, or Servers, after the initial complete installation.
See Installing Additional Nolio Execution Server (on page 46).
The following restrictions to custom component selection apply:


If only Nolio Agent is selected, use the appropriate Nolio Agent Installation package.


If Demo Processes is selected, installation of Data Management Server and a database are
required.


If Skip Database Configuration is selected, Nolio Agent cannot be installed. Product functionality
will be prevented if database is not installed. There are specific use cases in which this configuration
is required. For further information, contact Nolio support (on page 11).
When running a custom installation that includes Nolio Data Management and Nolio Execution Server,
no manual configuration is required, unless additional Execution Servers are being added.

Selecting Components for Cus tom Server Ins tallation
When running a custom installation, you will be able to select which Nolio components to install. Custom
Installation supports the following set of installation combinations:


Data Management Server


Data Management Server and Execution Server


Data Management Server, Execution Server and Nolio Agent
Performing Cus tom Nolio Server Ins tallation
Performing Custom Nolio Server Installation

Nolio Automation Center 45



Data Management Server, Execution Server, Nolio Agent and Demo Processes


Data Management Server and Execution Server with Skip Database Configuration option checked.
Note: Selecting Skip Database Configuration will cause Nolio to not use a database and will prevent
much of the product functionality. However, Skip Database Configuration should be performed in
specific use cases. For further information, contact Nolio support (on page 11).


Execution Server


Execution Server and Nolio Agent
Note: When installing a Nolio Agent only, a dedicated executable, nolio_agent_<OS>, is used.
1. When Custom installation is selected, the Nolio Automation Center component selection window will
display.

2. Select the required Nolio components based on the exceptions and conditions described above.
3. Click Next.
Installation and Administration Guide Performing Custom Nolio Server Installation

46 Nolio Automation Center

The Ready to install window displays listing the selected components.

4. To review or change any custom component selections, click Back.
5. To continue with the installation of the selected components, click Next.
6. Continue with step 14, Advanced Communication Configuration, in the server installation described
in Installing Nolio Server on GUI Platforms (on page 22).

Ins talling Additional Nolio Execution Servers
By performing a Complete installation type, all Nolio components (Data Management, Execution
Server and Nolio Agent) will be installed on the server.
Additional Execution Servers can now be added to existing Nolio systems.
To ins tall Execution Server only:
1. Perform a Nolio Server installation, as described above, selecting Custom installation in the
Installation Type Selection window.
The component selection window will display.
Performing Custom Nolio Server Installation

Nolio Automation Center 47

2. Clear all component options leaving only Execution Server selected, and Nolio Agent if required.

3. Click Next.
4. Continue following installation instructions from step 14 as described in Installing Nolio Server on
GUI Platforms (on page 22).
5. After installation of the Execution Server has completed, connect the new Execution Server to the
Nolio System.
To connect an Execution Server to Nolio s ys tem:
1. In the Administration tab of the Navigation Panel, click Agents Management.
The Agents Management page opens.
2. Click
and select Execution Server.
Installation and Administration Guide Performing Custom Nolio Server Installation

48 Nolio Automation Center

The Execution Server details dialog will display.

3. In the Host Name box, enter the host name.
4. In the Port box, enter the port of the Web server used by the Execution Server. The default port is
8080.
5. In the Connected Execution Servers list, select the Execution Servers to connect to.
6. Click Save.
Once the Execution Server has been added, you may connect sibling Execution Servers, if required.
Refer to Configuring an Execution Server (on page 102) in the Administration section.

Installing Nolio Agent

Nolio Automation Center 49

Chapter 4
In This Chapter
Local Agent Installation .................................................................................................................................... 49
Required User Credentials for Installation of Nolio Agent .................................................................................. 49
Performing Agent Installation using CLI ............................................................................................................ 50
Installing Nolio Agent on GUI Platforms ............................................................................................................ 51
Local Agent Installation in Silent Mode ............................................................................................................. 60
Remote Agent Installation ................................................................................................................................ 61
Advanced Agent Configuration

................................
................................
................................
.........................

65

As previously indicated, the Nolio Automation Center Agent module may be installed on Windows,
Linux, Solaris, AIX or zLinux s390x machines.
The installation of Nolio Agents can be performed through an executable wizard (local installation) or
through the Nolio application user interface (remote installation).


Local Agent Ins tallation
Installing Nolio Agent is performed by running the Nolio Agent Setup Wizard.
To perform a silent installation, refer to Local Agent Installation in Silent Mode (on page 60).
Note: For the installation package to be invoked on a Linux system, support for 32-bit applications must
be enabled.
Note: The installation process described in this section refers to platforms with GUI capabilities. The
non-graphical installation process provides the same configuration options through a CLI.
Note: The installation should be performed to a clean folder that does not hold any files or folders other
than those of Nolio ASAP.

Required Us er Credentials for Ins tallation of Nolio Agent
The following describes the user credentials required for installing the Nolio agent:


Windows
Ins talling Nolio Agent
Installation and Administration Guide Installing Nolio Agent

50 Nolio Automation Center



For the installation process, the logged in user must have administrative privileges in order to
enable creation of the required Nolio Service.


The owner of the Nolio Agent Service is configured by default to run with the Local System
account.


For some advanced functions, such as access to resources on the network, the service must log
on as a user with administrative privileges.


The owner of the Nolio Agent Service should have:


Write permissions to the file system


Permission to start a service


Linux and Solaris


Nolio can be installed by any UNIX user that has permissions to create and update files under
the installation directory.


The installation files should be extracted, using the installer, to a dedicated folder that will include
only Nolio files.
For example, if the target location for Nolio will be under /opt, the Nolio files will be extracted by
the installer to /opt/NolioAgent. The UNIX user assigned should have write permissions to the
/opt folder.


To enable automatic startup in case of machine restart, the installation will try to add an entry to
the runlevel scripts.
If the installed user is not ROOT and does not have permissions to update the runlevel scripts, a
message will be displayed during the installation.
Refer to Configuring Linux/Solaris for Automatic Startup of Agent (on page 66) for a specific
script that can be executed by the ROOT user after installation.

Performing Agent Ins tallation us ing CLI
To perform an ins tallation us ing the CLI:
1. Transfer the agent installation file to the target machine.
2. Grant "a+x" permission to the installation file:
chmod a+x nolio_agent_<OS>_3_3_1_b<#>.sh
3. Execute the installation file:
./nolio_agent_<OS>_3_3_1_b<#>.sh
4. Follow the instructions on screen.
Installing Nolio Agent

Nolio Automation Center 51

As part of the installation process, the Agent service will be set to start automatically after the server's
boot.
Important Note for Installation of Agents on AIX Platforms ONLY:
When installing Nolio Agents on IBM AIX platforms, IBM JAVA JRE 6 32-bit must be installed on the
target server prior to Nolio Agent setup.

Ins talling Nolio Agent on GUI Platforms
To ins tall Nolio Agent on platforms with GUI capabilities:
1. For Linux or Solaris only: Grant "a+x" permissions to the nolio_agent_<OS>_3_3_3_b<#>.sh file.
2. Invoke the executable file. The Welcome window opens.

Installation and Administration Guide Installing Nolio Agent

52 Nolio Automation Center

3. Click Next. The License Agreement window opens.

4. Read the terms of the License Agreement, and indicate your acceptance of them by selecting the
relevant radio button.
Installing Nolio Agent

Nolio Automation Center 53

5. Click Next. The System Requirements window opens.

Installation and Administration Guide Installing Nolio Agent

54 Nolio Automation Center

6. Click Next after confirming that your system meets these requirements. The Select Destination
Directory window opens.

7. Select the destination location for the agent root directory. If the directory you selected does not exist
it will be created during the installation.
Installing Nolio Agent

Nolio Automation Center 55

8. Click Next. The Nolio Agent Service Configuration window opens.

9. Enter the credentials of a user account that has administrative privileges and 'Log On As A Service'
right. This user will be used to run the Agent service.
Installation and Administration Guide Installing Nolio Agent

56 Nolio Automation Center

10. Click Next. The Advanced Communication Configuration window opens.

11. Specify the port through which the Nolio Agent will communicate with its Execution Server. The
default port for Agents is 6600. However, in case the Nolio Execution Server is installed on the same
server and you have not changed its default port, port 6600 will be in use and you will need to choose
a different port.
Installing Nolio Agent

Nolio Automation Center 57

12. Click Next. The Define Node ID window opens.

13. Specify a unique name for this agent. By default, the installer suggests the server's name or IP
address. You may provide a different name as long it is unique across all Agents and Execution
Servers.
Installation and Administration Guide Installing Nolio Agent

58 Nolio Automation Center

14. Click Next. The Define Execution Server window opens.

15. Define the Execution Server to which this agent reports:
a. In the Execution Server Name or IP field, specify the Execution Server by providing its DNS
name or IP address.
b. In the Execution Server Port box, enter the port on which the Execution Server is listening.
c. If your system is configured to use secured communication, select the Use Secured
Communication check box.
Installing Nolio Agent

Nolio Automation Center 59

16. Click Next. The Installing window opens, displaying the progress of the installation.

17. When installation progress is complete, click Next. The Select Start Menu Folder window opens.

Installation and Administration Guide Installing Nolio Agent

60 Nolio Automation Center

18. Select how you would like shortcuts installed.
a. Select the Start Menu folder in which the shortcut(s) for the currently installed module will be
created. The default is Nolio.
b. If you want to create shortcuts for all users, select the relevant check box.
19. Click Next. The Completing the Nolio Agent Setup Wizard window opens.

20. Click Finish to exit.
Note: On Windows platforms, in the case where the installer fails to install or start the Nolio Agent
service, the installation will be rolled back and the installation files will be removed.

Local Agent Ins tallation in Silent Mode
Installing Nolio Agent is performed by running the Nolio Agent executable. Running the installation in a
silent mode requires the agent installation executable to be located on the target machine.
To perform an agent ins tallation in s ilent mode:
1. Copy the content of the varfile template from Installing Agent using varfile (on page 143) in the
Appendix and save it in a file named deployer.silent.varfile.
2. Transfer the Nolio Agent installation file to the target machine.
3. For non-Windows machines, grant “a+x” permission to the installation file:
Installing Nolio Agent

Nolio Automation Center 61

chmod a+x nolio_agent_<OS>_3_3_3_b<#>.sh
4. Invoke the installation executable file with the following flags:
./nolio_agent_<OS>_3_3_3_b<#>.sh –q –Vsys.installationDir=<INSTALL-DIR>
-Vnolio.execution.name=<NAME-or-IP-of-ExecutionServer>
-Vnolio.execution.port=<EXECUTION-SERVER-PORT>
-Vnolio.nimi.port=<AGENT-PORT> -Vnolio.check.connectivity=false
–Vnolio.nimi.secured=<true-or-false>
Following is an example of the command line syntax for installing an agent in silent mode:
./nolio_agent_linux_3_3_3_b159.sh -q -Vsys.installationDir=/
home/nolio/NolioAgent -Vnolio.execution.name=192.168.154.61
-Vnolio.execution.port=6900 -Vnolio.nimi.port=6600
-Vnolio.check.connectivity=false -Vnolio.nimi.secured=true

Remote Agent Ins tallation
To remotely install a new Nolio Agent, you may use the remote installation feature.
The remote installation enables the user to add agents on remote machines and connect them to
existing Execution Servers. The ability to perform remote agent installation is dependent on the install
base of the Nolio Execution Server.
The following configurations are supported for Nolio Execution Server running on:


Windows


Remote installation of agents on Windows platforms


Remote installation of agents on Linux, Solaris, AIX and/or zLinux platforms


Linux or Solaris


Remote installation of agents on Linux, Solaris, AIX and/or zLinux platforms

Prerequisites
To enable remote agent installation, the Execution Server to which the new agents will be connected
should have the target OS Agent’s executable in its scripts folder.
For example, if the new agent to be installed should run on a Solaris x86 platform, the agent’s installation
file (nolio_agent_solaris-x86_3_3_3_b<#>.sh) should be copied to the Execution Server script folder
located at:
<Execution Server Home Directory>/scripts
Installation and Administration Guide Installing Nolio Agent

62 Nolio Automation Center

The target machine must be configured properly to allow remote installation. In the case of Windows, the
Nolio Server Service owner must have administrative privileges and 'Log On As A Service' rights on the
machine.
Windows


Workstation and Server services are running


Admin$ share is available


Windows Network is running


Printer and File Sharing is activated


Incoming network Users authenticate as themselves


Simple File Sharing is turned off


Network Users Identify as Guests is turned off


Firewall allows incoming traffic through ports 135 and 445
Linux/Solaris


SSH must be enabled

Installing Nolio Agent

Nolio Automation Center 63

Running Remote Ins tallation
To run a remote ins tallation:
1. In the Nolio Client UI, select Administration > Agents Managements. The Administration
Agents Management window opens.

Installation and Administration Guide Installing Nolio Agent

64 Nolio Automation Center

2. Click
, and on the dropdown menu select Install Nolio Agent to install the agent on the
relevant platform. The Install New Agent window opens.

3. Provide the following details:


DNS names or IP addresses of the servers on which the new agent will be installed.


Credentials of an account that has administrative privileges on the remote machines.


Port number on which the new agent will be listening.


IP address or DNS name of the Execution Server with which these agents will be associated.
a. For Windows platforms, you can click Advanced to define different credentials for remote
servers:
1. Enter the credentials of a user account that will be used to run the Agent service. The user
must have administrative privileges and 'Log On As A Service' rights.
b. For Linux/Solaris platforms, the User Name supplied should have the same user credentials as
described in Linux and Solaris section of Required User Credentials for Installation of Nolio
Agent (on page 49).
Note: If the port is not available, a new window will open with a prompt to provide new ports.
Installing Nolio Agent

Nolio Automation Center 65

4. Click Install. The Agent Installation Status Progress window opens.

5. When the installation completes, click Close to close this window.
As part of the installation process, the Agent services will be set to start automatically after the server's
boot. If the installer will not be able to do so, you will be notified. Failure might occur due to permissions
issues that will prevent the installation process from copying the required files to the needed location.
For instructions on how to set automatic startup, see Configuring Linux/Solaris for Automatic Startup of
Agent (on page 66).
Note: On Windows platforms, in the case where the installer fails to install or start the Nolio Agent
service, the installation will be rolled back and the installation files will be removed.

Advanced Agent Configuration
This section describes advanced configuration options for the Nolio Agent.

Installation and Administration Guide Installing Nolio Agent

66 Nolio Automation Center

Agent Service Management on non-Windows Platforms
Note: All commands refer to paths that are relative to the <<NOLIO> AGENT HOME DIRECTORY>.


Service startup: ./deployer_deamon.sh start


Service shutdown: ./deployer_deamon.sh stop


Service restart: ./deployer_deamon.sh restart


Service status: ./deployer_deamon.sh status

Configuring Linux/Solaris for Automatic Startup of Agent
Note: The following configuration procedure should only be performed if you installed Nolio Server or
Nolio Agent with a non-root user.
To enable automatic Agent s tartup on Linux/Solaris:
1. Open conf/S70nolioagent for editing.
2. Find the RUN_AS_USER=root entry.
3. Uncomment the line and replace 'root' with the user that owns the Nolio Agent installation.
4. For Solaris machines only:
a. Comment out the following line:
su -m $RUN_AS_USER -c "\"$REALPATH\" $2"
b. Uncomment the following line:
su $RUN_AS_USER -c "$REALPATH $2"
5. Save the file.
6. Connect as ROOT user and run the following script from Nolio Agent root folder:
install_service_to_runlevels.sh ./conf S70nolioagent
After server reboot, the Nolio Agent service will start with the specified user.

Post-Installation Procedures

Nolio Automation Center 67

Chapter 5
In This Chapter
Controlling Nolio Server Service on Non-Windows Platforms ............................................................................ 67
Uninstalling Nolio Automation Center ............................................................................................................... 68
Uninstalling Nolio Agent

................................
................................
................................
................................
...

68

Use the following post-installation procedures as necessary.


Controlling Nolio Server Service on Non-Windows
Platforms
Nolio Server service can be manipulated by running a single script with different attributes.
Execute the script from the Nolio Automation Center Home Directory and by the user that owns Nolio
system.
To add Nolio Server s ervice to the s ervices lis t for automatic s tart after reboot:
At the Command prompt, run:
./nolio_server.sh install
If executed, the install command will enable the Nolio Server service to start automatically in case the
host was rebooted similar to automatic start for the Agent.
If Nolio Server service needs to be started with a user other than root, edit the nolio_server.sh script
as follows:
1. Open shell file
2. Search for RUN_AS_USER
3. Type the username
Note: User should have write, execute and read permissions on the Nolio Automation Center root.
To s tart the Nolio Server s ervice:
At the Command prompt, run:
Pos t-Ins tallation Procedures
Installation and Administration Guide Post-Installation Procedures

68 Nolio Automation Center

./nolio_server.sh start
To s top the Nolio Server s ervice:
At the Command prompt, run:
./nolio_server.sh stop
To res tart the Nolio Server s ervice:
At the Command prompt, run:
./nolio_server.sh restart
To query the s tatus of the Nolio Server s ervice:
At the Command prompt, run:
./nolio_server.sh status
To remove Nolio Server s ervice from the s ervices lis t:
At the Command prompt, run:
./nolio_server.sh remove

Unins talling Nolio Automation Center
To unins tall Nolio Automation Center from a machine running under Windows:
Invoke the specific uninstall executable supplied:
1. Choose Start > All Programs > Nolio.
2. In the menu that opens to the right, choose Nolio Automation Center Uninstaller.
3. When queried whether to remove the installation, click Yes.
4. Follow the uninstall wizard instructions.
To unins tall Nolio Automation Center from non-Windows machine:
1. Go to the <Nolio Server Home Directory>.
2. Run the uninstall task (./uninstall) and follow the instructions.
Note: The schema in the database will not be removed.

Unins talling Nolio Agent
This section provides instructions for uninstalling the Nolio Agent from Windows and Linux systems.

Post-Installation Procedures

Nolio Automation Center 69

Windows
Uninstalling Nolio Agent from a machine running under Windows is performed by invoking its uninstall
executable.
To unins tall Nolio Agent:
1. Choose Start > All Programs > Nolio.
2. In the menu that opens to the right, choose the Nolio Agent Uninstaller.
3. When queried whether to remove the installation, click Yes.
4. Follow the uninstall wizard instructions.

Linux/Solaris
Uninstalling Nolio Agent on a machine running on non-Windows platform is performed by running the
Nolio Agent uninstall shell script.


If the target machine has a GUI, uninstall is performed in the same manner as for Windows (on page
69).


If the target machine does not have a GUI, the uninstall process is run in text mode:
a. Go to <Nolio Agent Home Directory>
b. Run the uninstall task (./uninstall) and follow the instructions.

Installation and Administration Guide Running Nolio Automation Center

70 Nolio Automation Center

Chapter 6
In This Chapter
Launching the Client UI .................................................................................................................................... 70
Setting Up Nolio Automation Center

................................
................................
................................
.................

72

This chapter explains how to invoke the Nolio Automation Center Client UI.
Note: Sun Java version 6 update 16 or higher must be installed on your computer.


Launching the Client UI
The Nolio Automation Center UI uses Web Start technology.
To download and ins tall the Client UI:
1. In your browser, enter:
http://<hostname or IP address of center>:8080/nolio-app
If Sun Java 6 update 16 or higher is not installed, you will be provided with a link to install Java. You
will need to update your client machine with this JRE version.

Running Nolio Automation Center
Running Nolio Automation Center

Nolio Automation Center 71

2. Click the Nolio Automation Center button. The Download Application window opens. If this is the
first time you are running the application, the License Message window opens.
3. Click the Log to Nolio Management Console button to log into the Release Deployment
Dashboard.
Note: The credentials mechanism for the Release Deployment Dashboard is based on the
mechanism defined within the ASAP User Management component.
4. If you have obtained a License file, you may now apply it. Enter the path to the License file or click
Browse and click Load License.
5. If you do not have a License file at this time, you may continue your work and apply the License at a
later time by clicking Continue.
For instructions on how to update the License file, see Updating Nolio Automation Center License
(on page 127).
Note: If you do not supply a License file, the installed product will enable a limited version with part
of the features as an evaluation kit.

Installation and Administration Guide Running Nolio Automation Center

72 Nolio Automation Center

The application will now load.

A shortcut
icon opens on your desktop pointing to the URL to load the application.
Always use this link to load the application to ensure that you are getting the updated version of the
application.

Setting Up Nolio Automation Center
This section describes the steps required for setting up Nolio Automation Center for use.

Overview
During the Nolio Automation Center installation, a default administrative user called superuser is
created. You must use this user on the first login to the Nolio system in order to set up Nolio Automation
Center for use.
Note: For information on changing the default administrative user's details, refer to Modifying the Default
Administrative User's Details (on page 93).

Running Nolio Automation Center

Nolio Automation Center 73

Workflow
The workflow for Nolio Automation Center setup is as follows:
1. Run Nolio Automation Center Client UI (on page 70).