02/28/2005
 

com.epicentric.common
Class Installation

java.lang.Object
  |
  +--com.epicentric.common.Installation

Deprecated. as of 7.2, to be removed in 9.0. Partial replacement via PortalEnvironment. Most of the information in this class is used for internal portal functions and there is little known reason why customers would need this information. If there are needs identified, they will be added to the PortalEnvironment class.

public final class Installation
extends Object

Vignette Portal installation information. This class uses public static variables to store installation information


Field Summary
static File bootstrap_dir
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static File install_dir
          Deprecated. as of 7.2, to be removed in 9.0. Replaced by PortalEnvironment.getInstallDir().
static String java_version
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static File logs_dir
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static boolean ms_java
          Deprecated. as of version 3.5. To be removed in 8.0 or later
static int PASSWORD_ENCRYPTION_METHOD_BASE64
          Deprecated. as of 3.0, to be removed in 8.0 or later. As of Vignette Portal 3.0 the password encryption in the database is always done as MD5.
static int PASSWORD_ENCRYPTION_METHOD_MD5
          Deprecated. as of 3.0, to be removed in 8.0 or later. As of Vignette Portal 3.0 the password encryption in the database is always done as MD5.
static int PASSWORD_ENCRYPTION_METHOD_NONE
          Deprecated. as of 3.0, to be removed in 8.0 or later. As of Vignette Portal 3.0 the password encryption in the database is always done as MD5.
static String PRODUCT_PROPERTY
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static String PRODUCT_VAP
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static File properties_dir
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static String SERIAL_NUMBER_FILE
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static File system_dir
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static String VERSION_FILE
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
 
Constructor Summary
Installation()
          Deprecated.  
 
Method Summary
static String cleanPath(String path)
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static int getBuildNumber()
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static int getBuildNumber(String vfnLocation)
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static String getDefaultSchemaFilename()
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static com.epicentric.sql.schema.Schema getDefaultSchemaFromFile()
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static File getInstallDir()
          Deprecated. as of 7.2, to be removed in 9.0. Replaced by PortalEnvironment.getInstallDir().
static String getInstanceGUID()
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static Date getLastUpgradeDate()
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static Date getOriginalInstallationDate()
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static int getPasswordEncryptionVersion()
          Deprecated. as of 3.0, to be removed in 8.0 or later. As of Vignette Portal 3.0 the password encryption in the database is always done as MD5. Vignette only supports upgrades from 2 major previous version, therefore by version 3.5 all databases should be using the same (MD5) type of encryption and no more upgrades will be necessary.
static Date getSchemaDate()
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static String getSchemaVersion()
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static String getSerialNumber()
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static String getVersion()
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static String getVersion(String vfnLoc)
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static String getVersionOnly()
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static String getVersionOnly(String vfnLocation)
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static void main(String[] args)
          Deprecated. Print the build number to the command line.
static void readVfn()
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
static void readVfn(String vfnLocation)
          Deprecated. as of 7.2, to be removed in 9.0. No replacement.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

VERSION_FILE

public static final String VERSION_FILE
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

the version file name

SERIAL_NUMBER_FILE

public static final String SERIAL_NUMBER_FILE
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

the serial number file name

install_dir

public static File install_dir
Deprecated. as of 7.2, to be removed in 9.0. Replaced by PortalEnvironment.getInstallDir().

Member designates the installation folder for this installation.

logs_dir

public static File logs_dir
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Member designates the logs folder for this installation. Can be overridden in properties.txt.

properties_dir

public static File properties_dir
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Member designates the properties folder for this installation. This is also known as the config folder.

system_dir

public static File system_dir
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Member designates the system folder for this installation.

bootstrap_dir

public static File bootstrap_dir
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Member designates the bootstrap folder for this installation.
Since:
4.0

PASSWORD_ENCRYPTION_METHOD_NONE

public static final int PASSWORD_ENCRYPTION_METHOD_NONE
Deprecated. as of 3.0, to be removed in 8.0 or later. As of Vignette Portal 3.0 the password encryption in the database is always done as MD5.


PASSWORD_ENCRYPTION_METHOD_BASE64

public static final int PASSWORD_ENCRYPTION_METHOD_BASE64
Deprecated. as of 3.0, to be removed in 8.0 or later. As of Vignette Portal 3.0 the password encryption in the database is always done as MD5.


PASSWORD_ENCRYPTION_METHOD_MD5

public static final int PASSWORD_ENCRYPTION_METHOD_MD5
Deprecated. as of 3.0, to be removed in 8.0 or later. As of Vignette Portal 3.0 the password encryption in the database is always done as MD5.


