Install or Upgrade the Workstation

In a CA APM installation, you can install or upgrade the Workstation. After you Install the Workstation as an administrator, manually grant access to the non-administrator users to use the workstation. Use the Windows explorer folder sharing properties to grant access the the Workstation.
apmdevops97
In a CA APM installation, you can install or upgrade the Workstation. After you Install the Workstation as an administrator, manually grant access to the non-administrator users to use the workstation. Use the Windows explorer folder sharing properties to grant access the the Workstation.
As an administrator, follow these steps:
Download External Component Packages
To install CA Introscope, obtain the following third-party external component package files:
  • eula.txt
  • osgiPackages archive:
    • Windows
      -- osgiPackages.
      <VersionNumber>
      .windows.zip
    • UNIX
      -- osgiPackages.
      <VersionNumber>.unix.tar
Follow these steps:
  1. Download the eula.txt file and the osgiPackages archive for your system.
    The installer does not validate whether you have downloaded the correct archive for your platform. Be sure you download and specify the correct archive for your platform.
  2. Place the files on your network. You will provide the path to these files during the installation process.
Install the Workstation in GUI Mode
You can install the workstation in GUI mode.
Note:
When installing the Workstation, the installer automatically installs the following directory containing files for ChangeDetector:
<Workstation_Home>\tools\ChangeDetectorWizard.jar <Workstation_Home>\tools\configwizard.bat
For information about configuring and using ChangeDetector, see the CA APM
ChangeDetector User Guide
.
Follow these steps:
  1. Select the appropriate Workstation-only installer file for your operating system:
    • Windows
      -- IntroscopeWorkstation<
      version
      >windows.exe
    • Linux
      -- IntroscopeWorkstation<
      version
      >linux.bin
  2. Start the Workstation installer.
    The Introduction window opens.
  3. Click Next and accept the terms of the license agreement.
  4. In the Choose Install Folder window, click Next to accept the default installation directory, or click Browse to specify a different location and click Next.
    The Specify External Components window opens.
    Do not specify the installation directory with non-Roman characters, such as Japanese, when installing on a computer with an English-language locale. Although the installer accepts non-Roman characters, the Workstation cannot use the information to connect to the Enterprise Manager.
  5. Provide the location of the External Components Package file and click Next.
    Accept the terms of the End User License Agreement (EULA) and click Next.
    An installer that includes a bundled JVM opens the Configure JVM Settings window.
  6. Select Yes to configure JVM workstation settings during the installation. Select No to accept the defaults, or if you plan to configure them manually later. Click Next.
    If you select Yes, a JVM Settings window opens for each CA Introscope component during the installation.
  7. In the Workstation Settings window, you can accept the default user, host, and port values, or type other values. Click Next.
    An Admin user exists by default in the Enterprise Manager users.xml file. Any other user name must exist in the Enterprise Manager users.xml file if you are using local authentication, or in the external authentication system. For information about adding new users, see the
    CA APM Security Guide
    .
    If you selected No in Step 6, the Pre-installation summary opens. Go to Step 9.
    If you selected Yes in Step 6, the Workstation Advanced JVM Settings window opens. Go to the next step.
  8. Specify the Java executable to run CA Introscope, and any appropriate command-line JVM arguments. Click Next.
  9. Review the summary of the Workstation settings and click Next.
  10. Click Install.
    CA Introscope installs the necessary files and displays the Install Complete window. The installer places installation log files in the
    <EM_Home>
    \install directory.
Install the Workstation Using Java Web Start
You can install the Workstation with Java Web Start to enable the online deployment of the Workstation. This method ensures that users have a version of the Workstation that matches the Enterprise Manager. The Java Web Start installation uses the Enterprise Manager embedded Web server. A Java Web Start service starts automatically when the Enterprise Manager starts. After you install the Workstation, install agents so that the Enterprise Manager has data to display.
For information, see the
CA APM Java Agent Implementation Guide
and
CA APM .NET Agent Implementation Guide.
Users launch the Workstation by opening a browser to the Java Web Start URL. The Enterprise Manager installation puts a Workstation Web Start shortcut on the Start menu on the Enterprise Manager computer. Each time the user opens the URL, Java Web Start checks to see if the installation is current and updates the installation if necessary.
You may need to specify an alternate port for the Enterprise Manager Web server in the following cases:
  • More than one Enterprise Manager is running on a single computer.
  • The default Web Server port of 8081 is in use by another service on the computer.
