Codenica logo
     IT Audit and Inventory Software
CODENICA - 11 YEARS
 
User Guide
main user guide menu »

Tutorial: Installing the Agent and Agent Server in Codenica Audit
 

Introduction

In the following example we will perform the initial installation of Codenica Audit including the Agent Server and Agents. Installation will be performed in the network based on a domain controller (Windows Server 2008 Enterprise). The network is wireless. We have created a domain named test.codenica.com and connected two computers to it (Win7 and Vista).

Note:
The following network environment has been selected as an example only and IS NOT REQUIRED to use Codenica Audit.
Codenica Audit can be installed in any network environment.

In our example, we used 3 computers intended to test applications.

Host: Win7.test.codenica.com
Windows 7 Professional (32-bit).
Firewall: Norton Internet Security
We will use this computer to install Codenica Audit (console) and the Agent

Host: W2008.test.codenica.com
Windows Server 2008 Enterprise (32-bit). 60-day trial version.
Firewall: Built-in
Server Role: Active Directory Domain Services, DNS Server
Additionally included : Wireless LAN Service
We will use this computer to install the Agent Server and the Agent

Host: Vista.test.codenica.com
Windows Vista Business (32-bit).
Firewall: Norton Internet Security
We will use this computer to install the Agent

 

Figure 1: Detailed data of the domain controller

 

Codenica Audit 2 Agent

 

Installation process

When you launch Codenica Audit for the first time, a New Audit Wizard starts up automatically. To use Codenica Audit, you must first add all the hosts which represent computers in the network. In order to do this, we clicked the [Search for hosts] button. The program found our three hosts and placed them in the list on the right side of the Wizard. Here we may add information on each host. We clicked the [Next] button.

 

Figure 2: Codenica Audit first launch - New Audit Wizard

 

Codenica Audit 2 Agent

 


In the next step, we need to remotely install the Agent Server. The installation can be performed on any computer with a server role in the network. In this case, we selected Windows Server 2008 Enterprise (W2008.test.codenica.com). All installation data should be correctly completed. The server password provides a protection against another Codenica Audit console connecting to this server. In the authorization data we must provide the login and password of the Administrator who is a member of the local Administrator group.

Note:
It is very important to use a local Administrator’s account and provide his/her correct login data during the installation. The login and password are not verified by any means or method.

Perform the following actions to verify that the Local Administrator account is enabled and active:
Start->Run->cmd
and enter:
net user administrator /enable:yes
net user administrator /active:yes

When installed remotely for the first time, Codenica Audit will display a message to download the necessary tools (PSTools) from the Microsoft site to perform a remote installation. Unfortunately, most free application licenses do not allow integration with a commercial application in one installation package. For this reason, we had to program the use of this application as a third party DLC.

 

Figure 4: Downloading the remote installation tools from the Internet

 

Codenica Audit 2 Agent

 


After completing the data fields, click the [Start process] button.

 

Figure 3: Installing the Agent Server remotely

 

Codenica Audit 2 Agent

 


Now the only thing left is to wait for the completion of the remote installation of the Agent Server and for the contact between your console and this server. In our example, it took 2 minutes and 45 seconds. Installation time may differ depending on the connection, server operation speed, etc.

When the Agent Server installation is completed, you should see the following screen
(the Agent Server group will display a description of our Agent Server and a green icon of the host).

Note:
Codenica Audit includes a mechanism to programmatically add a Console, Agent Server and Agents to the exceptions in the system Firewall and to open their ports. However, if any other Firewalls are in use, you must manually add all the modules to the exception list and open their ports. You must do this on each computer on which a given module is installed.

Therefore, in our case we will do the following:

Host: Win7.test.codenica.com
Firewall actions:
• Add applications: PCAudit.exe (console), PCAgent.exe (Agent), PCAgentService.exe (Agent Server) to the exceptions (full range).
• Open ports:
      − AGENT: TCP: 57771, UDP: 57772
      − AGENT SERVICE: TCP: 57777, UDP: 57778
      − CONSOLE (CODENICA AUDIT): TCP: 57775, UDP: 57776

Host: W2008.test.codenica.com
Firewall actions:
• Add applications: PCAgentServer.exe (Agent Server), PCAgent.exe (Agent), PCAgentService.exe (Agent Service) to the exceptions (full range).
• Open ports:
      − AGENT: TCP:57771, UDP:57772
      − AGENT SERVICE: TCP: 57777, UDP: 57778
      − AGENT SERVER: TCP: 57773, UDP: 57774

Host: Vista.test.codenica.com
Firewall actions:
• Add applications: PCAgent.exe (Agent), PCAgentService.exe (Agent Service) to the exceptions (full range).
• Open ports:
      − AGENT: TCP: 57771, UDP: 57772
      − AGENT SERVICE: TCP: 57777, UDP: 57778

In our particular case (Norton Internet Security installed on two computers and Windows Firewall on the server) we did not have to do that.

 

Figure 5: The Agent Server has been installed correctly

 

Codenica Audit 2 Agent

 


We can now proceed to install the Agents. Click the [Agents >>>] button or select the [Agents] tab visible in the upper area of the Wizard.

When the remote Agent installation symbol is displayed, choose the button marked with the plus sign and add our three hosts. Just as during the remote Agent Server installation, here we complete the authorization data of the local Administrator - for each selected host.

Note:
It is very important to use a local Administrator’s account and provide his/her correct login data during the installation. The login and password are not verified by any means or method.

Perform the following actions to verify that the Local Administrator account is enabled and active:
Start->Run->cmd
and enter:
net user administrator /enable:yes
net user administrator /active:yes

After completing the data, click the [Start process] button.

Note:
After the Agents have been installed, you may need to add the modules to the Firewall exception list and open their ports.
The configuration is described in the previous step.

 

Figure 6: Installing Agents remotely

 

Codenica Audit 2 Agent

 


After clicking the [Start process] button, wait for the completion of the remote installation of Agents and for your Console to contact them. In our case, this took 5 minutes 30 seconds. Installation time may differ depending on the connection, server operation speed, etc.

 

Figure 7 : Remote Agent installation in progress.

 

Codenica Audit 2 Agent

 


When the process of Agent installation is completed, the following screen displays
(the Agent status will change to "Agent installed" and the Agent host icon will display a lightning bolt).

 

Figure 8: Remote Agent installation completed.

 

Codenica Audit 2 Agent

 


OK. The Agent Server and Agent installation is done. Now scan the computers using the installed Agents.
Click the [Next] button and replace the "Scan type" entry for our computer (Win7.test.codenica.com) with "Agent". To do this, click the left mouse button on the "Scan type" field, and select the option "Agent" from the drop-down list.

 

Figure 9: Preparing to scan computers using Agents

 

Codenica Audit 2 Agent

 


Now click the [Start process] button and wait until scanning is completed. The default scan should run quickly and smoothly. In our case, each computer was scanned in less than 10 seconds.

 

Figure 10: Scanning using Agents

 

Codenica Audit 2 Agent

 


Click the [Finish] button and confirm that the newly created audit has been saved.

To perform an additional test of Agent operations, open the function Preview screens from the Agent > Helpdesk menu.

 

Figure 11: Select the Preview screens

 

Codenica Audit 2 Agent

 


In the Host ComboBox select your three hosts and click the [Add] button after each selection.

 

Figure 12: Hosts with Agents - Preview screens (online)

 

Codenica Audit 2 Agent

 
line