Installation Requirements

In this section:

Before you install the server, review the requirements in the following topics. Exact requirements vary according to your configuration and the number of users and deployed applications.


Top of page

x
Platform and Operating Environment Requirements

Processor. The server runs on all Intel® Pentium®-based computers 400 MHz and higher.

For security reasons as well as performance considerations, it is advisable not to run a server instance (or any of its components) on the primary domain controller (PDC) or on the backup domain controllers (BDC).

Supported Software Releases. The server is supported on most major releases of Microsoft Windows. For current information about supported releases:

  1. Go to http://techsupport.informationbuilders.com.

    The Information Builders Technical Support home page opens.

  2. In the Quick Links section on the right side of the page, click Supported Systems/Adapters.

    The Supported Systems and Adapters page opens.

  3. Click the link for the server release you want.

    The Supported Systems and Adapters page for that release opens.

  4. Click the link for your platform.

    The support chart for that platform opens.

In general, the operating system should have the latest cumulative patch levels applied.

Confirm that your server installation software is labeled for your operating system level.


Top of page

x
JVM Requirements for Java Services

If JVM-based adapters, server-side graphics, XBRL, or user-written CALLJAVA applications are to be used, a Java Runtime Environment (JRE) JVM must be installed on the machine, and the server must be configured to use it.

As of 7.7.05 and 8.0.01 production releases, the minimum JVM release level is 1.6 or higher, due to required internal components of the server. The Java Listener will not start unless 1.6 (or higher) is in use. Prior 7.x releases would allow the listener to start with any release, and sub-components would fail if they required a higher Java Level. The primary reason for this change is that Java 1.5 (and prior releases) are past their End of Service Life (EOSL) dates, and, as such, are unsupportable, in addition to lacking newer functionality. The following URL has Java EOL and EOSL information:

http://java.sun.com/products/archive/eol.policy.html

Installing maintenance updates to the EDAHOME of an existing server running releases prior to production 7.7.05 will also have the requirement of moving up all dependent configurations to use Java 1.6 (as instructed in this section).

You may install a Java JRE or a Java SDK. When you install a Java SDK, the JRE component (where the JVM lives) is included, so either is allowed. If using servlet, the Java SDK is required for the jar command, so it is generally preferred over the Java JRE. The SDK or JRE build type must also match the 32-bit or 64-bit bit type of the server. If an appropriate JVM from a JRE or SDK is not found on the library path or using variables as described below, or is not the appropriate bit type, a Failed to find JVM message will be displayed. Debugging information will be written to the start log indicating a failed JSCOM3 service.

There are several ways to specify the JVM location:

The IBI_JNIPATH variable may be set as a system-wide environment variable or as a server variable in the environment start-up file (edaenv.cfg). If using PATH, the JVM directory should be set as part of the system-wide PATH environment variable. The environment start-up file (edaenv.cfg) is not recommended for PATH, since it does not support %PATH% syntax. In addition, an expanded %PATH% string effectively locks PATH separately from any machine changes to %PATH%.

To change or add operating system environment variables, perform these steps:

  1. Right-click My Computer and select Properties.

    The System Properties window opens.

  2. Select the Advanced tab and click Environment Variables.

    The Environment Variables window opens.

  3. In the System variables list, select Path and click Edit or Add.

    The Edit System Variable window opens.

  4. Set or append the JRE bin and client subdirectories in the Variable Value field, and then click OK three times.

To change or add a variable in the server environment start up file (EDACONF bin\edaenv.cfg), either edit the file in a text editor before starting the server or:

  1. Start the server (services like Java Listener may fail until configured and the server is restarted).
  2. Open the Web Console and login using an administrator ID.
  3. Select Workspace from the main menu.
  4. In the navigation pane, open the Configuration Files and Miscellaneous folders.
  5. Right-click Environment - edaenv.cfg and select Edit.
  6. Make the desired edit.
  7. Save the file.
  8. Restart the server (changes are not effective until server is restarted).

The format of edaenv.cfg variables is one per line in name=value pairs. Spaces before and after the equal sign are optional. Values with embedded spaces do not require quoting.

To add classes to the JVM class path for customer-written CALLJAVA applications, set the CLASSPATH variable at the operating system level before server start-up or use the Web Console to set the Java Listener IBI_CLASSPATH property.

If JVM-based adapters or features are not required, the message Failed to find JVM is normal and can be ignored.


Top of page

x
IP Port Number Requirements

The install process prompts for two IP port numbers: the TCP Listener and HTTP Listener. It also uses the next two consecutive ports after the supplied HTTP Listener port for FDS use. This results in a total of four IP ports.

The supplied IP port numbers must be above the IANA registered well-known reserve range (numbers under 1024) and not over the maximum legal number (65535). Additionally, do not use IP port numbers already being used by other applications or products. Netstat, or netstat like commands, should reveal what actual ports are in use.


Top of page

x
SMTP E-Mail Server Information (Optional)

The server has outbound email features using STMP protocols. To use these features, the TCP/IP host name (or number) and port number for an accessible SMTP server must be configured (the default port number is 25). The installation process allows this information to be set at installation time, but it may also be added (or changed) afterward using the Web Console. To change it from the Web Console, select Workspace from the main menu, and then select E-Mail SMTP Server from the ribbon.

The installation panel for supplying the SMTP information will also have inputs for the default email sender address (the from address for users reading an email from the server if none was specified in the originating application) and the server administrator email address (the address to send administrative warnings to, such as an agent crash).



x
Browser Requirements

The Web Console server requires one of the following web browsers:

The Opera™ browser does not support RIA (Rich Internet Application), the default appearance mode of the 7.7.x Web Console. Opera 5.0 or higher seems to operate properly in HTML mode, and the Web Console detects this and switches to this mode automatically. Since HTML mode is less extensively tested, Opera is considered unofficially supported at this time. Please report any issues you find to customer service.


Top of page

x
Disk Space Requirements

The installation of the server requires 40MB of temporary disk space on your Windows %HOME% drive and approximately 1 GB of permanent disk space on the designated hard disk.


Top of page

x
Memory Requirements

Memory usage depends on the following elements:

The memory requirements for installation and operation of the server are:

These numbers apply when the server is in an idle state, so they may fluctuate slightly.


Top of page

x
Communications Requirements

You need four TCP/IP ports for each server instance that you configure. Three of these ports must be consecutive. You specify these port numbers during installation. You may require additional ports depending on which options you configure later.


Top of page

x
User ID Requirements

Depending on your security environment and company security policies, you need two types of Windows logon privileges:


Top of page

x
Choosing Between Interactive and Silent Installation

You can run the installation procedure in:


Top of page

x
Choosing Between Private and Shared Access to the Data Management Console

There are several tools available for administering the server:

You can install the server in a way that makes the Data Management Console available to remote users as a shared tool. You can choose between:


iWay Software