3. Install Type (Optional) -P ISAV3FeatureBean.active="<value>"
where
-P ISAV3TranslationsFeatureBean.active="<value>"
Important Notes :
If IBM Support Assistant v2 is already installed on the same system, the
installer will not allow IBM Support Assistant V3 to be installed in the
same location. In the GUI and Console installers, the installation will
be blocked by a prompt to change the install location so that there is
no conflict. In Silent install mode, the installation will exit with an
error code value of 2004.
4. Continue Installation if application is already installed: If IBM Support Assistant V3 is detected as being already installed
on a machine, the silent installation will not continue and exit with an error code value of 2003.
This is done because IBM Support Assistant V3 is designed to have one installation instance for each Windows machine, or one instance for each user (other platforms).
However, if you would like to modify the existing installation to continue installing any additional features, the options file must explicitly state so:
-V CONTINUE_IF_ISAv3_PRESENT="<value>"
where
<value>
should be set to true if you wish to continue installation and false if you wish to exit installation.
On Unix or Linux systems: After downloading the installer, make
sure it has the right permission to be executed. You can run the
command:
chmod +x <IBM Support Assistant Installer file>
to give the installer execute permission.
IBM Support Assistant is a J2EE web application. On Windows, IBM Support Assistant provides its own GUI using the Eclipse embedded browser widget. On all other platforms, the user interacts with IBM Support Assistant using a web browser.
Start IBM Support Assistant from the Start Menu (Start->Programs->IBM Support Assistant->IBM Support Assistant V3) or from the desktop shortcut for the IBM Support Assistant V3. To stop the application, click the ISA icon in the upper left corner, then click 'Close,' then click 'OK.'
Start IBM Support Assistant by running the startisa.sh
script from the command prompt. After this script is invoked, the
command will display some messages followed by the launching of a Mozilla browser with the IBM Support Assistant V3 welcome page. If the system does not have a Mozilla browser installed (mozilla binary), then a supported browser will need to be manually opened and the IBM Support Assistant URL must be entered into the address field. The IBM Support Assistant URL can be found in the <install_root>/workspace/logs/isaurl.log file
To stop the IBM Support Assistant, execute the stopisa.sh script
from the command prompt. The console should come back with the following
message:
Note: The user stopping the application must have authority to
kill the IBM Support Assistant V3 process (i.e., is the same user that
started it or a super user).
Messages that are written to the console when executing the start/stop
scripts are also written to the startisa.log and stopisa.log files
respectively, located in the IBM Support Assistant installation folder.
The IBM Support Assistant can be uninstalled in three ways:
1.Add/Remove Programs: The IBM Support Assistant V3 entry can be
uninstalled through the Add/Remove Programs task available in the
Control Panel.
2.Installation Location: The IBM Support Assistant uninstaller
can be invoked by executing the uninstaller from the install location.
To do so, navigate to the _uninst folder in the IBM Support
Assistant install location and run uninstaller.exe.
3.Start Menu: The IBM Support Assistant can be uninstalled by
clicking on the Uninstall IBM Support Assistant entry in the
Windows Start menu (Start->Programs->IBM Support Assistant).
The default uninstallation mode is GUI. In order to uninstall in the
console mode or silent mode, use the following commands using the
uninstaller described in the second method above:
Console mode:
<IBM Support Assistant Install Location>\_uninst\uninstaller.exe
-console
Silent mode:
<IBM Support Assistant Install Location>\_uninst\uninstaller.exe
-silent -options options.txt
Note:A sample uninstallation options file is included with the IBM Support Assistant V3 download archive.
If you choose not to specify the -options attribute and do not specify an uninstallation options file, a complete uninstall will be performed.
The IBM Support Assistant can be uninstalled by running the uninstall
executable in the _uninst folder of the location where IBM
Support Assistant is installed. The default uninstallation mode is GUI.
In order to uninstall in the console mode or silent mode, use the
following commands using the uninstaller described in the second method
above:
Console mode:
<IBM Support Assistant Install Location>\_uninst\<uninstaller
executable> -console
Silent mode:
<IBM Support Assistant Install Location>\_uninst\<uninstaller
executable> -silent-options options.txt
Note:A sample uninstallation options file is included with the IBM Support Assistant V3 download archive.
If you choose not to specify the -options attribute and do not specify an uninstallation options file, a complete uninstall will be performed.
The installation and uninstallation log file, log.txt, is
present in the location where IBM Support Assistant is installed. If
installation fails before the creation of this destination folder, you
may check the log file in the temp location of your platform, or specify
another location for the log. This may be done by adding -is:log
<log_file> after the installer executable, e.g.:
setupLinux.bin -is:log /tmp/isalog.log
If the default temporary location on your system does not have enough space, you may specify the temporary location to be used explicitly by using the following install command:
Lack of space on your system may result in a Signal 11 error thrown during installation on some operating systems.
The port number that IBM Support Assistant runs on is selected at random every time IBM Support Assistant is started. However, it can be changed after installation. To do so, navigate to the <install_root>/configuration folder and modify the com.ibm.osg.webcontainer.port entry in the config.ini file to represent the port number you would like IBM Support Assistant V3 to use. The default value of 0 indicates that a random port number will be selected at startup. The IBM Support Assistant will need to be relaunched for this change to take effect.
If you are having trouble starting IBM Support Assistant, there are a few log files you can look at for problem determination.
If IBM Support Assistant does not come up or comes up with a blank page, verify that there is no firewall blocking access to the IBM Support Assistant at the port specified in the config.ini file mentioned in the Port number modification maintenance setting above.
If you get a message indicating that you do not have the authority to
start or stop the IBM Support Assistant, please make sure that either
the root user is attempting this operation or that the operation is
being performed by the same user responsible for installing IBM Support
Assistant.
Some operating systems might have restrictions that let only the root
user run programs on ports below port number 1024.
If you get a message indicating IBM Support Assistant V3 is already
installed when you start the installer, please verify that you do not have IBM Support Assistant V3 installed anywhere on your machine. This is very important to ensure that proper maintenance and updates can be applied in the future.
If you are sure that IBM Support Assistant V3 is not installed on your
system and you are erroneously getting this error message, or you would
like to overwrite a corrupted installation, you may use the following
install command to override this check:
The installer can be started with the "-accessibility" option. This will start the installer in a console mode which is modified to make it easier to understand the installation screens when they are read by screen readers.
When users exit the main ISA window, they are prompted for confirmation. This is because all windows and tools started from within ISA will also be closed.
Users have the option of selecting the checkbox to not display this confirmation when exiting ISA. If you have done this, but now want to re-enable this confirmation dialog, perform the following steps:
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
IBM is a trademark of International Business Machines Corporation in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
Other company, product, and service names may be trademarks or service marks of others.
(c) Copyright IBM Corp. and others 2004