Package com.nt.udc.admin.server

Class AdminServerImpl

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteServer

java.rmi.server.UnicastRemoteObject

com.nt.udc.admin.server.AdminServerImpl

All Implemented Interfaces:

AdminServer, AcctEventListener, Serializable, Remote, EventListener

public class AdminServerImpl
extends UnicastRemoteObject
implements AdminServer, AcctEventListener

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	AdminServerImpl.ShutdownThread

Field Summary

Fields

Modifier and Type	Field	Description
static final String	IS_CNE_ENV
static final String	OCOMC_AS_EVENT_SENDER_FORCE_SYNC_ENV
static final String	OCOMC_AS_EVENT_SENDER_FORCE_SYNC_PROP
static final String	OCOMC_AS_EVENT_SENDER_THREAD_COUNT_ENV
static final String	OCOMC_AS_EVENT_SENDER_THREAD_COUNT_PROP
static final String	SERVER_NAME

Fields inherited from class java.rmi.server.RemoteObject

ref

Fields inherited from interface com.nt.udc.admin.server.AdminServer

ADMIN_API_FACTORY_NAME, NODE_API_FACTORY_NAME, SNMP_ADMIN_API_NAME

Constructor Summary

Constructors

Constructor	Description
AdminServerImpl(String inOSAHome, int port, int adminSvrRMIPortNum, int aPIMetaFactoryRMIPortNo)	constructor without SSL
AdminServerImpl(String inOSAHome, int port, int adminSvrRMIPortNum, int aPIMetaFactoryRMIPortNo, boolean withSSL)	constructor for enabling SSL

Method Summary

