Ensure that you have the required hardware and software before proceeding with the Rose for UNIX/Linux installation.
Recommendation: Before installing Rose, you might find it helpful to get a copy of the system management guide from your platform vendor.
The following sections list the recommended configuration to successfully install and use Rose.
You do not need to log in as root to verify that most of these requirements are satisfied. If all are satisfied, you can proceed with the installation. If any are not satisfied, however, you probably will need help from your system administrator. Changing most of these items requires knowledge of your network and workstation configurations as well as root permissions.
Recommendation: Check all the items listed, noting any requirements that are not satisfied. Give the list of needed changes to your system administrator, wait for the changes to be made, and then proceed with the installation.
Table 1 contains the hardware requirements for installation and use of this product. Note that the recommended amount of memory is only the suggested minimum amount. Additional memory may improve performance. Your memory requirements will also be larger if you are constructing larger models.
Your hardware can be configured in various ways. For example:
This chapter describes the requirements for a single-user desktop workstation that you will use either stand-alone or with a file server that provides no support other than file service. The desktop workstation will run all Rose processes.
The alternative is to run all Rose processes on a remote compute server, redirecting the display to your local workstation or X-terminal. If the compute server is shared by several Rose users, it will need to be more powerful than a desktop workstation that supports only one Rose user.
Table 2 contains the software requirements for installation and use of this product. Note that this is also only a suggested amount of swap space. Your requirements may be larger if you expect to construct very large models. If all of your models are small, you may need less than the amount shown here.
It is unlikely you will need to reconfigure your system limits to use Rose for UNIX/Linux. The following information should only be utilized if your system resources appear to be used up when running Rose. The following is based on MainWin requirements for Sun Solaris. If you require system information for other supported architectures, contact Rational Technical Support.
The UNIX/Linux operating system maintains a configurable list of system resource limits. The ones relevant to this discussion are listed in the following table.
An application cannot consume more system resources than allowed for by the system limits. In most cases, when an application tries to consume more system resources than allowed, no system messages are generated to notify the user of the resource allocation failure.
In particular, there may be cases where Rose fails to execute correctly due to an attempt to use more system resources than allowed. For example, consider the application that opens many files. After the application has already opened the maximum number of files allowed, its attempt to open one more file will not succeed. The application may crash or may stop functioning properly.
The solution to the problem is to modify the system resource limits to suit the applications needs.
The rest of this section discusses some of the system resource limits that an application may exceed, and describes how to modify the appropriate system settings to enable the application to execute correctly.
Rose allocates a semaphore undo structure for each executing application. If a rehosted application fails to run concurrently with other instances of the application (or alongside any other rehosted application), it may be because this limit has been reached.
The number of semaphore undo structures permitted on the system should be greater than or equal to the maximum number of concurrent Rose processes that will ever run simultaneously. If you do not have any idea, start with 100.
Add the following line to the /etc/system file:
set semsys:seminfo_semmnu=###
Where ### is the maximum number of semaphore undo structures allowed on the system.
The default maximum number of open file descriptors allowed per process on Solaris is 64. If the application fails to open a file, it may be because it reached this limit.
To set maximum number of open file descriptors allowed per process, add the following line to the /etc/system file:
set rlim_fd_cur=###
Where ### is the maximum number of open file descriptors allowed per process.
If at any time you suspect that your application ran out of available ptys (virtual ttys), increase the maximum number of ptys allowed.
To set maximum number of ptys allowed, add the following line to the /etc/system file:
set pt_ctn=###
Where ### is the maximum number of ptys allowed on the system.
Rose uses shared memory. It may be that the shared memory settings are incorrect. Ensure that the maximum and minimum shared memory sizes are set as explained below.
Set the maximum size of a shared segment to at least 1,048,576 bytes (1 MB) or more.
To set maximum size of a shared memory segment to 1 megabyte, add the following line to the /etc/system file:
set semsys:seminfo_shmmax=1048576
Set the minimum size of a shared memory segment to be less than the maximum size, preferably 1 byte.
To set the minimum size of a shared memory segment, add the following line to the /etc/system file:
set semsys:seminfo_shmmin=1
Rose (through the use of MainWin) uses shared memory to hold internal information about threads, events, and other Windows resources. An application that is very demanding of such resources (for example, it is heavily multithreaded, or it creates and maintains a large number of events) may exhaust the available shared memory allocated to it by the operating system, resulting in application crash or unexpected behavior.
There are two system resource limits that should be set to help avoid the problem:
In order to set shmmni and shmseg we need to estimate the number of shared memory segments required by Rose at peak time, as described in the following procedure. Note that the result of this procedure is an estimate, and should be used with a safety factor.
m 0 0x500182c3 --rw-r--r-- root root
m 401 0x31004030 --rw-rw-r-- user1 group1
m 402 0x31004031 --rw-rw-r-- user1 group1
If shmmni is fractional, round it up to the next highest integer.
This concludes the procedure; you are now ready to set both the shmmni and shmseg limits.
Add the following line to the /etc/system file:
set shmsys:shminfo_shmmni=####
Where #### is the maximum number of shared memory segments system-wide that was calculated earlier in step 6.
You should set the value of shmseg - the maximum number of shared memory segments that a single process can attach to - to be equal to shmmni - the maximum number of shared memory segments system wide.
Add the following line to the /etc/system file:
set shmsys:shinfo_shmseg=####
Where #### is the value of shmmni, as calculated earlier in step 6.
The requirements below are in relation to the following platforms (operating system versions):
Please contact Rational Technical Support if you encounter any compatibility difficulties after installing a patch which supersedes the following patches.
The following table describes patch requirements for HP-UX 10.20 and 11.00.
1
See the following Note
|
It is important to use PHSS_23823 as Rose for UNIX/Linux will not start (display) if an earlier version of this patch is installed (i.e. PHSS_21493).
If it is necessary to have a Motif Xlib runtime patch prior to PHSS_23823 and you encounter this issue, refer to the following instructions to workaround this problem:
The HP-UX patches are available at:
The Solaris patches are available at:
The Sun Solaris patches may not be available publicly.
The following may be necessary in order to obtain some of the Solaris patches listed above:
How to detect a graphics card on a Sun Solaris computer:
/dev/fbs/m640 - PGX graphics card
/dev/fbs/afb* - Elite3D graphics card
/dev/fbs/ffb* - Creator/Creator3D graphics card
/dev/fbs/cgsix* - GX graphics card
/dev/fbs/leo* - ZX graphics card
/dev/fbs/sx* - SX graphics card
A user will encounter the following error if the appropriate Sun Solaris runtime patches are not installed:
ld.so.1: exe_name: fatal: libCrun.so.1: open failed: No such file or
directory
A CDE crash may occur when displaying Rose for UNIX/Linux on a Ultrabook using a PGX Graphics Card, if SUN Solaris patch 105362-26 is installed.
If using a PGX Graphics Card, we recommend that SUN Solaris patch 105362-20 be installed as this is the latest version tested and determined to be compatible with this release.
If you encounter the CDE crash, uninstall patch 105362-26 and if possible install "105362-20". If SUN Solaris patch "105362-20" is not installed, the following may occur:
If you uninstall patch 105362-26 and encounter any of the issues described above, contact Rational Technical Support if patch 105362-20 is not available.
If your client computer has the PGX32 add-on board (based on the Permedia 2 chip), you need to install the drivers and patches for this card. You cannot see the device in the /dev/fbs directory unless the drivers are installed.
Contact Rational Technical Support if you require information in relation to the SUN Solaris drivers or patches for the PGX32 add-on board.
Rose for UNIX/Linux requires the C++ run time library (libcxx) compatible with Compaq C++ for Tru64 Unix, Version 6.2. Rose for UNIX/Linux, therefore requires a newer version of the C++ run time library (libcxx) than is provided by Tru64 Unix versions prior to 5.1.
Either the subset "CXXREDIST620", or the C++ compiler kit (version 6.2) must be installed to satisfy Rose for UNIX/Linux run time requirements.
A user will encounter unresolved symbols (see example listing below), if the appropriate Compaq C++ for Tru64 Unix run time is not installed on the Tru64 Unix server, running Rose for UNIX/Linux:
30494:/rational/releases/rose.I.J.K/alpha_osf1/bin/rose_exe:
/sbin/loader: Error: Unresolved symbol in
/rational/releases/rose.I.J.K/alpha_osf1/bin/rose_exe: __nw__XUlPv
30494:/rational/releases/rose.I.J.K/alpha_osf1/bin/rose_exe:
/sbin/loader: Error: Unresolved symbol in
/rational/releases/rose.I.J.K/alpha_osf1/bin/rose_exe: __dl__XPvPv
30494:/rational/releases/rose.I.J.K/alpha_osf1/bin/rose_exe:
/sbin/loader: Error: Unresolved symbol in
/rational/releases/rose.I.J.K/alpha_osf1/bin/rose_exe: __cxx_call_static_dtors
Rose for UNIX/Linux will automatically check to determine if the correct run time library is installed on your Tru64 Unix computer:
We have included the necessary Compaq C++ for Tru64 Unix run time in case you encounter the type of errors shown previously when attempting to run this release.
The file CXXREDIST620V01.tar is located under:
rational_dir/releases/rose.I.J.K/install/patches/alpha_osf1
/usr/sbin/setld -i | grep CXX | grep installed
If either subset CXXBASEnnn or CXXREDISTnnn is installed, the correct run time is available to run Rose for UNIX/Linux. (There would be no need to install the Compaq C++ for Tru64 Unix run time library provided in this release.)
Refer to the instructions below, if it is necessary to install the Compaq C++ for Tru64 Unix 6.2 run time library provided in this release.
Note that a script named check_reqs included in the rose.I.J.K/install directory is loaded from the Rose release. This script can assist you in the verification of required configurations and the minimum recommended resource settings. A copy of check_reqs, named check_rose_reqs, is placed in the rational_dir/releases/rose.I.J.K/bin directory.
While you are installing Rose, the installation scripts automatically use check_reqs -install to verify TCP/IP, the portmap daemon, and host names. These are requirements for the workstation(s) on which you install Rose.
The check_reqs and check_rose_reqs scripts are run by the installation and rose scripts respectively to verify TCP/IP, the portmap daemon, host names, memory, page or swap space, pseudo terminals, resource limits, the X Window System, and the Motif window manager. These are requirements and recommendations for the workstation(s) on which you run Rose. The check_rose_reqs script is also run the first time that Rose is started to automatically notify you if operating system patches are necessary.
The check_reqs script is not able to check: