com.ibm.jsdt.support.installedproduct
Class IDSInstalledProduct

java.lang.Object
  extended by com.ibm.jsdt.support.installedproduct.InstalledProduct
      extended by com.ibm.jsdt.support.installedproduct.IDSInstalledProduct

Deprecated. Due to new package com.ibm.jsdt.support.deploymenthelper.installedproduct

public class IDSInstalledProduct
extends InstalledProduct

Handles pre-installation and post-installation activities for the Informix Dynamic Server (IDS).


Field Summary
static java.lang.String GROUP_ID
          Deprecated.  
static int SERVER_MODE_ONLINE
          Deprecated.  
static java.lang.String SERVERNUMBER
          Deprecated.  
static java.lang.String USER_ID
          Deprecated.  
 
Constructor Summary
protected IDSInstalledProduct(java.lang.String version, java.lang.String location)
          Deprecated. Constructs a new IDSInstalledProduct containing the version and the location of the installed product.
 
Method Summary
protected static java.lang.String determineIDSServerName(java.lang.String idsInstallLocation, SupportBase base)
          Deprecated. Gets IDS server name installed in a specified location.
protected static java.lang.String executeIDSCommand(java.lang.String commandToExecute, java.lang.String idsInstallLocation, java.lang.String idsServerName, SupportBase base)
          Deprecated. Exectute Informix Dynamic Server (IDS) command or utility.
static IDSInstalledProduct getInstalledProduct(java.lang.String location)
          Deprecated. Given a target location, handles the logic of finding an installed version of IDS.
static IDSInstalledProduct getInstalledProduct(SupportBase callerBase, java.lang.String location)
          Deprecated. Determines whether IDS is installed.
static IDSInstalledProduct[] getInstalledProducts()
          Deprecated. Determines all instances of IDS installed on the target computer.
static IDSInstalledProduct[] getInstalledProducts(SupportBase callerBase)
          Deprecated. Determines all instances of IDS installed on the target computer.
 java.lang.String getPortNumber(java.lang.String serverName)
          Deprecated. Get IDS port number associated with particular server instance Port numbers are stored in a services file on Windows.
 java.lang.String[] getServerNames()
          Deprecated. Gets the name of server instances in a particular INFORMIXDIR.
 java.lang.String getServerNumber(java.lang.String serverName)
          Deprecated. Get the server number associated with the provided server name.
 java.lang.String getServiceName(java.lang.String serverName)
          Deprecated. Get IDS Service name on Windows.
 java.lang.String getUniqueServerNumber()
          Deprecated. Get unique server number which is not in use by any IDS instance on a target system.
 boolean isServerNameUnique(java.lang.String serverName)
          Deprecated. This method checks whether the given server name is unique across the system.
 int startServer()
          Deprecated. Start the Informix Dynamic Server (IDS) demo server.
 int startServer(boolean initialize)
          Deprecated. Start/Initialize the Informix Dynamic Server (IDS)demo server.
 int stopServer()
          Deprecated. Stop the demo server Curreently the method is created for Linux only.
 int verifyIDSInstallation(java.lang.String serverName)
          Deprecated. Runs an install verification test provided by IDS using provided server instance.
 
Methods inherited from class com.ibm.jsdt.support.installedproduct.InstalledProduct
compareVersion, getActualSupportBase, getInstalledLocation, getInstalledProduct, getInstalledProducts, getInstalledVersion, getSupportBase, grepRPM, setInstalledLocation, setInstalledVersion, setSupportBase, trimVersionToNVersionPlaces
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

USER_ID

public static final java.lang.String USER_ID
Deprecated. 
See Also:
Constant Field Values

SERVER_MODE_ONLINE

public static final int SERVER_MODE_ONLINE
Deprecated. 
See Also:
Constant Field Values

GROUP_ID

public static final java.lang.String GROUP_ID
Deprecated. 
See Also:
Constant Field Values

SERVERNUMBER

public static final java.lang.String SERVERNUMBER
Deprecated. 
See Also:
Constant Field Values
Constructor Detail

IDSInstalledProduct

protected IDSInstalledProduct(java.lang.String version,
                              java.lang.String location)
Deprecated. 
Constructs a new IDSInstalledProduct containing the version and the location of the installed product.

Parameters:
version - The version of the installed product.
location - The location of the installed product.
Method Detail

getInstalledProduct

public static IDSInstalledProduct getInstalledProduct(java.lang.String location)
Deprecated. 
Given a target location, handles the logic of finding an installed version of IDS.

Parameters:
The - location of the installed product.
Returns:
Returns an instance of the installed product.

getInstalledProduct

public static IDSInstalledProduct getInstalledProduct(SupportBase callerBase,
                                                      java.lang.String location)
Deprecated. 
Determines whether IDS is installed. This method calls InstalledProduct object and passes the location and the created object of policy class implementor with the SupportBase object.

Parameters:
callerBase - SupportBase object to use.
location - The location of the installed product.
Returns:
Returns an instance of the installed product.