Modifier and Type	Method	Description
void	addAcctEventListener(AcctEventListener ael)
void	addNM(String inIPAddress, String inName, int inPort)
String	addNode(String inIPAddress, int Port, com.nt.udc.admin.NodeInfo nodeInfo)
String	addNode(String inIPAddress, int Port, com.nt.udc.admin.NodeInfo nodeInfo, boolean regNodeId)
String	addRoute(String sourceNodeId, String destNodeId, String routeFunction)
String	addRoute(String sourceNodeId, String destNodeId, String routeFunction, String rField, Vector rCondition)
void	addRRNodeDestination(String sourceNodeId, String destNodeId)
void	addTrapHost(com.nt.udc.admin.TrapHost host)	Adds a new host to the list of SNMP Trap Hosts
protected void	addTrapHostList(com.nt.udc.admin.TrapHostList hosts, String nmIP, int nmPort)	This is a method used by the AdminServerImple to push a complete TrapHostList down to a specific Node Hosts that it is managing.
void	addUser(com.nt.udc.admin.User userToAdd, com.nt.udc.admin.User authUser)	Attempts to add userToAdd to the list of users for this Admin Server.
void	adminServerChanged(StatusMessage sm)	Indicates that the properties of an Admin Server have changed.
void	areNodesDeletable(Vector nodeIds)
void	backUpNode(String nodeId)
void	changeNM(com.nt.udc.admin.NMItem nmItem, String inName)
void	changeNM(String id, String inName)
void	changeNM(String inIPAddress, String inName, int inPort)
void	changeRoutingToRR(String sourceNodeId, String destNodeId)
List	checkImportStatus()
void	cleanOutputBackupNodeChainTest(String testId)	This method cleans output backed up as part of a Node Chain Test.
void	clearNMAlarm(String inIPAddress, int inPort)
void	clearNodeAlarm(String nodeId)
void	clearNodeIdCorrelationsMap()
void	compileNPL(byte[] nplContent)	This method takes nplContent as input and checks for any compilation errors
void	completeNodeChainTest(String testId)	This method completes all the tasks required to conclude a Node Chain Test.
void	completeNodeChainTest(String testId, boolean isStale)	This method completes all the tasks required to conclude a Node Chain Test.
void	copyNPL(DCNodeTypeIfc inNodeType, String inRuleFileName)
boolean	deleteRuleFile(com.nt.udc.admin.NodeInfo info, String inRuleFileDisplayName, String inFileName)
void	doBackUp(List nodeManagerMap)
byte[]	exportWithCustomization(Vector nmListToExport, String exportName)	Returns a byte array of Customization content which includes 1.
byte[]	exportWithCustomization(Vector nmList, Vector nodesToExport, String exportName)
String	exportXMLSystemModel()
String	exportXMLSystemModel(Vector vctNMItemsToExport)
String	exportXMLSystemModel(Vector nMItems, Vector nodesToExport)
String	exportXMLSystemModelOfNodeChain(Vector nodesToExport)
boolean	extendTestTimeout(String testId)	Extends the timeout duration for a test by the default timeout value, identified by the given testId.
void	fileChanged(com.nt.udc.admin.FileItem file)	Indicates that a system file changed.
static String	getAdminDN()	Returns the LDAP DN for the Admin user of the system.
boolean	getAdminSvrAuth(String adminIp, String nodeIp, int nodePort)
Set<String>	getAllLockedAndRunningTestNodes()
Set<String>	getAllLockedAndRunningTestNodesSharingRuleFile(com.nt.udc.admin.NodeInfo info, String inRuleFileDisplayName)	This method return Set of nodeIds which are using same RuleFile which are under Test.
Hashtable	getASConfig()	Gets the Admin Server Config object (really just a Hashtable).
byte[]	getASLog()
boolean	getAuthUsers()	returns true if authentication is enabled
Map	getCartridgeVersionInfo(String ip, int port)
Config	getConfig()
String	getConfigValue(DCNodeTypeIfc inNodeType, String inRuleFileName, String inKey)
ImportLock	getCurrentImport()	Retrieves the lock information for the current import, if any.
Vector	getCurrentPerformanceMetrics(String ip, int port)
Vector	getDestNodesInNM(String srcNode, String host, Integer port)
TNCDetails	getDetailsAboutTest(String testId)	Retrieves details about a specific test.
static String	getDomain()	Returns the LDAP domain currently being used by the system.
String	getDSHost()	Returns the Host name of the Data Server.
String	getDSPort()	Returns the Port of the Data Server.
AcctEventSender	getEventSender()
ArrayList	getExposedFields(DCNodeTypeIfc inNodeType, String inRuleFileName, String inReason)
static String	getGroupInfo()	Returns the LDAP group which indicates the group that users belong to in the directory.
String	getImportCustomLog()	The import customization log will be returned.
List	getImportedNodeManagerMap()
ImportTaskProgressResponse	getImportTask(String importId, String importTaskId)	Retrieves information about a specific import task associated with the given import ID and task ID.
ArrayList	getInputFields(DCNodeTypeIfc inNodeType, String inRuleFileName)
Vector	getInputNodes(String nodeId)
static String	getLdapURL()	Returns the URL of the LDAP directory that this AdminServer is using for user authentication.
Set	getLicensedSet(Set allTemplates)
List	getLicenses()
Logger	getLogger()
static String	getMemberInfo()
com.nt.udc.admin.NMItem	getNM(String id)
Map<String,List<String>>	getNMInvolvedInTestNodeChain(NodeChainTestCfgItemReadOnlyIfc testNodeChainConfig)	Retrieves a mapping of Node Managers involved in the test node chain.
Vector	getNMList()
byte[]	getNMLog(String inIPAddress, int inPort)
VersionInfo	getNMVersionInfo(String ip, int port)
NodeChainTestCfg	getNodeChainTestCfg()	This method returns NodeChainTestCfg object.
String	getNodeContext(String nodeId)
com.nt.udc.admin.NodeInfo	getNodeInfo(String inNodeId)
Vector	getNodeItemList()	Returns a Vector of NodeItem objects
Vector	getNodeList()	Returns a Vector of NodeInfo objects
Vector	getNodeList(String inIPAddress, int inPort)
byte[]	getNodeLog(String inNodeId)
boolean	getNodeMgrInfo(String inIPAddress, int inPort, boolean lastTryFailed)	Refreshes the node list and node manager status of the NMItem object stored in the SystemModel.
String	getOsaHome()
ArrayList	getOutputFields(DCNodeTypeIfc inNodeType, String inRuleFileName)
List<NodeChainOutputRecords>	getOutputNodeChainTest(String nodeId)	This method returns data from output file/s for a node, as part of Node Chain Test.
Vector	getOutputNodes(String inNodeId)
int	getPort()
boolean	getResetPwdInfo(com.nt.udc.admin.User user)	This method receives the reset password information for given user
int	getRole(com.nt.udc.admin.User user, com.nt.udc.admin.User authUser)	Returns the role of the user passed as argument
String	getRoleFromDN(String dnName)
byte[]	getRuleFileContent(com.nt.udc.admin.NodeInfo info, String inFileName)
String	getRuleFileDisplayName(String nodeContext, String ruleFileName)	This methods returns the ruleFileDisplayName for a given rule file.
int	getSecondsToPasswordExpiration(com.nt.udc.admin.User user)	This method receives the seconds for password expiration of given user
Map	getSiteInfo()
List<String>	getSol42DescriptorFiles(String nmID)	This method returns the list of names of available descriptor files.
StatusMessage	getStatus()
SystemModel	getSystemModel()
com.nt.udc.admin.Template	getTemplate(String templateId)
TemplateDef	getTemplateDef(String templateId)
com.nt.udc.admin.TemplateTreeRoot	getTemplateTree()
static long	getTimeoutValue()
long	getTimeoutValueMiliSec()	returns the time out value for session expiry
com.nt.udc.admin.TrapHostList	getTrapHostList()	Gets list of known SNMP Trap Hosts
Vector	getUserList(com.nt.udc.admin.User authUser)	Retrieves the list of users that may access this Admin Server
VersionInfo	getVersionInfo()
Map<String,ArrayList<String>>	groupNodesBasedOnNM(ArrayList<String> nodesIds)	This function groups nodes managed by the same NM together.
boolean	hasAdminPriv(com.nt.udc.admin.User user)	Indicates whether the given User has Administrative privileges for this Admin Server
boolean	importCustomization(ArrayList nmMaps, byte[] contents)	This method receives the content of nmx file from admin client and extracts customization archives of individual node managers and distributes them to appropriate node managers based on node manager map.
void	importSystemModel(List nodeManagerMap, boolean corrIdMap, boolean isNodeChainImport)
void	initRegistry(int rmiPort, int aPIMetaFactoryRMIPortNo)
void	integrateRouting(String epdcHost, Integer epdcPort)
void	integrateRoutingCCNMScaleUp(String ccHost, Integer ccPort)
void	integrateScalingDownForNonSegregatedNM(String list)
void	integrateScalingDownForSegregatedNM(String list)
boolean	isHostBasedEnv()
boolean	isLicensed(String templateId)
boolean	isNodePartOfRunningTNC(String nodeId)	This method validates whether a node is under test or not.
boolean	isReceiverValid(String reciverId)
boolean	isSystemRuleFile(com.nt.udc.admin.NodeInfo info, String inFileName)
boolean	loadRuleClass(String className)	Attempts to load the given class name.
void	loadXMLSystemModel(String xmlSystemModel)
String	login(com.nt.udc.admin.User user)	Authenticates the given user
void	logout(com.nt.udc.admin.User user)	Removes the userId from the AS's current list of users
static void	main(String[] args)
void	modifyTrapHost(com.nt.udc.admin.TrapHost oldhost, com.nt.udc.admin.TrapHost newhost)	Modifies a host in the list of SNMP Trap Hosts
void	modifyUser(com.nt.udc.admin.User userToAdd, com.nt.udc.admin.User authUser, Boolean changePassword)	Attempts to modify attributes for userToMod
void	nodeChanged(com.nt.udc.admin.NMItem nmItem)	Indicates that the properties of a Node have changed.
void	nodeManagerChanged(com.nt.udc.admin.NMItem nmItem)	Indicates that the properties of a Node Manager have changed.
void	nodeManagersAdded(Vector nmList)	Indicates that one or more NodeManagers were added.
void	nodeManagersRemoved(Vector nmList)	Indicates that one or more NodeManagers were removed.
void	nodePerformanceUpdate(Vector perfs)	Indicates that node performance information was updated.
void	nodesAdded(com.nt.udc.admin.NMItem nmItem)	Indicates that a Node has been added to a particular Node Manager.
void	nodesRemoved(com.nt.udc.admin.NMItem nmItem)	Indicates that a Node has been removed from a particular Node Manager.
boolean	nplChanged(com.nt.udc.admin.NodeInfo nodeInfo)	Always returns true.
void	performConfigAction(ConfigActionIfc configActionObject, com.nt.udc.admin.NodeInfo nodeInfo)
void	performConfigAction(ConfigActionIfc configActionObject, com.nt.udc.admin.NodeInfo nodeInfo, String ipAddr, int port)
void	pollRecordCounts()
void	refreshStatuses()
void	registerTNCEventReceiver(String id, TNCEventReceiverIfc tncRec, boolean registerForAllTests)	Registers a TNC event receiver with optional registration for all tests.
void	reloadNPL(com.nt.udc.admin.NodeInfo nodeInfo)
boolean	reMapWalletPassword(String nodeId, List<int[]> indicesList)	This method is used to map wallet passwords from old index to new index.
void	removeAcctEventListener(AcctEventListener ael)
void	removeNM(com.nt.udc.admin.NMItem nmItem)
void	removeNM(String id)
void	removeNM(String inIPAddress, int inPort)
void	removeNodes(Vector inNodeIds)
void	removeOutputNodes(String inNodeId, Vector inNodeOutputs)
String	removeRoute(String sourceNodeId, String destNodeId)
void	removeRRNodeDestination(String destNodeId)
void	removeTrapHost(com.nt.udc.admin.TrapHost host)	Removes a host from the list of SNMP Trap Hosts
void	removeTrapHosts(Vector hosts)	Removes a list of hosts from the SNMP Trap Hosts object
void	removeUsers(Vector userList, com.nt.udc.admin.User authUser)	Attempts to remove the Users contained in userList from the list of users for this Admin Server.
String	replicateNode(String sourceNodeId, String destNodeManagerId)	Replicates a node to with the given nodeId to a destination node manager.
boolean	replicateNodeManager(NodeManagerReplicateRequest request)	Replicates the node manager based on the provided request.
ImportTaskItem	runImport(String importId)	Initiates the execution of an import operation with the specified import ID.
void	runNodeChainTest(String uploadId, NodeChainTestCfgItem cfgItem)	This method writes test cfg item to nodeChainTest.cfg file and runs all the nodes which are part of node chain under test.
boolean	scaleDownNodeManager(String nmId, boolean isPreBackupCleanup)	scaleDown node manager based on the provided flag.
static void	setAdminDN(String newDN)	Sets the LDAP DN for the Admin user of the system.
void	setASConfig(Hashtable asConfig)	Sets the Admin Server Config object.
void	setDirConnection(DirectoryConnection dirconn)
static void	setDomain(String newDomain)	Sets the LDAP domain to be used by the system.
static void	setGroupInfo(String newGroup)	Sets the LDAP group which indicates the group that users should belong to in the directory.
void	setImportExportProperty(String[][] newNmMap)
static void	setLdapURL(String newURL)	Sets the URL of the LDAP directory that this AdminServer is using for user authentication.
static void	setMemberInfo(String info)
static void	setNoAuthentication()	this method is used for unit tests
void	setNodeDescription(com.nt.udc.admin.NodeInfo nInfo)	Replaces the NodeInfo object with nodeInfo for the given Node contained in nodeInfo.
void	setNodeInfo(com.nt.udc.admin.NodeInfo nodeInfo)	Locates the reference to nodeManager for the given nodeId, and invokes the setNodeInfo() method of the nodeManager located, with the given nodeInfo.
void	setOutputNodes(String inNodeId, Vector inNodeOutputs)
void	setRefreshInterval(long inRefInt)
static void	setTimeoutValue(long value)
void	shutdown()	shutdown the admin server
void	shutdown(int exitCode)
void	startAllNodes(String inIPAddress, int inPort)
void	startNodes(Vector inNodeIds)
void	startNodesInternal(Vector inNodeIds)
void	stopAllNodes(String inIPAddress, int inPort)
void	stopNodes(Vector inNodeIds)
void	stopNodesInternal(Vector inNodeIds)
void	subscribeReceiverForTest(String receiverID, String testID)	Subscribes a receiver to receive events for a specific test.
void	systemUpdate(SystemModel model)	Indicates that the system has substantially changed.
ImportMetadata	updateImportMetadata(String importId, ImportMetadata newMetadata)	Updates the metadata associated with a specific import.
String	updateRoute(String sourceNodeId, String destNodeId, String routeFunction)
String	updateRoute(String sourceNodeId, String destNodeId, String routeFunction, String rField, Vector rCondition)
String	updateRouteParameters(String sourceNodeId, String destNodeId, String rField, Vector rCondition)
void	updateRuleFileContent(com.nt.udc.admin.NodeInfo info, String inRuleFileDisplayName, String inRuleFileName, byte[] ruleFileContent)
ImportMetadata	uploadImport(String configuration, byte[] customization)	Uploads an import with the provided configuration and customization data.
void	uploadNodeChainTestInputFile(byte[] data, String nodeId, String fileName)	This method backs up input directory for a node if backup flag is set to true, and uploads the input file to the upload location provided.
boolean	validateNMForNodeTypes(String includeExclude, String majMin, String host, Integer port)
void	validateNmMaps(List<com.nt.udc.upgrade.NodeManagerMap> nmMaps)
void	validateNMName(String inName)
void	writeImportNodeCorrelationMap(String parent, String replicated)

