AeXNSC /? vs. documentation command-line parameters do not match

book

Article ID: 181218

calendar_today

Updated On:

Products

Management Platform (Formerly known as Notification Server)

Issue/Introduction

 

Resolution

Question
When the AeXNCS.exe is run with the /? option to view the command-line options, it shows a slightly different set of options than those which are documented in the Notification Server Reference manual. Why is there a difference?

Answer
When the /? option is run against the AeXNSC.exe the following options are displayed.

These are different from the command line options explained in the Notification Server Reference manual, which are as follows:

AeXNSC Command Line Arguments

aexnsc.exe [-s]
[-a arguments]
[ns= “NotificationServer”]
[nsweb=“NotificationServerWeb”]
[path=InstallationPath]
[NOSTARTMENU]
[NOTRAYICON]
[OKTOREBOOT]
[/Nologging]
[/remove]
[/ADDREMOVE]
[/s]
[reinstall]

This might cause some confusion even though both sets of command line options function correctly. These documented arguments are really those for the AexNSAgent.exe rather than for the AexNSC.exe. What needs to be understood is that any command line arguments passed to the AeXNSC.exe are simply passed through to the AexNSAgent.exe. It is the AexNSAgent.exe that actually does the agent installation.

The following log shows and installation with the AexNSC.exe command line options being used. The timestamp has been removed and the server name has been replaced with <server>.

==========================
AeXInstallPreCheck started
Current dir: C:\DOCUME~1\brian\LOCALS~1\Temp\apt0
AeXInstallPreCheck Finished
===========================

Passing control to AeXNSAgent
Commandline: Commandline: AeXNSAgent.exe /install /ns="<server>" /nsweb="http://<server>/altiris"
===============================
Core Agent Installation started
GetInstallPath didnt find installDir in the 6.x key, trying the old key.
GetInstallPath could not get installDir from the old key, the agent may not be installed.
Checking minimum requirements.
Detected NT based Platform.
RegisterMSXML: MSXML is installed
Server and web set to <server> and http://<server>/altiris
Product version set to 6.0.0.2386
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXAgentPages.dll has been registered.
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXAgentUI.dll has been registered.
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXBasicInventory.dll has been registered.
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXSWDAgent.dll has been registered.
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXTaskSchedulerLib.dll has been registered.
RegisterDLL, C:\Program Files\Common Files\Altiris\AexPackageDelivery.dll has been registered.
RegisterDLL, C:\Program Files\Common Files\Altiris\AeXNetComms.dll has been registered.
RegisterDLL, C:\Program Files\Common Files\Altiris\AtrsMCast.dll has been registered.
StartAgent, starting core agent.
StartAgent, starting core agent.
Core Agent Installation Ended 
===============================


The following log shows and installation with the AexNSC.exe command line options being used. The timestamp has been removed and the server name has been replaced with <server>.

==========================
AeXInstallPreCheck started
Current dir: C:\DOCUME~1\brian\LOCALS~1\Temp\apt0
AeXInstallPreCheck Finished
===========================

Passing control to AeXNSAgent
Commandline: AeXNSAgent.exe -s -a ns="<server>" nsweb="http://<server>/Altiris" NOSTARTMENU /s
===============================
Core Agent Installation started
GetInstallPath didnt find installDir in the 6.x key, trying the old key.
GetInstallPath could not get installDir from the old key, the agent may not be installed.
Checking minimum requirements.
Detected NT based Platform.
RegisterMSXML: MSXML is installed
Server and web set to <server> and http://<server>/Altiris
Product version set to 6.0.0.2386
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXAgentPages.dll has been registered.
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXAgentUI.dll has been registered.
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXBasicInventory.dll has been registered.
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXSWDAgent.dll has been registered.
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXTaskSchedulerLib.dll has been registered.
RegisterDLL, C:\Program Files\Common Files\Altiris\AexPackageDelivery.dll has been registered.
RegisterDLL, C:\Program Files\Common Files\Altiris\AeXNetComms.dll has been registered.
RegisterDLL, C:\Program Files\Common Files\Altiris\AtrsMCast.dll has been registered.
StartAgent, starting core agent.
StartAgent, starting core agent.
Core Agent Installation Ended 
===============================


Note: An important point to consider when doing a manual installation of the Altiris Agent is that if there is no "ns" or "nsweb" options the Diagnostics DLL will be automatically registered. Without those options, the agent will not know what server to communicate with. Internally this may be percieved as a network connection problem so the diagnostics are registered so the user can look at the network, servers, and so on to determine if a problem exists.

The following log illustrates this point. As can be seen in this log the only argument passed is the "/s" or silent installation option. This isn't sufficient for a proper installation of the Altiris Agent, that is, no communication with a Notification Server will be made in this state.

==========================
AeXInstallPreCheck started
Current dir: C:\DOCUME~1\brian\LOCALS~1\Temp\apt0
AeXInstallPreCheck Finished
===========================

Passing control to AeXNSAgent
Commandline: AeXNSAgent.exe /s
===============================
Core Agent Installation started
GetInstallPath didnt find installDir in the 6.x key, trying the old key.
GetInstallPath could not get installDir from the old key, the agent may not be installed.
Checking minimum requirements.
Detected NT based Platform.
RegisterMSXML: MSXML is installed
SetServerAndWeb cannot set the NS value becuase it is blank.
Product version set to 6.0.0.2386
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXAgentPages.dll has been registered.
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXAgentUI.dll has been registered.
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXBasicInventory.dll has been registered.
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXSWDAgent.dll has been registered.
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXTaskSchedulerLib.dll has been registered.
RegisterDLL, C:\Program Files\Common Files\Altiris\AexPackageDelivery.dll has been registered.
RegisterDLL, C:\Program Files\Common Files\Altiris\AeXNetComms.dll has been registered.
RegisterDLL, C:\Program Files\Common Files\Altiris\AtrsMCast.dll has been registered.
Enabling Diagnostics.
RegisterDLL, C:\Program Files\Altiris\Altiris Agent\AeXAgentDiagnostics.dll has been registered.
StartAgent, starting core agent.
StartAgent, starting core agent.
Core Agent Installation Ended 
===============================

Attachments