getInstalledProducts

public static IDSInstalledProduct[] getInstalledProducts()
Deprecated. 
Determines all instances of IDS installed on the target computer.

Returns:
Returns an instance of the installed product.

getInstalledProducts

public static IDSInstalledProduct[] getInstalledProducts(SupportBase callerBase)
Deprecated. 
Determines all instances of IDS installed on the target computer.

Parameters:
callerBase - SupportBase object to use.
Returns:
Returns an instance of the installed product.

getServerNames

public java.lang.String[] getServerNames()
Deprecated. 
Gets the name of server instances in a particular INFORMIXDIR.

Returns:
Server instances in a particular INFORMIXDIR, if none is found then null is returned.

isServerNameUnique

public boolean isServerNameUnique(java.lang.String serverName)
Deprecated. 
This method checks whether the given server name is unique across the system. The output of "onstat -g dis" command is checked to find out given server name in it, if server name not found that means given server is not already assigned to any IDS instances.

Parameters:
serverName -
Returns:
TRUE if provided server name is unique across the system FALSE otherwise

stopServer

public int stopServer()
Deprecated. 
Stop the demo server Curreently the method is created for Linux only.

Returns:
SUCCESS if server stopped successfully, FAILURE if server did not stop or if target system is non-Linux system

executeIDSCommand

protected static java.lang.String executeIDSCommand(java.lang.String commandToExecute,
                                                    java.lang.String idsInstallLocation,
                                                    java.lang.String idsServerName,
                                                    SupportBase base)
Deprecated. 
Exectute Informix Dynamic Server (IDS) command or utility. This method first sets IDS environment (i.e. INFORMIXDIR and IDS server in system environment) and then runs the specified command.

Parameters:
commandToExecute - IDS utility to run along with required options, such as "onstat -V"
idsInstallLocation - The IDS installation location.
idsServerName - The IDS server name.
base - SupportBase object to use.
Returns:
Output of the utility

determineIDSServerName

protected static java.lang.String determineIDSServerName(java.lang.String idsInstallLocation,
                                                         SupportBase base)
Deprecated. 
Gets IDS server name installed in a specified location. There is always a file named .cmd in the IDS installation location. This method looks for a file with .cmd suffix, parses the server name, and returns it.

Parameters:
idsInstallLocation - IDS installation location
base - SupportBase object to use.
Returns:
IDS server name if found, else returns null.

getUniqueServerNumber

public java.lang.String getUniqueServerNumber()
Deprecated. 
Get unique server number which is not in use by any IDS instance on a target system. the method first stores all existing server numbers into a hash table, and unique number, between 0 to 255, is returned as first entry found which is not in the hash tabel. Currently, this method is created for Windows only.

Returns:
SERVERNUM if no error encountered NULL otherwise

getServiceName

public java.lang.String getServiceName(java.lang.String serverName)
Deprecated. 
Get IDS Service name on Windows. The method gets service name from the registry. In the registry services name stores under SQLHOSTS sub key of Informix.

Parameters:
Server - name e.g. ol_server
Returns:
Service name, if found, for provided server name e.g. turbo NULL otherwise

getPortNumber

public java.lang.String getPortNumber(java.lang.String serverName)
Deprecated. 
Get IDS port number associated with particular server instance Port numbers are stored in a services file on Windows. e.g. C:\WINDOWS\system32\drivers\etc On Linux port number related to a IDS server installed in a particular location is stored in \etc\sqlhosts..

Parameters:
Server - name e.g. ol_server
Returns:
Port number if no error occur while retrieving port number NULL otherwise

verifyIDSInstallation

public int verifyIDSInstallation(java.lang.String serverName)
Deprecated. 
Runs an install verification test provided by IDS using provided server instance. Scans return code from the batch file to determine status of test.

Parameters:
server - name at particular install location
Returns:
SUCCESS if installation verified successfully, FAILURE otherwise

getServerNumber

public java.lang.String getServerNumber(java.lang.String serverName)
Deprecated. 
Get the server number associated with the provided server name. get the server number from the configuration file (ONCONFIG. in Windows and onconfig. in Linux) in a location of calling instance of IDS installed product.

Parameters:
server - name
Returns:
server number associated with provided server name empty string if provided server name does not exist null if any error occur while retrieving server number from config file

startServer

public int startServer()
Deprecated. 
Start the Informix Dynamic Server (IDS) demo server. Curreently the method is created for Linux only.

Returns:
SUCCESS if server started successfully, FAILURE if server did not start or if target system is a non-Linux system

startServer

public int startServer(boolean initialize)
Deprecated. 
Start/Initialize the Informix Dynamic Server (IDS)demo server. It is recommended that if you are installing IDS to overwrite previously installed version, you should not initialize the server. Initializing the server does both - start and initialize the server with the latest server configuration. Curreently the method is created for Linux only.

Returns:
SUCCESS if server started/initialized successfully, FAILURE if server did not start/initialize or if target system is non-Linux system