Methods inherited from class java.rmi.server.UnicastRemoteObject

clone, exportObject, exportObject, exportObject, exportObject, exportObject, unexportObject

Methods inherited from class java.rmi.server.RemoteServer

getClientHost, getLog, setLog

Methods inherited from class java.rmi.server.RemoteObject

equals, getRef, hashCode, toString, toStub

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

SERVER_NAME

public static final String SERVER_NAME

IS_CNE_ENV

public static final String IS_CNE_ENV

See Also:

• Constant Field Values

OCOMC_AS_EVENT_SENDER_THREAD_COUNT_ENV

public static final String OCOMC_AS_EVENT_SENDER_THREAD_COUNT_ENV

See Also:

• Constant Field Values

OCOMC_AS_EVENT_SENDER_THREAD_COUNT_PROP

public static final String OCOMC_AS_EVENT_SENDER_THREAD_COUNT_PROP

See Also:

• Constant Field Values

OCOMC_AS_EVENT_SENDER_FORCE_SYNC_PROP

public static final String OCOMC_AS_EVENT_SENDER_FORCE_SYNC_PROP

See Also:

• Constant Field Values

OCOMC_AS_EVENT_SENDER_FORCE_SYNC_ENV

public static final String OCOMC_AS_EVENT_SENDER_FORCE_SYNC_ENV

See Also:

• Constant Field Values

Constructor Details

AdminServerImpl

public AdminServerImpl(String inOSAHome,
 int port,
 int adminSvrRMIPortNum,
 int aPIMetaFactoryRMIPortNo,
 boolean withSSL)
                throws RemoteException

constructor for enabling SSL

Parameters:

inOSAHome - OSAHome is the installation directory for Network Mediation

port - Admin Server port

adminSvrRMIPortNum - RMI port for Admin Server

aPIMetaFactoryRMIPortNo -

withSSL - indicates Admin Server should run in SSL mode or not

Throws:

RemoteException

AdminServerImpl

public AdminServerImpl(String inOSAHome,
 int port,
 int adminSvrRMIPortNum,
 int aPIMetaFactoryRMIPortNo)
                throws RemoteException

constructor without SSL

Parameters:

inOSAHome - OSAHome is the installation directory for Network Mediation

port - Admin Server Port

adminSvrRMIPortNum - RMI port for Admin server

aPIMetaFactoryRMIPortNo -

Throws:

RemoteException

Method Details

getPort

public int getPort()

getOsaHome

public String getOsaHome()

Specified by:

getOsaHome in interface AdminServer

getLogger

public Logger getLogger()

isHostBasedEnv

public boolean isHostBasedEnv()
                       throws RemoteException

Specified by:

isHostBasedEnv in interface AdminServer

Throws:

RemoteException

getEventSender

public AcctEventSender getEventSender()
                               throws RemoteException

Specified by:

getEventSender in interface AdminServer

Throws:

RemoteException

addAcctEventListener

public void addAcctEventListener(AcctEventListener ael)
                          throws RemoteException

Specified by:

addAcctEventListener in interface AdminServer

Throws:

RemoteException

registerTNCEventReceiver

public void registerTNCEventReceiver(String id,
 TNCEventReceiverIfc tncRec,
 boolean registerForAllTests)
                              throws RemoteException

Registers a TNC event receiver with optional registration for all tests. This method registers a TNCEventReceiverIfc implementation with the provided identifier, allowing an option to register for events across all tests.

Specified by:

registerTNCEventReceiver in interface AdminServer

Parameters:

id - The unique identifier for the TNC event receiver.

tncRec - The TNCEventReceiverIfc implementation to be registered.

registerForAllTests - A boolean flag indicating whether to register for events across all tests.

Throws:

RemoteException - If a remote exception occurs during the registration process.

subscribeReceiverForTest

public void subscribeReceiverForTest(String receiverID,
 String testID)
                              throws RemoteException

Subscribes a receiver to receive events for a specific test. This method subscribes a receiver identified by receiverID to receive events associated with the specified testID.

Specified by:

subscribeReceiverForTest in interface AdminServer

Parameters:

testID - The unique identifier of the test for which the receiver is subscribing.

recieverID - The unique identifier of the receiver to be subscribed.

Throws:

RemoteException - If a remote exception occurs during the subscription process.

removeAcctEventListener

public void removeAcctEventListener(AcctEventListener ael)
                             throws RemoteException

Specified by:

removeAcctEventListener in interface AdminServer

Throws:

RemoteException

getSystemModel

public SystemModel getSystemModel()
                           throws RemoteException

Specified by:

getSystemModel in interface AdminServer

Throws:

RemoteException

checkImportStatus

public List checkImportStatus()

Specified by:

checkImportStatus in interface AdminServer

importSystemModel

public void importSystemModel(List nodeManagerMap,
 boolean corrIdMap,
 boolean isNodeChainImport)
                       throws com.nt.udc.upgrade.ImportException

Specified by:

importSystemModel in interface AdminServer

Throws:

com.nt.udc.upgrade.ImportException

doBackUp

public void doBackUp(List nodeManagerMap)
              throws BulkOpException,
RemoteException

Specified by:

doBackUp in interface AdminServer

Throws:

BulkOpException

RemoteException

validateNmMaps

public void validateNmMaps(List<com.nt.udc.upgrade.NodeManagerMap> nmMaps)
                    throws RemoteException

Specified by:

validateNmMaps in interface AdminServer

Throws:

RemoteException

loadXMLSystemModel

public void loadXMLSystemModel(String xmlSystemModel)
                        throws com.nt.udc.upgrade.ImportException

Specified by:

loadXMLSystemModel in interface AdminServer

Throws:

com.nt.udc.upgrade.ImportException

getImportedNodeManagerMap

public List getImportedNodeManagerMap()

Specified by:

getImportedNodeManagerMap in interface AdminServer

exportXMLSystemModel

public String exportXMLSystemModel(Vector vctNMItemsToExport)
                            throws com.nt.udc.upgrade.ExportException

Specified by:

exportXMLSystemModel in interface AdminServer

Throws:

com.nt.udc.upgrade.ExportException

exportXMLSystemModel

public String exportXMLSystemModel(Vector nMItems,
 Vector nodesToExport)
                            throws com.nt.udc.upgrade.ExportException

Specified by:

exportXMLSystemModel in interface AdminServer

Throws:

com.nt.udc.upgrade.ExportException

exportXMLSystemModelOfNodeChain

public String exportXMLSystemModelOfNodeChain(Vector nodesToExport)
                                       throws com.nt.udc.upgrade.ExportException

Specified by:

exportXMLSystemModelOfNodeChain in interface AdminServer

Throws:

com.nt.udc.upgrade.ExportException

exportXMLSystemModel

public String exportXMLSystemModel()
                            throws com.nt.udc.upgrade.ExportException

Specified by:

exportXMLSystemModel in interface AdminServer

Throws:

com.nt.udc.upgrade.ExportException

shutdown

public void shutdown()
              throws RemoteException

shutdown the admin server

Specified by:

shutdown in interface AdminServer

Throws:

RemoteException

shutdown

public void shutdown(int exitCode)
              throws RemoteException

Throws:

RemoteException

setDirConnection

public void setDirConnection(DirectoryConnection dirconn)
                      throws RemoteException

Specified by:

setDirConnection in interface AdminServer

Throws:

RemoteException

getNodeMgrInfo

public boolean getNodeMgrInfo(String inIPAddress,
 int inPort,
 boolean lastTryFailed)
                       throws RemoteException

Refreshes the node list and node manager status of the NMItem object stored in the SystemModel. This method is called from the NMConnector thread during AdminServer startup.

Parameters:

inIPAddress - IP address of the node manager

