Agent Install Guide - JAVA and

LARA
LARA (Nolio) Agent Installation

.NET (Windows) & JAVA (Linux, Solaris& zLinux)
RELEASE AUTOMATION
Doc v1.6
CONTENTS
AGENT INSTALL FOR .NET (Windows)

How to Install an Agent
How to Uninstall an Agent
AGENT INSTALL FOR JAVA (Linux)

How to Fix an Incorrect Agent Installation
AGENT INSTALL FOR JAVA (Solaris)

How to Fix an Incorrect Agent Installation
AGENT INSTALL FOR JAVA (zLinux)

.NET (Windows)
HOW TO INSTALL AN AGENT
Step 1 (Downloading copy of Agent)

First, you must download the Agent from: http://wpdcldwa00321.ads.aexp.com:8080/rasoftware/nolio_agent_windows_5_5_2_b191.exe
Click Continue to this website
(NOTE: This can only be done if you or your designated admin team have admin access. If no one on your team has admin access, please
email [email protected] for assistance.)
Step 2 (Saving Agent)
Note: The screens are for representation purposes only. Actual Version#s may be different than the one shown

Step 3 (Navigating to Agent)
Open a command prompt
Navigate to the folder containing the downloaded Agent

Step 4 (Installing Agent)
Command for Agent installation
nolio_agent_windows_5_5_2_b191.exe -q -Vsys.installationDir="F:\\Program
Files\\CA\\NolioAgent" -Vnolio.nimi.node.id=%HOSTNAME% -Vnolio.nimi.port=6600 Vinstall.service.lsa$Boolean=true -Vnolio.nimi.secured$Boolean=false Vnolio.execution.name=wvpma947.gso.aexp.com -Vnolio.execution.port=6600
NOTE: Make sure you replace hostname with the name of the server .
Please enter just the SERVER NAME instead of the full name/FQDN of the server
Example: HOSTNAME should be entered as WPQMA534 instead of WPQMA534.ads.aexp.com

Step 5 (Security Warning)
Select Yes when the security warning appears.

Step 6 (Agent installation complete)
Once it completes, open up Services. If Nolio Agent is found, continue on to verify the Agent installed correctly.
If you receive an error, email [email protected]
(NOTE: Agent can only be installed on port 6600)

Step 7 (Verify Installation)
Navigate to F:\Program Files\CA\NolioAgent\conf and open nimi_config.xml. Verify that the supernode element matches the image shown
below.
(NOTE: The supernode element must be listed as a full hostname as shown below, NOT IP)
10

Once it completes, open up Services. Restart the Nolio Agent service.
11
HOW TO UNINSTALL AN AGENT
Step 1 (Beginning Uninstallation)

Navigate to the folder where the Agent is installed. Double click on Uninstall.
12
Step 2 (Continuing Uninstallation)
Click Next when prompted.
13
Step 3 (Finishing Uninstallation)

The installation will begin. Select Yes and click Finish when prompted. This will complete the uninstallation.
JAVA (Linux)
15