ms_java

public static boolean ms_java
Deprecated. as of version 3.5. To be removed in 8.0 or later

Member designates if a MS Virtual Machine is in use.

java_version

public static String java_version
Deprecated. as of 7.2, to be removed in 9.0. No replacement.


PRODUCT_PROPERTY

public static final String PRODUCT_PROPERTY
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

constants for identifying the product that is currently running

PRODUCT_VAP

public static final String PRODUCT_VAP
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Constructor Detail

Installation

public Installation()
Deprecated. 
Method Detail

cleanPath

public static String cleanPath(String path)
Deprecated. as of 7.2, to be removed in 9.0. No replacement.


getVersion

public static String getVersion(String vfnLoc)
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Friendly display of Vignette software's version. This method will compare the information stored in the vfn.dat with the information stored in the vignette.jar. If the content is in synch the ouput will look like: Vignette Portal (TM): 4.0 (build 44) If the build number contained in the vignette.jar is different than the one contained in vfn.dat it means that a patch has been installed and the output will look like: Vignette Portal (TM): 4.0 (build 44) (EFIX 46) The last possible scenario is that the version of the software is also different, the output will then be in this format: Vignette Portal (TM): 4.0 (build 44) (4.0 SP1 build 46)

getVersion

public static String getVersion()
Deprecated. as of 7.2, to be removed in 9.0. No replacement.


getVersionOnly

public static String getVersionOnly()
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Version of the Vignette software. Later version always compare greater than earlier ones.

getVersionOnly

public static String getVersionOnly(String vfnLocation)
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Version of the Vignette software. Later version always compare greater than earlier ones.

getSerialNumber

public static String getSerialNumber()
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Friendly way to get the System Serial Number
Returns:
Vignette Portal installation's serial number as String

getInstallDir

public static File getInstallDir()
Deprecated. as of 7.2, to be removed in 9.0. Replaced by PortalEnvironment.getInstallDir().

Return the Vignette Portal install directory (e.g., c:\Vignette\Portal).

getBuildNumber

public static int getBuildNumber()
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Build number of the Vignette software. Later builds always compare greater than earlier ones.

getBuildNumber

public static int getBuildNumber(String vfnLocation)
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Build number of the Vignette software. Later builds always compare greater than earlier ones.

readVfn

public static void readVfn()
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Read the vfn.dat file and parse it's content. The content of that file is only the version of the Vignette software and it's build number.

readVfn

public static void readVfn(String vfnLocation)
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Read the vfn.dat file from the given location and parse it's content. The content of that file is only the version of the Vignette software and it's build number.

getPasswordEncryptionVersion

public static int getPasswordEncryptionVersion()
Deprecated. as of 3.0, to be removed in 8.0 or later. As of Vignette Portal 3.0 the password encryption in the database is always done as MD5. Vignette only supports upgrades from 2 major previous version, therefore by version 3.5 all databases should be using the same (MD5) type of encryption and no more upgrades will be necessary.

The version of password encryption algorithm used by the installed Vignette Portal classes. Note that the databases may not actually be encrypted with this algorithm, because the databases could be around from a previous version.

main

public static void main(String[] args)
Deprecated. 
Print the build number to the command line. A diagnostic command.

getInstanceGUID

public static String getInstanceGUID()
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Get the Generic Unique IDentity for this instance of Vignette Portal. Restarting Vignette Portal will generate a new GUID.

getOriginalInstallationDate

public static Date getOriginalInstallationDate()
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Get the date of the first time that Vignette Portal is installed

getLastUpgradeDate

public static Date getLastUpgradeDate()
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Get the date of the last time that Vignette Portal is upgraded (version only, no builds)

getDefaultSchemaFilename

public static String getDefaultSchemaFilename()
Deprecated. as of 7.2, to be removed in 9.0. No replacement.


getDefaultSchemaFromFile

public static com.epicentric.sql.schema.Schema getDefaultSchemaFromFile()
                                                                 throws IOException
Deprecated. as of 7.2, to be removed in 9.0. No replacement.


getSchemaVersion

public static String getSchemaVersion()
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Returns the version of the schema in the database. It returns "0.0" if the schema is older than 3.0

getSchemaDate

public static Date getSchemaDate()
Deprecated. as of 7.2, to be removed in 9.0. No replacement.

Returns the last updated date of the schema in the database. If returns a null value if the schema is older than "4.0".

02/28/2005
 

Copyright and Trademark Notices