inPort - RMI port of the node manager

Returns:

true or false, indicating successful/unsuccessful connection

Throws:

RemoteException

getAdminSvrAuth

public boolean getAdminSvrAuth(String adminIp,
 String nodeIp,
 int nodePort)
                        throws RemoteException

Specified by:

getAdminSvrAuth in interface AdminServer

Throws:

RemoteException

getNMList

public Vector getNMList()
                 throws RemoteException

Specified by:

getNMList in interface AdminServer

Throws:

RemoteException

getNM

public com.nt.udc.admin.NMItem getNM(String id)
                              throws RemoteException

Specified by:

getNM in interface AdminServer

Throws:

RemoteException

validateNMName

public void validateNMName(String inName)
                    throws NodeMgrAddException

Throws:

NodeMgrAddException

addNM

public void addNM(String inIPAddress,
 String inName,
 int inPort)
           throws NodeMgrAddException,
FileAccessException,
RemoteException

Specified by:

addNM in interface AdminServer

Throws:

NodeMgrAddException

FileAccessException

RemoteException

changeNM

public void changeNM(String inIPAddress,
 String inName,
 int inPort)
              throws RemoteException,
NodeMgrAddException

Specified by:

changeNM in interface AdminServer

Throws:

RemoteException

NodeMgrAddException

changeNM

public void changeNM(String id,
 String inName)
              throws RemoteException,
NodeMgrAddException

Specified by:

changeNM in interface AdminServer

Throws:

RemoteException

NodeMgrAddException

changeNM

public void changeNM(com.nt.udc.admin.NMItem nmItem,
 String inName)
              throws RemoteException,
NodeMgrAddException

Throws:

RemoteException

NodeMgrAddException

removeNM

public void removeNM(String inIPAddress,
 int inPort)
              throws FileAccessException,
NodeMgrRemoveException,
RemoteException

Specified by:

removeNM in interface AdminServer

Throws:

FileAccessException

NodeMgrRemoveException

RemoteException

removeNM

public void removeNM(String id)
              throws FileAccessException,
NodeMgrRemoveException,
RemoteException

Specified by:

removeNM in interface AdminServer

Throws:

FileAccessException

NodeMgrRemoveException

RemoteException

removeNM

public void removeNM(com.nt.udc.admin.NMItem nmItem)
              throws FileAccessException,
NodeMgrRemoveException,
RemoteException

Throws:

FileAccessException

NodeMgrRemoveException

RemoteException

getNodeList

public Vector getNodeList()
                   throws RemoteException

Returns a Vector of NodeInfo objects

Specified by:

getNodeList in interface AdminServer

Throws:

RemoteException

getNodeList

public Vector getNodeList(String inIPAddress,
 int inPort)
                   throws RemoteException

Specified by:

getNodeList in interface AdminServer

Throws:

RemoteException

getNodeItemList

public Vector getNodeItemList()
                       throws RemoteException

Returns a Vector of NodeItem objects

Specified by:

getNodeItemList in interface AdminServer

Throws:

RemoteException

addNode

public String addNode(String inIPAddress,
 int Port,
 com.nt.udc.admin.NodeInfo nodeInfo,
 boolean regNodeId)
               throws FileAccessException,
NodeAddException,
RemoteException

Specified by:

addNode in interface AdminServer

Throws:

FileAccessException

NodeAddException

RemoteException

addNode

public String addNode(String inIPAddress,
 int Port,
 com.nt.udc.admin.NodeInfo nodeInfo)
               throws FileAccessException,
NodeAddException,
RemoteException

Specified by:

addNode in interface AdminServer

Throws:

FileAccessException

NodeAddException

RemoteException

setImportExportProperty

public void setImportExportProperty(String[][] newNmMap)
                             throws RemoteException

Specified by:

setImportExportProperty in interface AdminServer

Throws:

RemoteException

nplChanged

public boolean nplChanged(com.nt.udc.admin.NodeInfo nodeInfo)
                   throws RemoteException

Always returns true.

Specified by:

nplChanged in interface AdminServer

Throws:

RemoteException

loadRuleClass

public boolean loadRuleClass(String className)

Attempts to load the given class name.

backUpNode

public void backUpNode(String nodeId)
                throws RemoteException

Specified by:

backUpNode in interface AdminServer

Throws:

RemoteException

removeNodes

public void removeNodes(Vector inNodeIds)
                 throws BulkOpException,
RemoteException

Specified by:

removeNodes in interface AdminServer

Throws:

BulkOpException

RemoteException

areNodesDeletable

public void areNodesDeletable(Vector nodeIds)
                       throws BulkOpException

Specified by:

areNodesDeletable in interface AdminServer

Throws:

BulkOpException

getOutputNodes

public Vector getOutputNodes(String inNodeId)
                      throws RemoteException,
NodeNotFoundException

Specified by:

getOutputNodes in interface AdminServer

Throws:

RemoteException

NodeNotFoundException

setOutputNodes

public void setOutputNodes(String inNodeId,
 Vector inNodeOutputs)
                    throws FileAccessException,
RemoteException,
NodeNotFoundException

Specified by:

setOutputNodes in interface AdminServer

Throws:

FileAccessException

RemoteException

NodeNotFoundException

removeOutputNodes

public void removeOutputNodes(String inNodeId,
 Vector inNodeOutputs)
                       throws RemoteException

Specified by:

removeOutputNodes in interface AdminServer

Throws:

RemoteException

getTemplateTree

public com.nt.udc.admin.TemplateTreeRoot getTemplateTree()

Specified by:

getTemplateTree in interface AdminServer

getTemplate

public com.nt.udc.admin.Template getTemplate(String templateId)

Specified by:

getTemplate in interface AdminServer

getTemplateDef

public TemplateDef getTemplateDef(String templateId)

isLicensed

public boolean isLicensed(String templateId)
                   throws RemoteException

Throws:

RemoteException

getLicensedSet

public Set getLicensedSet(Set allTemplates)
                   throws RemoteException

Specified by:

getLicensedSet in interface AdminServer

Throws:

RemoteException

getSiteInfo

public Map getSiteInfo()

Specified by:

getSiteInfo in interface AdminServer

getLicenses

public List getLicenses()

Specified by:

getLicenses in interface AdminServer

getRuleFileContent

public byte[] getRuleFileContent(com.nt.udc.admin.NodeInfo info,
 String inFileName)
                          throws RemoteException

Specified by:

getRuleFileContent in interface AdminServer

Throws:

RemoteException

updateRuleFileContent

public void updateRuleFileContent(com.nt.udc.admin.NodeInfo info,
 String inRuleFileDisplayName,
 String inRuleFileName,
 byte[] ruleFileContent)
                           throws RemoteException

Specified by:

updateRuleFileContent in interface AdminServer

Throws:

RemoteException

isSystemRuleFile

public boolean isSystemRuleFile(com.nt.udc.admin.NodeInfo info,
 String inFileName)
                         throws RemoteException

Specified by:

isSystemRuleFile in interface AdminServer

Throws:

RemoteException

deleteRuleFile

public boolean deleteRuleFile(com.nt.udc.admin.NodeInfo info,
 String inRuleFileDisplayName,
 String inFileName)
                       throws RemoteException

Specified by:

deleteRuleFile in interface AdminServer

Throws:

RemoteException

getInputFields

public ArrayList getInputFields(DCNodeTypeIfc inNodeType,
 String inRuleFileName)
                         throws RemoteException

Throws:

RemoteException

getOutputFields

public ArrayList getOutputFields(DCNodeTypeIfc inNodeType,
 String inRuleFileName)
                          throws RemoteException

Specified by:

getOutputFields in interface AdminServer

Throws:

RemoteException

getExposedFields

public ArrayList getExposedFields(DCNodeTypeIfc inNodeType,
 String inRuleFileName,
 String inReason)
                           throws RemoteException

Specified by:

getExposedFields in interface AdminServer

Throws:

RemoteException

getConfigValue

public String getConfigValue(DCNodeTypeIfc inNodeType,
 String inRuleFileName,
 String inKey)
                      throws RemoteException

Specified by:

getConfigValue in interface AdminServer

Throws:

RemoteException

copyNPL

public void copyNPL(DCNodeTypeIfc inNodeType,
 String inRuleFileName)
             throws RemoteException

Specified by:

copyNPL in interface AdminServer

Throws:

RemoteException

getASLog

public byte[] getASLog()
                throws FileAccessException,
RemoteException

Specified by:

getASLog in interface AdminServer