Before you begin installing the agent, you must have a secure copy tool.
Telnet and SSH to client (LARA DevOps team uses PuTTY)
First, you must download the Agent from: http://wpdcldwa00321.ads.aexp.com:8080/rasoftware/nolio_agent_linux_5_5_2_b191.sh
(NOTE: This can only be done if you or your designated admin team have root access. If you have problems with installation, please

Click Save
16
Step 3 (Moving Agent)

Move it to your home directory
17
Step 4 (Informational screen)

Now the Agent resides in users home directory and the user will be able to access the Nolio (LARA) agent in any server.
18
Step 5 (Logging into target server)

Log in to the server using your UNIX ID.
19
Step 6 (Copying agent to target server)

Copy the Agent into the folder tmp:
cp nolio_agent_linux_5_5_2_b191.sh /tmp
20

Step 7 (Invoking root privileges)
Invoke root privileges using the following command:
pbrun /bin/su -
21

Step 8 (Changing Agent permissions)
Navigate to the tmp folder
Change the permissions of the Agent using the following command:
chmod +X nolio_agent_linux_5_5_2_b191.sh
22
Command for Agent installation

$ /tmp/nolio_agent_linux_5_5_2_b191.sh -q -Vsys.installationDir=/opt/CA/NolioAgent
-Vnolio.nimi.node.id=HOSTNAME -Vnolio.nimi.port=6600 -Vinstall.service.lsa$Boolean=true Vnolio.nimi.secured$Boolean=false -Vnolio.execution.name=wvpma947.gso.aexp.com Vnolio.execution.port=6600
Example: HOSTNAME should be entered as lpdwa888 instead of lpdwa888.trcw.us.aexp.com
23

If it completes, please verify that it installed correctly. Navigate to the conf folder.
cd /opt/CA/NolioAgent/conf
24
Step 11 (Find XML)

Open nimi_config.xml
25
Step 12 (Verify XML)

Verify that the supernode element matches the supernode element shown below. Save any changes you make.
(NOTE: Execution server must be listed by Hostname, NOT IP)
26
Step 13 (Restart Agent)

Navigate to /opt/CA/NolioAgent and run service nolioagent restart
Everything should now be correctly configured. If you have any questions, please email [email protected]
27
Step 1 (Uninstall Agent)

Navigate to /opt/CA/NolioAgent and run uninstall.sh
All agent components should now be correctly uninstalled. If you have any questions, please email [email protected]
28
HOW TO FIX AN INCORRECT AGENT INSTALLATION
If you accidentally installed the Agent using the wrong execution server or hostname, it is possible to fix this without reinstalling the Agent. You must have
root access to make the necessary changes.
Log into the target server using your UNIX ID.
29
Step 2 (Navigating to directory)

Navigate to the configuration directory found within the NolioAgent directory.
cd /opt/Nolio/NolioAgent/conf
30
Step 3 (Find XML)

31
Step 4 (Edit XML)

If you installed the Agent on the wrong hostname, navigate to the node_id element. Change the node_id to the correct hostname.
If you installed the Agent on the wrong execution server, navigate to the supernode element. Change the supernode to the correct execution server.
32

Save your changes, and restart the Agent.:
i.e. Navigate to /opt/CA/NolioAgent and run service nolioagent restart
Everything should now be correctly configured.

If you have any questions, please email [email protected]
JAVA (Solaris)
34

Before you begin installing the agent, you must have a secure copy tool.
Telnet and SSH to client (LARA DevOps team uses PuTTY)
SOLARIS 9 x86
First, you must download the Agent from: http://wpdcldwa00321.ads.aexp.com:8080/rasoftware/nolio_agent_solaris-x86-jre6_5_5_2_b191.sh
SOLARIS 10, 11 x86

First, you must download the Agent from: http://wpdcldwa00321.ads.aexp.com:8080/rasoftware/nolio_agent_solaris-x86_5_5_2_b191.sh
(NOTE: This can only be done if you or your designated admin team have root access. If you have problems with installation, please

Click Save
35
Step 3 (Moving Agent)

Move it to your home directory
36
Step 4 (Informational screen)

Now the Agent resides in users home directory and the user will be able to access the Nolio (LARA) agent in any server.
37

Log in to the server using your UNIX ID.
38
Step 6 (Copying agent to target server)

Copy the Agent into the folder tmp:
Solaris 9
cp nolio_agent_solaris-x86-jre6_5_5_2_b191.sh /tmp
Solaris 10, 11
cp nolio_agent_solaris-x86_5_5_2_b191.sh /tmp
39

Step 7 (Invoking root privileges)
Invoke root privileges using the following command:
pbrun /bin/su -
40

Step 8 (Changing Agent permissions)
Navigate to the tmp folder
Change the permissions of the Agent using the following command:
Solaris 9
chmod +X nolio_agent_solaris-x86jre6_5_5_2_b191.sh
Solaris 10, 11
chmod +X nolio_agent_solaris-x86_5_5_2_b191.sh
41
Command for Agent installation (Solaris 9) Note: Please Remove -jre6 in the command
below for Solaris 10, 11
$ /tmp/ nolio_agent_solaris-x86-jre6_5_5_2_b191.sh -q Vsys.installationDir=/opt/CA/NolioAgent -Vnolio.nimi.node.id=HOSTNAME Vnolio.nimi.port=6600 -Vinstall.service.lsa$Boolean=true Vnolio.nimi.secured$Boolean=false -Vnolio.execution.name=wvpma947.gso.aexp.com Vnolio.execution.port=6600
42

If it completes, please verify that it installed correctly. Navigate to the conf folder.
cd /opt/CA/NolioAgent/conf
43
Step 11 (Find XML)

44
Step 12 (Verify XML)

Verify that the supernode element matches the supernode element shown below. Save any changes you make.
(NOTE: Execution server must be listed by Hostname, NOT IP)
45

Everything should now be correctly configured. If you have any questions, please email [email protected]
46

47
If you accidentally installed the Agent using the wrong execution server or hostname, it is possible to fix this without reinstalling the Agent. You must have
root access to make the necessary changes.
Log into the target server using your UNIX ID.
48
Step 2 (Navigating to directory)

Navigate to the configuration directory found within the NolioAgent directory.
cd /opt/Nolio/NolioAgent/conf
49
Step 3 (Find XML)

50
Step 4 (Edit XML)

If you installed the Agent on the wrong hostname, navigate to the node_id element. Change the node_id to the correct hostname.
If you installed the Agent on the wrong execution server, navigate to the supernode element. Change the supernode to the correct execution server.
51

Save your changes, and restart the Agent.:
i.e. Navigate to /opt/CA/NolioAgent and run service nolioagent restart
Everything should now be correctly configured.

If you have any questions, please email [email protected]
JAVA (zLinux)
53

54
PREREQUISITES
Download the Generic Agent Installer. Link http://wpdcldwa00321.ads.aexp.com:8080/rasoftware/nolio_agent_5_5_2_b191.sh
LARA uses JRE 1.7 (32-bit) or later and JRE 1.7 (31-bit) needed to run agent installation on zLinux servers
Any client used to transfer the Nolio Agent file for staging needs to ensure they are using "binary" transfer or the file will get
corrupted. If one chooses to use SCP via command line to transfer the shell file, the file is transferred as is and one does not have to
specifically set transfer mode to "binary
IMPORTANT: For zLinux/AIX servers, you must use the Generic Nolio Agent: nolio_agent_5_5_2_b191.sh [NOT the one with OS type:
nolio_agent_linux_5_5_2_b191.sh or installation will fail! ]
AGENT INSTALLATION INSTRUCTIONS

Step 1 Log in with puTTY or any terminal and invoke root privileges
Step 2 Stage the nolio shell file in /tmp of the server
IMPORTANT!--> The file needs to be transferred in binary mode. (Please look at options within the client/commands you're
using to transfer)
Step 3 Ensure proper permissions are set to run the shell file
Command:
chmod 755 <fileName>
Step 4 Run the following two commands to ensure the installation is pointing to the correct java version of your choice.
Note: /usr/java/jre1.7.0_60/bin/java will equal your java installation path. If you do not run these commands,
it'll use the base version of java (java -version).
Command:
ln -sf /usr/java/jre1.7.0_60/bin/java /etc/alternatives/java
ln -sf /etc/alternatives/java /usr/bin/java
55

Step 5
Run the following command with the specified arguements in the example below.
Note: this command is ONE LINE!
Command:
/tmp/nolio_agent_5_5_2_b191.sh -q -Vsys.installationDir=/opt/CA/NolioAgent Vnolio.nimi.node.id=HOSTNAME -Vnolio.nimi.port=6600 -Vinstall.service.lsa$Boolean=true
-Vnolio.nimi.secured$Boolean=false -Vnolio.execution.name=wvpma1020.gso.aexp.com Vnolio.execution.port=6600
--Installation Begins-Unpacking JRE ...

Starting Installer...
The installation directory has been set to /opt/CA/NolioAgent.
Extracting files ...
Finishing Installation ...
--Installation Ends--
56

Step 6
Ensure the following directory structure has been created:
/opt/CA/NolioAgent/conf
Step 7
Open the nimi_config.xml file within the /opt/bin/CA/nolioAgent/conf directory.
Verify that the <supernode> shows the correct LARA server installed as port 6600 using DNS instead of IP.
For the specific installation used to build these instructions, the server was "wvpma1020.gso.aexp.com:6600
Under the first <supernode> tag add another <supernode> tag with wvpma1021.gso.aexp.com:6600
So it would look like
<supernodes>
<supernode>wvpma1020.gso.aexp.com:6600</supernode>
<supernode>wvpma1021.gso.aexp.com:6600</supernode>
</supernodes>
Step 8
Step 9
Validate that the agent is running locally.
Command:
ps -aef | grep Nolio
57
Example:
[root@LPSHA503 NolioAgent]# ps -aef | grep Nolio
root
27923
1 0 14:32 ?
00:00:00 /opt/CA/NolioAgent/bin/wrapper-linuxx86-32 /opt/CA/NolioAgent/conf/wrapper.conf wrapper.syslog.ident=NolioAgent
wrapper.pidfile=/opt/CA/NolioAgent/./NolioAgent.pid wrapper.name=NolioAgent
wrapper.displayname=Nolio Deployer Agent Service wrapper.daemonize=TRUE
wrapper.statusfile=/opt/CA/NolioAgent/./NolioAgent.status
wrapper.java.statusfile=/opt/CA/NolioAgent/./NolioAgent.java.status
wrapper.lockfile=/var/lock/subsys/NolioAgent
root
27925 27923 0 14:32 ?
00:00:04 ./jre/bin/NolioAgent Djava.ext.dirs=./jre/lib/ext:./lib:./libNoUpgrade:./lib/ext:./lib/db -Duser.country=US
-Duser.language=en -Djava.library.path=./lib:./bin -classpath ./lib/wrapper.jar Dwrapper.key=_qAYyQzjzpu914d7Brbxe1RAvlx6V2H2 -Dwrapper.port=32001 Dwrapper.jvm.port.min=31000 -Dwrapper.jvm.port.max=31999 Dwrapper.disable_console_input=TRUE -Dwrapper.pid=27923 -Dwrapper.version=3.5.6-st Dwrapper.native_library=wrapper -Dwrapper.service=TRUE -Dwrapper.cpu.timeout=10 Dwrapper.jvmid=1 -Dwrapper.lang.domain=wrapper -Dwrapper.lang.folder=../lang
com.nolio.platform.deployer.AgentWrapper com.nolio.platform.agent.Deployer
root
28211 27673 0 14:47 pts/1
00:00:00 grep Nolio
[root@LPSHA503 NolioAgent]#
--FINISHED!-Everything should now be correctly configured. LARA team should be able to validate the agent is running from their end to
ensure proper installation. Please Open a SEV 5 incident with LARA_AXP_AM if you are facing any issues with the agent
installation.

Agent Install Guide - JAVA and

Uploaded by

Copyright:

Available Formats

Agent Install Guide - JAVA and

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Agent Install Guide - JAVA and

Uploaded by

Copyright:

Available Formats

LARA

LARA (Nolio) Agent Installation

AGENT INSTALL FOR .NET (Windows)

AGENT INSTALL FOR JAVA (Linux)

AGENT INSTALL FOR JAVA (Solaris)

AGENT INSTALL FOR JAVA (zLinux)

HOW TO INSTALL AN AGENT

Step 1 (Downloading copy of Agent)

Step 2 (Saving Agent)

HOW TO INSTALL AN AGENT

HOW TO INSTALL AN AGENT

HOW TO INSTALL AN AGENT

HOW TO INSTALL AN AGENT

HOW TO INSTALL AN AGENT

HOW TO INSTALL AN AGENT

Step 6 (Agent installation complete)

HOW TO UNINSTALL AN AGENT

Step 1 (Beginning Uninstallation)

HOW TO UNINSTALL AN AGENT

HOW TO UNINSTALL AN AGENT

Step 3 (Finishing Uninstallation)

HOW TO INSTALL AN AGENT

Step 1 (Downloading copy of Agent)

Step 2 (Saving Agent)

HOW TO INSTALL AN AGENT

Step 3 (Moving Agent)

HOW TO INSTALL AN AGENT

Step 4 (Informational screen)

HOW TO INSTALL AN AGENT

Step 5 (Logging into target server)

HOW TO INSTALL AN AGENT

Step 6 (Copying agent to target server)

HOW TO INSTALL AN AGENT

HOW TO INSTALL AN AGENT

HOW TO INSTALL AN AGENT

Step 9 (Installing Agent)

Command for Agent installation

HOW TO INSTALL AN AGENT

HOW TO INSTALL AN AGENT

Step 11 (Find XML)

HOW TO INSTALL AN AGENT

Step 12 (Verify XML)

HOW TO INSTALL AN AGENT

Step 13 (Restart Agent)

HOW TO UNINSTALL AN AGENT

Step 1 (Uninstall Agent)

HOW TO FIX AN INCORRECT AGENT INSTALLATION

HOW TO FIX AN INCORRECT AGENT INSTALLATION

Step 2 (Navigating to directory)

HOW TO FIX AN INCORRECT AGENT INSTALLATION

Step 3 (Find XML)

HOW TO FIX AN INCORRECT AGENT INSTALLATION

Step 4 (Edit XML)

HOW TO FIX AN INCORRECT AGENT INSTALLATION

Step 5 (Restart Agent)

Everything should now be correctly configured.

HOW TO INSTALL AN AGENT

Step 1 (Downloading copy of Agent)