In this section: |
Before you install, review the requirements in the following topics.
The software is supported on most major platforms, including AIX, HP-UX, Linux, and Solaris. For current information about supported releases:
The Information Builders Technical Support home page opens.
The Supported Systems and Adapters page opens.
The Supported Systems and Adapters page for that release opens.
The support chart for that platform opens.
In general, the operating system should have the latest cumulative patch levels applied.
Confirm that your installation software is labeled for your operating system level.
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. Further Java Services debugging information about loading the JVM will be written to the server start log indicating JSCOM3 start failed as well as additional information that may be useful in resolving the problem. JSCOM3 is the actual process name for the Java Services Listener and the terms are often used interchangeably.
There are several ways to specify the JVM location:
export IBI_JNIPATH=/usr/jdk1.6.0_38/jre/lib/i386/server: /usr/jdk1.6.0_38/jre/lib/i386:$IBI_LIBPATH
export IBI_JNIPATH=/usr/jdk1.6.0_38/jre/lib/i386/server: /usr/jdk1.6.0_38/jre/lib/i386:$IBI_LIBPATH
To change or add operating system environment variables, set and export the variable in a .profile or script that always gets called during a server start. It is very common to place variables in the server edastart script, but it is recommended that they be placed in a script that in turn calls edastart (so that the edastart script remains vanilla).
To change or add a variable in a server environment start up file (EDACONF bin\edaenv.cfg), either edit the file in a text editor before starting the server or:
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. Variables are always uppercase.
To add classes to the JVM class path for customer-written CALLJAVA applications, set and export the CLASSPATH variable to 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, and the JVM environment is not configured, the message Failed to find JVM is normal and can be ignored.
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.
The server can send emails using STMP protocols. To use these features, the server needs the TCP/IP host name (or number) and port number for an accessible SMTP server (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).
The Web Console requires one of the following web browsers:
The following are approximate disk space requirements in megabytes. Specific sizes may vary slightly depending on the release being used and the options selected during configuration. The usage numbers do not include space for actual applications, databases, sort space, output preparation, or logs.
Platform |
After Installation - 32bit |
After Installation - 64bit |
---|---|---|
AIX |
Not supported |
900 Mb |
HP- UX PA-RISC |
1.2G |
1.1G |
HP-UX IA64 (Integrity) |
Not supported |
1.1G |
Linux for Intel/AMD |
800 Mb |
800 Mb |
Linux for pSeries |
Not supported |
900 Mb |
Linux for zSeries |
Not supported |
900 Mb |
Solaris Sparc |
900 Mb |
900 Mb - 1G (depends on OS level) |
Solaris x86 |
900 Mb |
900 Mb |
During installation, the disk space required is approximately 20 megabytes more than double the After Installation size. These numbers do not include space for applications. The ibisamp sample application requires an additional six megabytes.
Memory and shared memory usage depends on:
Memory usage differs depending on your implementation of UNIX and your server load.
The following table shows the approximate memory requirements for installing and running the server.
Platform |
Memory Per Agent |
Other Memory * |
---|---|---|
HP-UX |
1 Mb |
45 Mb |
AIX |
5 Mb |
50 Mb |
Solaris (Sparc) |
19 Mb |
125 Mb |
Solaris (Intel) |
10 Mb |
72 Mb |
Linux for Intel/AMD 32b |
7 Mb |
59 Mb |
Linux for Intel/AMD 64b |
9 Mb |
87 Mb |
Linux for pSeries 64b |
27 Mb |
165 Mb |
Linux for zSeries 64b |
10 Mb |
93 Mb |
Linux for zSeries 32b |
7.5 Mb |
72 Mb |
* Other memory includes memory used by the primary one-per-server daemon processes, such as the Workspace Manager, the print log, Deferred Listener, HTTP Listener, and TCP Listener.
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.
When installing and using the server, you need two types of operating system user IDs:
The operating system ID you use when installing the server owns the server files and is the default server administrator for OPSYS mode. You can create a new operating system ID to run and own the server files, or use any ordinary (non-superuser) ID. However, you should not install the server as root. The server administrator ID should have a Korn, Bourne, or Bash shell as the default logon shell.
Note that the name iadmin is used to refer to the server administrator ID and group throughout this manual, but you may use any name for this ID.
For security purposes, you should not allow users and applications to use the iadmin ID. It should be available only to users who require server administrative privileges.
iWay Software |