Throws:

FileAccessException

RemoteException

getNMLog

public byte[] getNMLog(String inIPAddress,
 int inPort)
                throws RemoteException

Specified by:

getNMLog in interface AdminServer

Throws:

RemoteException

getNodeLog

public byte[] getNodeLog(String inNodeId)
                  throws RemoteException

Specified by:

getNodeLog in interface AdminServer

Throws:

RemoteException

getStatus

public StatusMessage getStatus()

Specified by:

getStatus in interface AdminServer

startNodes

public void startNodes(Vector inNodeIds)
                throws BulkOpException,
RemoteException

Specified by:

startNodes in interface AdminServer

Throws:

BulkOpException

RemoteException

startNodesInternal

public void startNodesInternal(Vector inNodeIds)
                        throws BulkOpException,
RemoteException

Throws:

BulkOpException

RemoteException

stopNodes

public void stopNodes(Vector inNodeIds)
               throws BulkOpException,
RemoteException

Specified by:

stopNodes in interface AdminServer

Throws:

BulkOpException

RemoteException

stopNodesInternal

public void stopNodesInternal(Vector inNodeIds)
                       throws BulkOpException,
RemoteException

Throws:

BulkOpException

RemoteException

startAllNodes

public void startAllNodes(String inIPAddress,
 int inPort)
                   throws RemoteException

Specified by:

startAllNodes in interface AdminServer

Throws:

RemoteException

stopAllNodes

public void stopAllNodes(String inIPAddress,
 int inPort)
                  throws RemoteException

Specified by:

stopAllNodes in interface AdminServer

Throws:

RemoteException

getCurrentPerformanceMetrics

public Vector getCurrentPerformanceMetrics(String ip,
 int port)
                                    throws RemoteException

Specified by:

getCurrentPerformanceMetrics in interface AdminServer

Throws:

RemoteException

compileNPL

public void compileNPL(byte[] nplContent)
                throws RemoteException

This method takes nplContent as input and checks for any compilation errors

Specified by:

compileNPL in interface AdminServer

Parameters:

nplContent - content of the npl to be compiled

Throws:

RemoteException - in case of any error during the compilation

reloadNPL

public void reloadNPL(com.nt.udc.admin.NodeInfo nodeInfo)
               throws RemoteException

Specified by:

reloadNPL in interface AdminServer

Throws:

RemoteException

setNodeDescription

public void setNodeDescription(com.nt.udc.admin.NodeInfo nInfo)
                        throws RemoteException

Description copied from interface: AdminServer

Replaces the NodeInfo object with nodeInfo for the given Node contained in nodeInfo. This only updates the NodeInfo object in the table and does not save the node's configuration file(s), or cause node reconfiguration.

Specified by:

setNodeDescription in interface AdminServer

Parameters:

nInfo - NodeInfo object for node.

Throws:

RemoteException

setNodeInfo

public void setNodeInfo(com.nt.udc.admin.NodeInfo nodeInfo)
                 throws RemoteException

Locates the reference to nodeManager for the given nodeId, and invokes the setNodeInfo() method of the nodeManager located, with the given nodeInfo.

Specified by:

setNodeInfo in interface AdminServer

Throws:

RemoteException

reMapWalletPassword

public boolean reMapWalletPassword(String nodeId,
 List<int[]> indicesList)
                            throws RemoteException

This method is used to map wallet passwords from old index to new index.

Specified by:

reMapWalletPassword in interface AdminServer

Parameters:

nodeId - Node's identifier

indicesList - List of int array, where each int array will have 2 indices, 0th index denotes old row index,and 1st index denotes new row index

Throws:

RemoteException - RemoteException

getNodeInfo

public com.nt.udc.admin.NodeInfo getNodeInfo(String inNodeId)
                                      throws RemoteException

Specified by:

getNodeInfo in interface AdminServer

Throws:

RemoteException

clearNMAlarm

public void clearNMAlarm(String inIPAddress,
 int inPort)
                  throws RemoteException

Specified by:

clearNMAlarm in interface AdminServer

Throws:

RemoteException

clearNodeAlarm

public void clearNodeAlarm(String nodeId)
                    throws RemoteException

Specified by:

clearNodeAlarm in interface AdminServer

Throws:

RemoteException

refreshStatuses

public void refreshStatuses()
                     throws RemoteException

Specified by:

refreshStatuses in interface AdminServer

Throws:

RemoteException

getVersionInfo

public VersionInfo getVersionInfo()
                           throws RemoteException

Specified by:

getVersionInfo in interface AdminServer

Throws:

RemoteException

getCartridgeVersionInfo

public Map getCartridgeVersionInfo(String ip,
 int port)
                            throws RemoteException

Specified by:

getCartridgeVersionInfo in interface AdminServer

Throws:

RemoteException

getNMVersionInfo

public VersionInfo getNMVersionInfo(String ip,
 int port)
                             throws RemoteException

Specified by:

getNMVersionInfo in interface AdminServer

Throws:

RemoteException

login

public String login(com.nt.udc.admin.User user)
             throws RemoteException,
AuthenticationException

Description copied from interface: AdminServer

Authenticates the given user

Specified by:

login in interface AdminServer

Throws:

RemoteException

AuthenticationException

logout

public void logout(com.nt.udc.admin.User user)
            throws RemoteException

Description copied from interface: AdminServer

Removes the userId from the AS's current list of users

Specified by:

logout in interface AdminServer

Throws:

RemoteException

hasAdminPriv

public boolean hasAdminPriv(com.nt.udc.admin.User user)
                     throws RemoteException,
AuthenticationException

Description copied from interface: AdminServer

Indicates whether the given User has Administrative privileges for this Admin Server

Specified by:

hasAdminPriv in interface AdminServer

Throws:

RemoteException

AuthenticationException

getRole

public int getRole(com.nt.udc.admin.User user,
 com.nt.udc.admin.User authUser)
            throws AuthenticationException

Description copied from interface: AdminServer

Returns the role of the user passed as argument

Specified by:

getRole in interface AdminServer

Throws:

AuthenticationException

getUserList

public Vector getUserList(com.nt.udc.admin.User authUser)
                   throws RemoteException,
AuthenticationException

Description copied from interface: AdminServer

Retrieves the list of users that may access this Admin Server

Specified by:

getUserList in interface AdminServer

Returns:

Vector of User objects

Throws:

RemoteException

AuthenticationException

getRoleFromDN

public String getRoleFromDN(String dnName)

addUser

public void addUser(com.nt.udc.admin.User userToAdd,
 com.nt.udc.admin.User authUser)
             throws AuthenticationException,
RemoteException

Description copied from interface: AdminServer

Attempts to add userToAdd to the list of users for this Admin Server.

Specified by:

addUser in interface AdminServer

Throws:

AuthenticationException - if authUser does not have Administrative privileges

RemoteException

modifyUser

public void modifyUser(com.nt.udc.admin.User userToAdd,
 com.nt.udc.admin.User authUser,
 Boolean changePassword)
                throws AuthenticationException,
RemoteException

Description copied from interface: AdminServer

Attempts to modify attributes for userToMod

Specified by:

modifyUser in interface AdminServer

Throws:

AuthenticationException - if authUser does not have Administrative privileges for userToMod

RemoteException

removeUsers

public void removeUsers(Vector userList,
 com.nt.udc.admin.User authUser)
                 throws AuthenticationException,
RemoteException

Description copied from interface: AdminServer

Attempts to remove the Users contained in userList from the list of users for this Admin Server.

Specified by:

removeUsers in interface AdminServer

Parameters:

userList - Vector of User objects

Throws:

AuthenticationException - if authUser does not have Administrative privileges

RemoteException

getDSHost

public String getDSHost()
                 throws RemoteException

Returns the Host name of the Data Server.

Specified by:

getDSHost in interface AdminServer

Throws:

RemoteException

getDSPort

public String getDSPort()
                 throws RemoteException

Returns the Port of the Data Server.

Specified by:

getDSPort in interface AdminServer

Throws:

RemoteException

getLdapURL

public static String getLdapURL()

Returns the URL of the LDAP directory that this AdminServer is using for user authentication.

setLdapURL

public static void setLdapURL(String newURL)

Sets the URL of the LDAP directory that this AdminServer is using for user authentication.

getAdminDN

public static String getAdminDN()

Returns the LDAP DN for the Admin user of the system.

setAdminDN

public static void setAdminDN(String newDN)

Sets the LDAP DN for the Admin user of the system.

getDomain

