SYSTEM REQUIREMENTS JAVA VIRTUAL MACHINE INSTALLATION STARTUP TROUBLESHOOTING
Intel
SPARC
<< Go back to general readme

System Requirements for UNIX systems

Choose your hardware platform: Intel x86, SPARC.

Intel x86:

CPU:
Pentium, 166MHz or faster; Recommended: Pentium, 233MHz;
for large projects: 
Pentium-II, 300MHz or faster
Memory: 64 MB or more Recommended: 96 MB;
for large projects and running scripts: 128 MB
128 MB or more swap space recommended for Linux
Hard disk space: 15 MB Not including the size of virtual machine
Video: X Window System, Protocol version 11, Revision 6 Recommended screen resolution: 
1024x768 or more
OS: SunTM SolarisTM 2.5.1x86, or
  RedHat Linux 4.1 - 5.0 and later, kernel 2.0 or 2.1 
Java VM or JDK:
(see Java VM info below) Required to run Together
HTML browser - required to view and print online documentation and generated documentation.
CD-ROM drive or Internet connection - required for installation/download and information update.

SPARC® workstations:

CPU:
UltraSPARC 143MHz or faster
Memory: 96 MB or more Recommended: for large projects and running scripts: 128 MB
Hard disk space: 15 MB Not including the size of virtual machine
Video: X Window System, Protocol version 11, Revision 6
OS: SunOS Release 5.5.1
Java VM or JDK:
(see Java VM info below) Required to run Together
HTML browser - required to view and print online documentation and generated documentation.
CD-ROM drive or Internet connection - required for installation/download and information update.


JavaTM Virtual machine (VM) information

Together has been tested on the following Java VMs under UNIX systems:

Installation

The installation process varies depending upon the product version and what variant of the installer you have obtained. Together  has a pure-Java installer.

To install Together using the pure-Java Installer:

  1. You must have a Java VM already installed on your computer.
  2. Run together.class in your Java virtual machine and follow the JShield Wizard's instructions.

  3. You can execute the installation shell command file: install_unix.sh
    This file may require corrections in accordance to your environment.
  4. Choose the destination directory.
Note that Together is installed with the 0777 permissions to enable maximum access. Take this into account when choose the destination directory.


Start-up

To run Together

  1. Start Console
  2. Change working directory to /Together/bin (assuming you've installed the product to /Together)
  3. Execute ./Together.sh

  4. ...or run the script in sh with the following command:
      sh Together.sh

After startup:

For more information, see the Getting Started part of the Help.


Troubleshooting

In case of any problems, refer to faq.html file where you'll find answers to many questions including installation, start-up and VM-specific issues.

Specifying the installation directory

At the JShield Wizard's "Choose Destination Location" prompt, do not enter environment variables such as $HOME. These are not supported by the JShield installer.

Setting environment variables

If you don't have JAVA_HOME and CLASSPATH environment variables set correctly, execute the following commands (assuming you are running sh):
 JAVA_HOME=<path_to_jdk_installation_root>
 export JAVA_HOME
 CLASSPATH=.:<path_to_classes.zip>
 export CLASSPATH
For example:
 JAVA_HOME=/usr/local/java
 export JAVA_HOME
 CLASSPATH=.:/usr/local/java/lib/classes.zip
 export CLASSPATH
Note that if you are using csh this will look like:
 setenv JAVA_HOME=/usr/local/java
 setenv CLASSPATH=.:/usr/local/java/lib/classes.zip
Now run the installation script from command line:
 sh install_unix.sh
If you still experience problems with running the installation script, you can execute the installation manually. Assuming you already set up necessary environment variables, you have to execute the following command:
 /usr/local/java/bin/java together
Of course, use the correct path to your virtual machine.

Note to JRE users

If you have only JRE installed you presumably don't have classes.zip, but there're rt.jar and i18n.jar. Then you would have to modify CLASSPATH variable like this:
CLASSPATH=.:/usr/local/java/lib/rt.jar:/usr/local/java/lib/i18n.jar

Browser

The file associations in the Together/bin directory specifies the paths for the Web browser used to display Together HTML Help. By default it invokes netscape. If you use another browser or Netscape is not located on your system search path, then you should specify correct path to your browser.
Some installations of Netscape Communicator create the script usr/local/bin/netscape which launches the browser from another directory, but it does not pass arguments. This results in opening the browser but empty. Either modify this script ot modify the associations file to point to real location of Netscape Communicator binary file.

Symbolic links

Together does not properly work with projects which contain symbolic links in the project path. Workaround: Open project using path with resolved symbolic links.
 

Solaris mouse note

Make sure you've defined 3-button mouse and set the right button to Adjust instead of Select.
 

Colormaps on Sun Solaris

The problems comes out of the limited colormap size on 8-bpp displays, which are commonly used on Sun workstations. JDK doesn't handle private colomaps, though Netscape tends to allocate many colors, so Together can't allocate more. This results in that Together displays dialogs and panes in black-and-white.
There can be suggested 2 workarounds:
  1. Run Netscape with an option limiting its color cube size to a specified number, e.g.:

  2. $   netscape -ncols 64
     
  3. Add the following line to user's $HOME/.Xdefaults file:

  4. Netscape*installColormap:   Yes
In the second case, screen will flash each time when Netscape window gets focus, but other applications will get colors freely.
 

SPARC Solaris patches

Some users reported the problem: They start Together, the Together logo comes up with the name of license, the toolbar appears.  Once the toolbar has appeared Together immediately closes.
Workaround: the installation of Sunsolve`s recommended patches may help. Download them from http://sunsolve.sun.com/sunsolve/pubpatches/patches.html
 

Scrollbars jitter bug under JDK 1.1.6 and Solaris

JDK 1.1.6 Production Release has an error in working with scrollbars. Moving a bit the Together diagram scrollbars initiates infinitive chain of events that results in scrollbars jitter.
Workaround: use patches to java.awt classes supplied with Together since build 361. You can: These files are available in any UNIX-system installation.


SYSTEM REQUIREMENTS   JAVA VIRTUAL MACHINEINSTALLATIONSTARTUPTROUBLESHOOTING