You can set introscope.enterprisemanager.webserver.port in the Enterprise Manager properties file.
For more information, see the
CA APM Configuration and Administration Guide
.
Follow these steps:
  1. Open a browser to:
    http://<EM_Host>:8081/workstation
    If Java Web Start is not installed on your computer, you are prompted to download it. Close and reopen the browser after installation.
    The Workstation login page opens.
  2. Create a URL shortcut for the Java Web Start URL.
  3. Drag and drop the URL to your Desktop or desired folder. If you use Internet Explorer, drag the IE icon at the beginning of the address bar to the desired location.
Java Versions for Java Web Start
Java Web Start launches the Workstation using a Java version. The following files define the version:
  • <
    EM_Home
    >\product\enterprisemanager\plugins\com.wily.introscope.workstation.webstart_<
    version
    >\WebContent\jnlp\workstation.jsp
  • <
    EM_Home
    >\product\enterprisemanager\plugins\com.wily.introscope.workstation.webstart_<
    version>
    \WebContent\jnlp\com.wily.introscope.workstation.feature_<version>.jsp
Both files include a j2se node with a version attribute:
<j2se version="1.7*" ... />
Java Web Start uses this attribute to determine the Java version to use to launch the Workstation.
The attribute lists Java version ranges in preferred order from first to last. A single space separates each range. Java Web Start checks the client system for all version ranges in the listed order and installs the first qualifying version that it finds. If Java Web Start does not find a qualified, preinstalled JVM, it downloads the newest available version that all version ranges permit regardless of order.
Example: The j2se version is set to
"
1.7*&1.7.0_05+" ...:
If a valid update level of Java 1.7 is not found, Java Web Start checks the client system for Java 1.7, update 5 at a minimum.
1.7* = version starts with 1.7 & = and 1.7.0_05+ = version is 1.7 update 5 or later
Java Web Start downloads the newest available version that any of the version ranges permit.
Users can customize the ranges to allow earlier update levels at their own risk. If you edit the version range list, edit it in both workstation.jsp and com.wily.introscope.workstation.feature_<
version
>.jsp.
Upgrade the Workstation
You can upgrade standalone Workstations.
If you use the Java Web Start Workstation, your Workstations automatically upgrade the first time that they connect to a 9.x Enterprise Manager.
Follow these steps:
  1. Uninstall your Workstations.
  2. Install a later Workstation version.
Verify the Workstation Installation on Windows
To verify the Workstation installation on Windows, run both the Enterprise Manager and Workstation without errors.
Follow these steps:
  1. Start the Enterprise Manager by selecting Start, Programs, CA APM, Administration, CA APM, Enterprise Manager.
    For information about starting the Enterprise Manager, see the
    CA APM Configuration and Administration Guide.
  2. Start the Workstation by selecting Start, APM, Introscope Workstation or use a browser and enter the Workstation URL, for example:
    http://<EM_Host>:8081/workstation
    EM_Host is the host name of the Enterprise Manager.
    The first time that you start the Workstation, you are prompted to launch workstation.jnlp or save the file.
    Launch workstation.jnlp.
    Saving the file and selecting the "Do this automatically for files like this from now on" option is
    not
    recommended. This option prevents you from properly launching the Workstation through a URL.
  3. In the Workstation login dialog, enter the following information:
    • The host name or IP address.
      Use the IP address instead of the host name only if both your client computer and the host computer support the same IP protocol.
    • The port number.
    • The user name and password.
  4. Click Connect, or to make the current host and user information the default for future logins, click Set Defaults.
    The Console opens. If the authentication process is unsuccessful, a message notifies you of the failure.
    To configure Workstation user permissions, see the
    CA APM Security Guide.
    When the Workstation connects successfully to the Enterprise Manager, the Workstation opens.
Verify the Workstation Installation on Linux
To verify the Workstation installation on Linux, run both the Enterprise Manager and Workstation without errors.
Follow these steps:
  1. Start the Enterprise Manager by typing this command at the command prompt:
    ./Introscope_Enterprise_Manager
    For more information about starting the Enterprise Manager, see the
    CA APM Configuration and Administration Guide.
  2. Start the Workstation:
    1. Open a command prompt.
    2. Change to the <
      Workstation_Home
      > directory.
      Execute the Workstation start command by using the following syntax:
      java [optional arguments] -jar launcher.jar [Eclipse arguments]
      An example of a full Workstation start command:
      java -client -Xms64m -Xmx256m -Dsun.java2d.noddraw=true -jar launcher.jar -consoleLog -noExit -product com.wily.introscope.workstation.product -name "Introscope Workstation" -install ".\\product\\workstation" -configuration ".\\product\\workstation\\configuration"
      For information about Workstation commands, see the
      CA APM Workstation User Guide.
    When the Workstation connects successfully to the Enterprise Manager, the Workstation opens.