public static String getDomain()

Returns the LDAP domain currently being used by the system.

setDomain

public static void setDomain(String newDomain)

Sets the LDAP domain to be used by the system.

getGroupInfo

public static String getGroupInfo()

Returns the LDAP group which indicates the group that users belong to in the directory.

setGroupInfo

public static void setGroupInfo(String newGroup)

Sets the LDAP group which indicates the group that users should belong to in the directory.

getMemberInfo

public static String getMemberInfo()

setMemberInfo

public static void setMemberInfo(String info)

getTimeoutValue

public static long getTimeoutValue()

setTimeoutValue

public static void setTimeoutValue(long value)

nodeManagersAdded

public void nodeManagersAdded(Vector nmList)
                       throws RemoteException

Description copied from interface: AcctEventListener

Indicates that one or more NodeManagers were added. The Vector associated with each NMItem object will represent all the nodes that are being managed by that Node Manager.

Specified by:

nodeManagersAdded in interface AcctEventListener

Throws:

RemoteException

nodeManagersRemoved

public void nodeManagersRemoved(Vector nmList)
                         throws RemoteException

Description copied from interface: AcctEventListener

Indicates that one or more NodeManagers were removed.

Specified by:

nodeManagersRemoved in interface AcctEventListener

Parameters:

nmList - Vector of NMItem objects representing the Node Managers that were removed.

Throws:

RemoteException

nodeManagerChanged

public void nodeManagerChanged(com.nt.udc.admin.NMItem nmItem)
                        throws RemoteException

Description copied from interface: AcctEventListener

Indicates that the properties of a Node Manager have changed.

Specified by:

nodeManagerChanged in interface AcctEventListener

Parameters:

nmItem - NMItem object representing the Node Manager that changed.

Throws:

RemoteException

nodesAdded

public void nodesAdded(com.nt.udc.admin.NMItem nmItem)
                throws RemoteException

Description copied from interface: AcctEventListener

Indicates that a Node has been added to a particular Node Manager.

Specified by:

nodesAdded in interface AcctEventListener

Parameters:

nmItem - NMItem object which represents the Node Manager managing the node that was added. The Vector associated with nodeManager will contain only the node that was added.

Throws:

RemoteException

nodesRemoved

public void nodesRemoved(com.nt.udc.admin.NMItem nmItem)
                  throws RemoteException

Description copied from interface: AcctEventListener

Indicates that a Node has been removed from a particular Node Manager.

Specified by:

nodesRemoved in interface AcctEventListener

Parameters:

nmItem - NMItem object which represents the Node Manager managing the node that was removed. The Vector associated with nodeManager will contain only the node(s) that was(were) removed.

Throws:

RemoteException

nodeChanged

public void nodeChanged(com.nt.udc.admin.NMItem nmItem)
                 throws RemoteException

Description copied from interface: AcctEventListener

Indicates that the properties of a Node have changed.

Specified by:

nodeChanged in interface AcctEventListener

Parameters:

nmItem - NMItem object which represents the Node Manager whose node changed. The Vector associated with nodeManager will contain the node that changed.

Throws:

RemoteException

nodePerformanceUpdate

public void nodePerformanceUpdate(Vector perfs)

Description copied from interface: AcctEventListener

Indicates that node performance information was updated.

Specified by:

nodePerformanceUpdate in interface AcctEventListener

Parameters:

perfs - Vector of node performance objects

fileChanged

public void fileChanged(com.nt.udc.admin.FileItem file)
                 throws RemoteException

Description copied from interface: AcctEventListener

Indicates that a system file changed.

Specified by:

fileChanged in interface AcctEventListener

Parameters:

file - FileItem object representing the system file that changed.

Throws:

RemoteException

adminServerChanged

public void adminServerChanged(StatusMessage sm)
                        throws RemoteException

Description copied from interface: AcctEventListener

Indicates that the properties of an Admin Server have changed.

Specified by:

adminServerChanged in interface AcctEventListener

Parameters:

sm - StatusMessage object representing the change in the AdminServer.

Throws:

RemoteException

systemUpdate

public void systemUpdate(SystemModel model)
                  throws RemoteException

Description copied from interface: AcctEventListener

Indicates that the system has substantially changed.

Specified by:

systemUpdate in interface AcctEventListener

Parameters:

model - SystemModel representing the current state of the system.

Throws:

RemoteException

setRefreshInterval

public void setRefreshInterval(long inRefInt)
                        throws RemoteException

Specified by:

setRefreshInterval in interface AdminServer

Throws:

RemoteException

initRegistry

public void initRegistry(int rmiPort,
 int aPIMetaFactoryRMIPortNo)

getTrapHostList

public com.nt.udc.admin.TrapHostList getTrapHostList()
                                              throws RemoteException

Description copied from interface: AdminServer

Gets list of known SNMP Trap Hosts

Specified by:

getTrapHostList in interface AdminServer

Throws:

RemoteException

addTrapHost

public void addTrapHost(com.nt.udc.admin.TrapHost host)
                 throws RemoteException

Description copied from interface: AdminServer

Adds a new host to the list of SNMP Trap Hosts

Specified by:

addTrapHost in interface AdminServer

Throws:

RemoteException

addTrapHostList

protected void addTrapHostList(com.nt.udc.admin.TrapHostList hosts,
 String nmIP,
 int nmPort)

This is a method used by the AdminServerImple to push a complete TrapHostList down to a specific Node Hosts that it is managing.

removeTrapHost

public void removeTrapHost(com.nt.udc.admin.TrapHost host)
                    throws RemoteException

Description copied from interface: AdminServer

Removes a host from the list of SNMP Trap Hosts

Specified by:

removeTrapHost in interface AdminServer

Throws:

RemoteException

removeTrapHosts

public void removeTrapHosts(Vector hosts)
                     throws RemoteException

Description copied from interface: AdminServer

Removes a list of hosts from the SNMP Trap Hosts object

Specified by:

removeTrapHosts in interface AdminServer

Throws:

RemoteException

modifyTrapHost

public void modifyTrapHost(com.nt.udc.admin.TrapHost oldhost,
 com.nt.udc.admin.TrapHost newhost)
                    throws RemoteException

Description copied from interface: AdminServer

Modifies a host in the list of SNMP Trap Hosts

Specified by:

modifyTrapHost in interface AdminServer

Throws:

RemoteException

pollRecordCounts

public void pollRecordCounts()

getConfig

public Config getConfig()

getASConfig

public Hashtable getASConfig()
                      throws RemoteException

Description copied from interface: AdminServer

Gets the Admin Server Config object (really just a Hashtable).

Specified by:

getASConfig in interface AdminServer

Throws:

RemoteException

setASConfig

public void setASConfig(Hashtable asConfig)
                 throws RemoteException

Description copied from interface: AdminServer

Sets the Admin Server Config object. All original attributes should be present, even if they haven't been changed.

Specified by:

setASConfig in interface AdminServer

Throws:

RemoteException

exportWithCustomization

public byte[] exportWithCustomization(Vector nmListToExport,
 String exportName)
                               throws RemoteException

Returns a byte array of Customization content which includes 1. archives of cartridges and customization folder from all running nodemanagers 2. archive of cartridges and customization folder of admin server 3. VersionInfo.xml which contains version information 4. Configuration xml 5. Export Log.

Specified by:

exportWithCustomization in interface AdminServer

Parameters:

nmListToExport - list of node managers for which export should be done.

exportName - exportName is the file name used for writing configuration xml

Returns:

byte[] the content of complete archive will be returned as a byte array.

Throws:

RemoteException

exportWithCustomization

public byte[] exportWithCustomization(Vector nmList,
 Vector nodesToExport,
 String exportName)
                               throws RemoteException

Specified by:

exportWithCustomization in interface AdminServer

Throws:

RemoteException

getImportCustomLog

public String getImportCustomLog()

The import customization log will be returned.

Specified by:

getImportCustomLog in interface AdminServer

Returns:

String the contents of import customization log buffer will returned as a String.

importCustomization

public boolean importCustomization(ArrayList nmMaps,
 byte[] contents)

This method receives the content of nmx file from admin client and extracts customization archives of individual node managers and distributes them to appropriate node managers based on node manager map.

Specified by:

importCustomization in interface AdminServer

Parameters:

nmMaps - contains mapping information from old node manager ip:port to new node manager ip:port

contents - the contents of nmx file as byte array.

Returns:

boolean returns true if the entire operation is successful. otherwise returns false.

getAuthUsers

public boolean getAuthUsers()
                     throws RemoteException

returns true if authentication is enabled

Specified by:

getAuthUsers in interface AdminServer

Returns:

Throws:

RemoteException

integrateRoutingCCNMScaleUp

public void integrateRoutingCCNMScaleUp(String ccHost,
 Integer ccPort)

Specified by:

integrateRoutingCCNMScaleUp in interface AdminServer

getDestNodesInNM

public Vector getDestNodesInNM(String srcNode,
 String host,
 Integer port)

Specified by:

getDestNodesInNM in interface AdminServer

clearNodeIdCorrelationsMap

public void clearNodeIdCorrelationsMap()

Specified by:

clearNodeIdCorrelationsMap in interface AdminServer

integrateRouting

public void integrateRouting(String epdcHost,
 Integer epdcPort)

Specified by:

integrateRouting in interface AdminServer

changeRoutingToRR

public void changeRoutingToRR(String sourceNodeId,
 String destNodeId)

Specified by:

changeRoutingToRR in interface AdminServer

integrateScalingDownForNonSegregatedNM

public void integrateScalingDownForNonSegregatedNM(String list)

Specified by:

integrateScalingDownForNonSegregatedNM in interface AdminServer

integrateScalingDownForSegregatedNM

public void integrateScalingDownForSegregatedNM(String list)

Specified by:

integrateScalingDownForSegregatedNM in interface AdminServer

removeRRNodeDestination

public void removeRRNodeDestination(String destNodeId)

addRRNodeDestination

public void addRRNodeDestination(String sourceNodeId,
 String destNodeId)

Specified by:

addRRNodeDestination in interface AdminServer

removeRoute

public String removeRoute(String sourceNodeId,
 String destNodeId)
                   throws RemoteException

Specified by:

removeRoute in interface AdminServer

Parameters:

sourceNodeId - The sourceNodeID

destNodeId - The destNodeId

Throws:

RemoteException

updateRoute

public String updateRoute(String sourceNodeId,
 String destNodeId,
 String routeFunction)
                   throws RemoteException

Specified by:

updateRoute in interface AdminServer

Parameters:

sourceNodeId - The sourceNodeID

destNodeId - The sourceNodeID

routeFunction - The routingFunction to use, this function just accepts Round Robin and Multicast

Throws:

RemoteException

updateRoute

public String updateRoute(String sourceNodeId,
 String destNodeId,
 String routeFunction,
 String rField,
 Vector rCondition)
                   throws RemoteException

Specified by:

updateRoute in interface AdminServer

Parameters:

sourceNodeId - The sourceNodeID

destNodeId - The sourceNodeID

routeFunction - The routingFunction to use, this function should be used only for Directed and Modulus

rField - The routing attribute that should be used (must be present in NPL)

rCondition - For Directed routing, this must be a vector of invalid input: '<'operator,operand1,operands2> where operands1 and operands2 are comma seperated string. Operand2 can be empty string if operator just requres one operand.

Throws:

RemoteException

updateRouteParameters

public String updateRouteParameters(String sourceNodeId,
 String destNodeId,
 String rField,
 Vector rCondition)
                             throws RemoteException

Specified by:

updateRouteParameters in interface AdminServer

Parameters:

sourceNodeId - The sourceNodeID

destNodeId - The sourceNodeID

rField - The routing attribute that should be used (must be present in NPL)

rCondition - For Directed routing, this must be a vector of invalid input: '<'operator,operand1,operands2> where operands1 and operands2 are comma seperated string. Operand2 can be empty string if operator just requres one operand.

Throws:

RemoteException

addRoute

public String addRoute(String sourceNodeId,
 String destNodeId,
 String routeFunction)
                throws RemoteException

Specified by:

addRoute in interface AdminServer

Parameters:

sourceNodeId - The sourceNodeID

destNodeId - The sourceNodeID

routeFunction - The routingFunction to use, this function just accepts Round Robin and Multicast

Throws:

RemoteException

addRoute

public String addRoute(String sourceNodeId,
 String destNodeId,
 String routeFunction,
 String rField,
 Vector rCondition)
                throws RemoteException

Specified by:

addRoute in interface AdminServer

Parameters:

sourceNodeId - The sourceNodeID

destNodeId - The sourceNodeID

routeFunction - The routingFunction to use, this function should be used only for Directed and Modulus

rField - The routing attribute that should be used (must be present in NPL)

rCondition - For Directed routing, this must be a vector of invalid input: '<'operator,operand1,operands2> where operands1 and operands2 are comma seperated string. Operand2 can be empty string if operator just requres one operand.

Throws:

RemoteException

main

public static void main(String[] args)

getResetPwdInfo

public boolean getResetPwdInfo(com.nt.udc.admin.User user)
                        throws AuthenticationException,
RemoteException

This method receives the reset password information for given user

Specified by:

getResetPwdInfo in interface AdminServer

Parameters:

user - user information for which we want to get the information

Returns:

boolean returns true if the password is reset by Administrator. otherwise returns false.

Throws:

AuthenticationException

RemoteException

getSecondsToPasswordExpiration

public int getSecondsToPasswordExpiration(com.nt.udc.admin.User user)
                                   throws AuthenticationException,
RemoteException

This method receives the seconds for password expiration of given user

Specified by:

getSecondsToPasswordExpiration in interface AdminServer

Parameters:

user - user information for which we want to get the information

Returns:

boolean returns number of seconds until password expiration

Throws:

AuthenticationException

RemoteException

getTimeoutValueMiliSec

public long getTimeoutValueMiliSec()
                            throws RemoteException

returns the time out value for session expiry

Specified by:

getTimeoutValueMiliSec in interface AdminServer

Returns:

Throws:

RemoteException

setNoAuthentication

public static void setNoAuthentication()

this method is used for unit tests

performConfigAction

public void performConfigAction(ConfigActionIfc configActionObject,
 com.nt.udc.admin.NodeInfo nodeInfo)
                         throws RemoteException

Specified by:

performConfigAction in interface AdminServer

Throws:

RemoteException

performConfigAction

public void performConfigAction(ConfigActionIfc configActionObject,
 com.nt.udc.admin.NodeInfo nodeInfo,
 String ipAddr,
 int port)
                         throws RemoteException

Specified by:

performConfigAction in interface AdminServer

Throws:

RemoteException

getInputNodes

public Vector getInputNodes(String nodeId)
                     throws RemoteException

Specified by:

getInputNodes in interface AdminServer

Throws:

RemoteException

writeImportNodeCorrelationMap

public void writeImportNodeCorrelationMap(String parent,
 String replicated)
                                   throws RemoteException

Specified by:

writeImportNodeCorrelationMap in interface AdminServer

Throws:

RemoteException

validateNMForNodeTypes

public boolean validateNMForNodeTypes(String includeExclude,
 String majMin,
 String host,
 Integer port)

Specified by:

validateNMForNodeTypes in interface AdminServer

uploadNodeChainTestInputFile

public void uploadNodeChainTestInputFile(byte[] data,
 String nodeId,
 String fileName)
                                  throws RemoteException

This method backs up input directory for a node if backup flag is set to true, and uploads the input file to the upload location provided.

Specified by:

uploadNodeChainTestInputFile in interface AdminServer

Parameters:

data - File's data

nodeId - Node's identifier

fileName - File's name, prefixed with test ID.

Throws:

RemoteException - Exception thrown during a remote call

getNodeChainTestCfg

public NodeChainTestCfg getNodeChainTestCfg()

This method returns NodeChainTestCfg object.

Specified by:

getNodeChainTestCfg in interface AdminServer

getNMInvolvedInTestNodeChain

public Map<String,List<String>> getNMInvolvedInTestNodeChain(NodeChainTestCfgItemReadOnlyIfc testNodeChainConfig)

Retrieves a mapping of Node Managers involved in the test node chain. This method returns a Map where keys represent Node Manager identifiers, and values are Lists of nodeID associated with each Node Manager involved in the specified test node chain configuration.

Parameters:

testNodeChainConfig - The configuration item for the test node chain.

Returns:

A Map of Node Managers and associated nodeID participating in the test node chain.

getNodeContext

public String getNodeContext(String nodeId)

groupNodesBasedOnNM

public Map<String,ArrayList<String>> groupNodesBasedOnNM(ArrayList<String> nodesIds)

This function groups nodes managed by the same NM together.

Parameters:

nodeIds - List of identifiers of nodes spread accross 1 or more NMs

Returns:

Map containing node manager's identifier to list of identifiers of the nodes managed by that NM mapping

runNodeChainTest

public void runNodeChainTest(String uploadId,
 NodeChainTestCfgItem cfgItem)
                      throws RemoteException

This method writes test cfg item to nodeChainTest.cfg file and runs all the nodes which are part of node chain under test.

Specified by:

runNodeChainTest in interface AdminServer

Parameters:

uploadId - Upload ID of the file uploaded

cfgItem - NodeChainTestCfgItem object

Throws:

RemoteException - Exception thrown during a remote call

getDetailsAboutTest

public TNCDetails getDetailsAboutTest(String testId)
                               throws RemoteException

Retrieves details about a specific test. This method returns information about test and nodes in the test for the provided testId.

Specified by:

getDetailsAboutTest in interface AdminServer

Parameters:

testId - The unique identifier of the test for which details are to be retrieved.

Returns:

A TNCDetails object containing information about the specified test.

Throws:

RemoteException - If a communication-related issue occurs during the remote method invocation.

getOutputNodeChainTest

public List<NodeChainOutputRecords> getOutputNodeChainTest(String nodeId)
                                                    throws RemoteException

This method returns data from output file/s for a node, as part of Node Chain Test.

Specified by:

getOutputNodeChainTest in interface AdminServer

Parameters:

nodeId - Node's identifier

Throws:

RemoteException - Exception thrown during a remote call

completeNodeChainTest

public void completeNodeChainTest(String testId)
                           throws RemoteException

This method completes all the tasks required to conclude a Node Chain Test.

Specified by:

completeNodeChainTest in interface AdminServer

Parameters:

testId - Identifier of the test

Throws:

RemoteException - Exception thrown during a remote call

completeNodeChainTest

public void completeNodeChainTest(String testId,
 boolean isStale)

This method completes all the tasks required to conclude a Node Chain Test. This API is internally used, and should not be invoked by clients.

Parameters:

testId - Identifier of the test

isStale - True if test to be completed is in stale state, else false.

cleanOutputBackupNodeChainTest

public void cleanOutputBackupNodeChainTest(String testId)
                                    throws NodeChainTestException

This method cleans output backed up as part of a Node Chain Test.

Parameters:

testId - Identifier of the test

Throws:

NodeChainTestException - Exception thrown if something goes wrong while cleaning output backup

getSol42DescriptorFiles

public List<String> getSol42DescriptorFiles(String nmID)
                                     throws RemoteException

This method returns the list of names of available descriptor files.

Specified by:

getSol42DescriptorFiles in interface AdminServer

Parameters:

nmId - Node Manager idendifier

Throws:

RemoteException - Exception thrown during a remote call

getRuleFileDisplayName

public String getRuleFileDisplayName(String nodeContext,
 String ruleFileName)
                              throws RemoteException

This methods returns the ruleFileDisplayName for a given rule file.

Specified by:

getRuleFileDisplayName in interface AdminServer

Parameters:

nodeContext - The node context.

ruleFileName - The rule file name to retrieve the display name.

Returns:

The ruleFileDisplayName of the rule file.

Throws:

RemoteException - If an error occurs during the process.

extendTestTimeout

public boolean extendTestTimeout(String testId)
                          throws RemoteException

Extends the timeout duration for a test by the default timeout value, identified by the given testId.

Specified by:

extendTestTimeout in interface AdminServer

Parameters:

testId - The unique identifier of the test to extend the timeout. throws NodeChainTestException

Throws:

RemoteException

uploadImport

public ImportMetadata uploadImport(String configuration,
 byte[] customization)
                            throws ImportUploadException

Uploads an import with the provided configuration and customization data.

Specified by:

uploadImport in interface AdminServer

Parameters:

configuration - The configuration data for the import.

customization - The customization data for the import, provided as a byte array.

Returns:

The metadata generated for the uploaded import files.

Throws:

ImportUploadException - If an error occurs during the upload process.

updateImportMetadata

public ImportMetadata updateImportMetadata(String importId,
 ImportMetadata newMetadata)
                                    throws ImportMetadataUpdateException

Updates the metadata associated with a specific import.

Specified by:

updateImportMetadata in interface AdminServer

Parameters:

importId - The ID of the import whose metadata is to be updated.

newMetadata - The new metadata to be associated with the import.

Returns:

The updated metadata for the import.

Throws:

ImportMetadataUpdateException - If an error occurs while updating the import metadata.

getCurrentImport

public ImportLock getCurrentImport()
                            throws RemoteException

Retrieves the lock information for the current import, if any.

Specified by:

getCurrentImport in interface AdminServer

Returns:

The ImportLock object representing the lock information for the current import, or null if there is no current import lock.

Throws:

RemoteException - If an error occurs while fetching the current import lock.

runImport

public ImportTaskItem runImport(String importId)
                         throws ImportStartException,
ConcurrentImportException,
LongProcessInProgressException

Initiates the execution of an import operation with the specified import ID.

Specified by:

runImport in interface AdminServer

Parameters:

importId - The ID of the import operation to be initiated.

Returns:

A taskID, that can be used to track the progress of the import execution.

Throws:

ImportStartException - If an error occurs during the initiation of the import operation.

ConcurrentImportException - if another import is in progress

LongProcessInProgressException - If another long process in progress (Currently only TNC and import)

getImportTask

public ImportTaskProgressResponse getImportTask(String importId,
 String importTaskId)
                                         throws RemoteException

Retrieves information about a specific import task associated with the given import ID and task ID.

Specified by:

getImportTask in interface AdminServer

Parameters:

importId - The ID of the import operation.

importTaskId - The ID of the import task to retrieve.

Returns:

The ImportTaskItem representing information about the specified import task.

Throws:

RemoteException - If an error occurs during the retrieval of the import task.

ImportTaskNotFoundException - If the specified import task cannot be found.

getAllLockedAndRunningTestNodes

public Set<String> getAllLockedAndRunningTestNodes()
                                            throws RemoteException

Specified by:

getAllLockedAndRunningTestNodes in interface AdminServer

Throws:

RemoteException

isNodePartOfRunningTNC

public boolean isNodePartOfRunningTNC(String nodeId)
                               throws RemoteException

This method validates whether a node is under test or not.

Specified by:

isNodePartOfRunningTNC in interface AdminServer

Parameters:

nodeId - The ID of the node.

Throws:

RemoteException - If an error occurs during the validation for node under test or not.

getAllLockedAndRunningTestNodesSharingRuleFile

public Set<String> getAllLockedAndRunningTestNodesSharingRuleFile(com.nt.udc.admin.NodeInfo info,
 String inRuleFileDisplayName)
                                                           throws RemoteException

This method return Set of nodeIds which are using same RuleFile which are under Test.

Parameters:

info - NodeInfo object

inRuleFileDisplayName - ruleFileDisplay name to match

Returns:

It returns Set of nodeIds which are under test and belongs to same marketSegment and uses same rulefile

Throws:

RemoteException - If an error occurs during the validation for node under test or not.

replicateNode

public String replicateNode(String sourceNodeId,
 String destNodeManagerId)
                     throws RemoteException

Replicates a node to with the given nodeId to a destination node manager.

Specified by:

replicateNode in interface AdminServer

Parameters:

sourceNodeId - the ID of the source node to be replicated

destNodeManagerId - the ID of the destination node manager where the node will be replicated

Returns:

Node ID of the replicated node

Throws:

RemoteException - if a remote communication error occurs during the replication

replicateNodeManager

public boolean replicateNodeManager(NodeManagerReplicateRequest request)
                             throws RemoteException

Replicates the node manager based on the provided request.

Specified by:

replicateNodeManager in interface AdminServer

Parameters:

request - the request object containing the details for the node manager replication

Returns:

true if the replication was successful, false otherwise

Throws:

RemoteException - if any exception occurs during the replication

isReceiverValid

public boolean isReceiverValid(String reciverId)
                        throws RemoteException

Specified by:

isReceiverValid in interface AdminServer

Throws:

RemoteException

scaleDownNodeManager

public boolean scaleDownNodeManager(String nmId,
 boolean isPreBackupCleanup)
                             throws RemoteException

scaleDown node manager based on the provided flag.

Specified by:

scaleDownNodeManager in interface AdminServer

Parameters:

nmId - - NodeManager Id

isPreBackupCleanup - - if true then all the preBackUp tasks will be done

Returns:

true if the scaleDown was successful, false otherwise

Throws:

RemoteException - if any exception occurs during the scaleDown