TOC PREV NEXT

HipCheck Mobility Service HipCheck Installation and User Guide

2 Getting started

This chapter covers installing and configuring the HipCheck mobility service components.
Note: Before proceeding with this chapter, the account owner must log in to the Account Portal (at http://<CommName>.hipcheck.me-inc.com) and activate the HipCheck service, as well as add any subscribers who will use HipCheck. See Chapter 2 in Getting Started with your Me Inc. Account -- Handbook for Account Owners and Account Managers for details.

To get started with HipCheck, complete these steps, in the following order:

  1. "Installing the HipCheck agent"
  2. "Setting up systems, user privileges, and alert recipients on the HipCheck Mobility Server"
  3. "Installing the HipCheck client"
  4. "Activating the HipCheck mobility service"

After you complete the steps described in this chapter, you are ready to monitor your systems with the HipCheck mobility service. See Chapter 3, "Using the HipCheck client" for more information.
Note: To update your current agents and clients, see Appendix A, "Upgrading HipCheck agents and clients" (page 103).

Installing the HipCheck agent

The HipCheck mobility service uses special agent software to monitor the behavior and performance of SCO UNIX and Microsoft Windows systems. This section describes how to install the HipCheck agent on the following supported operating systems:

To verify that a system's configuration supports being monitored by the HipCheck agent, see "Before you begin".
Note: To update your existing agents, see Appendix A, "Upgrading HipCheck agents and clients" (page 103).

Before you begin

HipCheck requires that a monitored system uses either a Fully-Qualified Domain Name (FQDN) or a static IP address. A system that obtains its IP address from a DHCP server can also be monitored by HipCheck, provided the system's IP address does not change. This can be accomplished in a variety of ways, including: NAT (Network Address Translation), firewall port-forwarding, or configuring a reserved IP address that is always assigned to the system by the DHCP server.

If your system uses NAT, or is located behind an ADSL router or firewall, you must configure your router to use port-forwarding and a static IP address provided by your Internet Service Provider. After you install the HipCheck agent on a system that falls into one of these categories, follow the instructions in the "Setting up port forwarding for NAT systems" section.

Install the HipCheck agent on SCO OpenServer Release 5.0.7 systems

The HipCheck agent for SCO UNIX systems is written in Java and works as a SOAP/XML-based web service. It uses the Apache Axis Java SOAP implementation and the Tomcat Java application server. It is not necessary to have the Apache web server installed or running.

Prerequisites for installing the HipCheck agent

Before installing the HipCheck agent, verify that your SCO OpenServer Release 5.0.7 system satisfies the following prerequisites:

  1. Using customquery(ADM), verify that the system contains the following required software products:
    • SCO OpenServer Release 5.0.7 Maintenance Pack 5 or later
      Provided on the SCO OpenServer Release 5.0.7 Maintenance Pack 5 CD. To check that this software is installed, run: 
      # customquery ListComponents | grep rs507d
      If MP5 is installed, you see a list of components, including SCO:Unix::rs507d.Unix507.1.0d.
    • Apache Tomcat Servlet Container, version 4.1.31 or later
      Included with Maintenance Pack 5. To check that this software is installed, run: 
      # customquery ListComponents | grep tomcat
      If Tomcat is installed, you see SCO:tomcat::4.1.31Pc.
    • Java 2 Standard Edition (J2SE), version 1.4.2
      Provided on the SCO OpenServer Release 5.0.7 Supplement CD Version 5. To check that this software is installed, run: 
      # customquery ListPackages | grep Java2
      Verify that the required Java 2 Runtime Environment (Java2_JRE_142::1.4.2La) and Java 2 Software Development Kit (Java2_SDK_142::1.4.2La) packages are listed.
    • gSOAP 2.3.3 and JavaSOAP (including Xerces for Java), version 1.0.0Bb
      You must install the soap-1.0.0Bb_vol.tar version of this product, which is provided at the HipCheck Portal. Note that the 1.0.0Ba version of gSOAP is incompatible with the HipCheck agent and must be removed prior to installing the required 1.0.0Bb version.
      Tip: If you do not have installation media for these products, you can download them from the HipCheck Portal, at:
      https://<CommName>.hipcheck.me-inc.com/hipcheck/app
      where <CommName> is the Community Name for your Me Inc. account. Log in, click Downloads, then click on the SCO OpenServer 5.0.7 Agent link in the "SCO UNIX Agent components" section.
  2. The system's domain name must be defined in the /etc/resolv.conf file. If you need to add a domain entry for your system to /etc/resolv.conf file, see "Configuring the Domain Name Service" in the SCO OpenServer Networking Guide or the resolver(SFF) manual page for help.
  3. Now verify that Apache Axis is working properly on the system. To do this:
    • Make sure that Tomcat is running. If not, start it manually: 
      # /etc/init.d/tomcat start
    • Validate the Axis installation by opening the Apache-Axis start page at:
      http://localhost:8080/axis/index.jsp
      Click on the installation validation link -- you should see a happyaxis test page verifying that the required and optional libraries are present.
    • Check the list of deployed services at:
      http://localhost:8080/axis/servlet/AxisServlet
      The Axis AdminService should be listed on the "And now...Some Services" web page.
Installing the HipCheck agent

To install the HipCheck agent on an SCO OpenServer Release 5.0.7 system:

  1. Log in to the SCO OpenServer system as root.
  2. Create the following directory: 
    #  mkdir -p /HcSCOUA
  3. Download the HipCheck agent for SCO UNIX systems.
    Access the HipCheck Portal:
    • Go to the HipCheck Portal at:
      https://<CommName>.hipcheck.me-inc.com/hipcheck/app
      where <CommName> is the Community Name for your Me Inc. account.
    • Log in, using your Me Inc. account user name and password.
    Download the HipCheck agent media image file:
    • Click on Downloads.
    • Click on the SCO OpenServer 5.0.7 Agent link in the "SCO UNIX Agent components" section.
    • Click on the HcSCOUA-1.0.2.OSR507.tar.bz2 link and save the file to the /HcSCOUA directory that you created in Step 2.
    • Verify that the HcSCOUA-1.0.2.OSR507.tar.bz file download correctly by running: 
      # cksum HcSCOUA-1.0.2.OSR507.tar.bz2
      Confirm that the resulting checksum matches the value included in the HcSCOUA-1.0.2.OSR507.tar.bz2.cksum file provided on the download page.
  4. Change to the /HcSCOUA directory and extract the contents of the tar archive by running the following commands: 
    # bunzip2 HcSCOUA-1.0.2.OSR507.tar.bz2

    # tar xvf HcSCOUA-1.0.2.OSR507.tar
  5. Run the following command to install the HipCheck agent: 
    #  custom -p SCO:HipcheckSCOUnixAgent -i -z `pwd`/archives/TAPE

The HipCheck agent for SCO UNIX systems starts automatically upon installation, and whenever the system is rebooted.
Note: If this system uses NAT, or sits behind an ADSL router/firewall, see "Setting up port forwarding for NAT systems" to make the agent service accessible from the Internet.

Verifying the HipCheck agent installation

To confirm that the HipCheck agent is running and able to communicate with the HipCheck Mobility Server:

  1. Review the custom logs in /var/adm/install/logs/custom/HcSCOUA to verify that the installation completed without errors.
  2. Confirm that Tomcat is running: 
    # ps -aef | grep tomcat
    You should see a process identified by the string java.endorsed.dirs=. If Tomcat is not running, start it by running /etc/init.d/tomcat start.
  3. Verify that the SCOUnixAgentService service is listed on the Axis Services web page, at:
    http://localhost:8080/axis/servlet/AxisServlet

For information on troubleshooting, administering, and extending the HipCheck agent, see Chapter 5, "Managing HipCheck agents".

Next steps:

Install the HipCheck agent on SCO OpenServer Release 6 systems

The HipCheck agent for SCO UNIX systems is written in Java and works as a SOAP/XML-based web service. It uses the Apache Axis Java SOAP implementation and the Tomcat Java application server. It is not necessary to have the Apache web server installed or running.

Prerequisites for installing the HipCheck agent

Before installing the HipCheck agent, verify that your SCO OpenServer Release 6.0.0 system satisfies the following prerequisites:

  1. Using customquery(ADM), verify that the system contains the following required software products:
    • SCO OpenServer Release 6.0.0 Maintenance Pack 2 or later
      Provided on the SCO OpenServer Release 6.0.0. Maintenance Pack 2 CD. To check that this software is installed, run: 
      # customquery ListComponents | grep rs600b
      If MP2 is installed, you see a list of components, including SCO:Unix::rs600b.Unix600.1.0a.
    • Java 2 Standard Edition (J2SE), version 1.4.2 or 1.5.0
      Version 1.4.2 is included with Maintenance Pack 2. To check that this software is installed, run: 
      # customquery ListPackages | grep j2se142
      or 
      # customquery ListPackages | grep j2se150
    • Apache Tomcat Servlet Container, version 4.1.31 or later
      A separately installable component that is included on the SCO OpenServer Release 6.0.0 MP2 Supplement CD. To check that this software is installed, run: 
      # customquery ListComponents | grep tomcat
      If Tomcat is installed, you see SCO:tomcat::4.1.31Sa.
      Tip: If you do not have installation media for these products, you can download them from the HipCheck Portal, at:
      https://<CommName>.hipcheck.me-inc.com/hipcheck/app
      where <CommName> is the Community Name for your Me Inc. account. Log in, click Downloads, then click on the SCO OpenServer 6.0.0 Agent link in the "SCO UNIX Agent components" section.
  2. The system's domain name must be defined in the /etc/resolv.conf file. If you need to add a domain entry for your system to /etc/resolv.conf file, see "Configuring the Domain Name Service" in Administering TCP/IP (in the DocView Networking topic) or the resolver(SFF) manual page for help.
  3. Now verify that Apache Axis is working properly on the system. To do this:
    • Make sure that Tomcat is running. If not, start it manually: 
      # /etc/init.d/tomcat start
    • Validate the Axis installation by opening the Apache-Axis start page at:
      http://localhost:8080/axis/index.jsp
      Click on the installation validation link -- you should see a happyaxis test page verifying that the required and optional libraries are present.
    • Check the list of deployed services at:
      http://localhost:8080/axis/servlet/AxisServlet
      The Axis AdminService should be listed on the "And now...Some Services" web page.
Installing the HipCheck agent

To install the HipCheck agent on an SCO OpenServer Release 6 system:

  1. Log in to the SCO OpenServer system as root.
  2. Create the following directory: 
    #  mkdir -p /HcSCOUA
  3. Download the HipCheck agent for SCO UNIX systems:
    Access the HipCheck Portal:
    • Go to the HipCheck Portal at:
      https://<CommName>.hipcheck.me-inc.com/hipcheck/app
      where <CommName> is the Community Name for your Me Inc. account.
    • Log in, using your Me Inc. account user name and password.
    Download the HipCheck agent media image file:
    • Click on Downloads.
    • Click on the SCO OpenServer 6.0.0 Agent link in the "SCO UNIX Agent components" section.
    • Click on the HcSCOUA-1.0.2.OSR600.tar.bz2 link and save the file to the /HcSCOUA directory that you created in Step 2.
    • Verify that the HcSCOUA-1.0.2.OSR600.tar.bz file download correctly by running: 
      # cksum HcSCOUA-1.0.2.OSR600.tar.bz2
      Confirm that the resulting checksum matches the value included in the HcSCOUA-1.0.2.OSR600.tar.bz2.cksum file provided on the download page.
  4. Change to the /HcSCOUA directory and extract the contents of the tar archive by running the following commands: 
    # bunzip2 HcSCOUA-1.0.2.OSR600.tar.bz2

    # tar xvf HcSCOUA-1.0.2.OSR600.tar
  5. Run the following command to install the HipCheck agent: 
    # custom -p SCO:HipcheckSCOUnixAgent -i -z `pwd`/archives/TAPE

The HipCheck agent for SCO UNIX systems starts automatically upon installation, and whenever the system is rebooted.
Note: If this system uses NAT, or sits behind an ADSL router/firewall, see "Setting up port forwarding for NAT systems" to make the agent service accessible from the Internet.

Verifying the HipCheck agent installation

To confirm that the HipCheck agent is running and able to communicate with the HipCheck Mobility Server:

  1. Review the custom logs in /var/adm/install/logs/custom/HcSCOUA to verify that the installation completed without errors.
  2. Confirm that Tomcat is running: 
    # ps -aef | grep tomcat
    You should see a process identified by the string java.endorsed.dirs=. If Tomcat is not running, start it by running /etc/init.d/tomcat start.
  3. Verify that the SCOUnixAgentService service is listed on the Axis Services web page, at:
    http://localhost:8080/axis/servlet/AxisServlet

For information on troubleshooting, administering and extending the HipCheck agent, see Chapter 5, "Managing HipCheck agents"

Next steps:

Install the HipCheck agent on SCO UnixWare 7.1.4 systems

The HipCheck agent for SCO UNIX systems is written in Java and works as a SOAP/XML-based web service. It uses the Apache Axis Java SOAP implementation and the Tomcat Java application server. It is not necessary to have the Apache web server installed or running.

Prerequisites for installing the HipCheck agent

Before installing the HipCheck agent, verify that your SCO UnixWare Release 7.1.4 system satisfies the following prerequisites:

  1. Using pkginfo(1), verify that the system contains the following required software:
    • SCO UnixWare Release 7.1.4 Maintenance Pack 3 or later
      To check that this software is installed, run: 
      # pkginfo uw714m3
    • Java 2 Standard Edition (J2SE), version 1.4.2 or 1.5.0
      The Java 2 Runtime Environment (j2jre142 or j2jre150) and Java 2 Software Development Kit (j2sdk142 and j2sdk150) packages are required. To check that these packages are installed, run: 
      # pkginfo j2jre142 

      # pkginfo j2sdk142
      or 
      # pkginfo j2jre150 

      # pkginfo j2sdk150
    • Apache Tomcat Servlet Container, version 4.1.31 or later
      To check that this software is installed, run: 
      # pkginfo -l tomcat
      If you have an earlier version of Tomcat installed, you must remove the modjk1 and modjk2 packages prior to installing Tomcat version 4.1.31.
    • javasoap - Apache Axis 1.2 and Apache Xerces-J 1.4.4, version 1.2 or later
      You must download and install the javasoap-1.2.a.pkg file that is available at the HipCheck Portal. Note that older versions of the javasoap package are incompatible with the HipCheck agent and must be removed prior to installing this required product.
      Tip: You can download all of these products from the HipCheck Portal, at:
      https://<CommName>.hipcheck.me-inc.com/hipcheck/app
      where <CommName> is the Community Name for your Me Inc. account. Log in, click Downloads, then click on the SCO UnixWare 7.1.4 Agent link in the "SCO UNIX Agent components" section.
  2. The system's domain name must be defined in the /etc/resolv.conf file. If you need to add a domain entry for your system to /etc/resolv.conf file, see "Configuring Domain Name System (DNS) servers" in Administering TCP/IP and Internet services (in the DocView Networking topic) or the resolv.conf(4tcp) manual page for help.
  3. Now verify that Apache Axis is working properly on the system. To do this:
    • Make sure that Tomcat is running. If not, start it manually: 
      # /etc/init.d/tomcat start
    • Validate the Axis installation by opening the Apache-Axis start page at:
      http://localhost:8080/axis/index.jsp
      Click on the installation validation link -- you should see a happyaxis test page verifying that the required and optional libraries are present.
    • Check the list of deployed services at:
      http://localhost:8080/axis/servlet/AxisServlet
      The Axis AdminService should be listed on the "And now...Some Services" web page.
Installing the HipCheck agent

To install the HipCheck agent on an SCO UnixWare Release 7.1.4 system:

  1. Log in to the SCO UnixWare system as root.
  2. Create the following directory: 
    #  mkdir -p /HcSCOUA
  3. Download the HipCheck agent for SCO UNIX systems:
    Access the HipCheck Portal:
    • Go to the HipCheck Portal at:
      https://<CommName>.hipcheck.me-inc.com/hipcheck/app
      where <CommName> is the Community Name for your Me Inc. account.
    • Log in, using your Me Inc. account user name and password.
    Download the HipCheck agent media image file:
    • Click on Downloads.
    • Click on the SCO UnixWare 7.1.4 Agent link in the "SCO UNIX Agent components" section.
    • Click on the HcSCOUA-1.0.2.UW714.pkg.ds.Z link and save the file to the /HcSCOUA directory that you created in Step 2.
    • Verify that the HcSCOUA-1.0.2.UW714.pkg.ds.Z file download correctly by running: 
      # cksum HcSCOUA-1.0.2.UW714.pkg.ds.Z
      Confirm that the resulting checksum matches the value in the HcSCOUA-1.0.2.UW714.pkg.ds.Z.cksum file provided on the download page.
  4. Change to the /HcSCOUA directory and uncompress the downloaded file: 
    # uncompress HcSCOUA-1.0.2.UW714.pkg.ds.Z
  5. Run the following command to install the HipCheck agent: 
    # pkgadd -d `pwd`/HcSCOUA-1.0.2.UW714.pkg.ds
    Note: At the end of the installation, you may see these warnings: 
    log4j: WARN No appenders could be found for logger

    (org.apache.commons.digesters.Digester.sax).

    log4j: WARN Please initialize the log4j system properly.

    You can safely ignore these messages.

The HipCheck agent for SCO UNIX systems starts automatically upon installation, and whenever the system is rebooted.
Note: If this system uses NAT, or sits behind an ADSL router/firewall, see "Setting up port forwarding for NAT systems" to make the agent service accessible from the Internet.

Verifying the HipCheck agent installation

To confirm that the HipCheck agent is running and able to communicate with the HipCheck Mobility Server:

  1. Review the pkgadd logs in /var/sadm/install/logs/HcSCOUA to verify that the installation completed without errors.
  2. Confirm that Tomcat is running: 
    # ps -aef | grep tomcat
    You should see a process identified by the string java.endorsed.dirs=. If Tomcat is not running, start it by running /etc/init.d/tomcat start.
  3. Verify that the SCOUnixAgentService service is listed on the Axis Services web page, at:
    http://localhost:8080/axis/servlet/AxisServlet

For information on troubleshooting, administering, and extending the HipCheck agent, see Chapter 5, "Managing HipCheck agents".

Next steps:

Install the HipCheck agent on Windows systems

You can install the HipCheck agent on the following Microsoft Windows systems:

To install the HipCheck agent on a supported Windows system:

  1. Install Microsoft .NET Framework Version 2.0, if it is not already on the system.
    Download the installer file:
    • Go to the HipCheck Portal at:
      https://<CommName>.hipcheck.me-inc.com/hipcheck/app
      where <CommName> is the Community Name for your Me Inc. account.
    • Log in, using your Me Inc. account user name and password.
    • Click on Downloads.
    • Click on the .NET Framework Version 2.0 link in the "Windows Agent components" section and save the dotnetfx.exe file to the desired location.
    Install .NET Framework Version 2.0:
    • Double-click on the dotnetfx.exe file.
    • Follow the installation instructions.
  2. Download and install the HipCheck agent for Windows systems:
    Download the installer file:
    • At the HipCheck Portal, click on Downloads.
    • Click on the Windows Agent link in the "Windows Agent components" section and save the HipCheckWinAgent-1.0.2.msi file to the desired location.
    Install the HipCheck agent:
    • Double-click on the HipcheckWinAgent-1.0.2.msi file.
    • Follow the installation instructions. The HipCheck Agent for Windows Setup Wizard starts. Click Next.
    • Accept the License Agreement terms, then click Next.
    • Specify the TCP/IP port on which the HipCheck agent should listen for requests from HipCheck clients (via the HipCheck Mobility Server), and the frequency with which the agent should check for alert conditions. The default is port 8081 and a poll interval of 30 seconds. Click Next to continue.
    • Select the desired installation directory, then click Next.
    • Click Next to confirm the installation. The HipCheck agent is installed on your system.
    • Click Close to complete the installation.
  3. If Windows Firewall is running on the system, do one of the following so the HipCheck agent can communicate with the HipCheck Mobility Server:
    • deactivate Windows Firewall, or
    • configure Windows Firewall so that port 8081 (or the port that you choose during the agent installation) is open to outside access

The HipCheck agent is a standard Windows service that starts automatically when the installation is complete and whenever the system is restarted.
Note: If this system uses NAT, or sits behind an ADSL router/firewall, see "Setting up port forwarding for NAT systems" to make the agent service accessible from the Internet.

To confirm that the HipCheck agent is running and able to communicate with the HipCheck Mobility Server:

  1. Run the Windows Services utility (Control Panel > Administrative Tools > Services) and verify that there is an entry for HipCheck Agent and that the "Status" column shows that the service is Started.
  2. Run the Windows Event Viewer utility (Control Panel > Administrative Tools > Event Viewer) and double-click on the HipcheckLog entry. Then double-click on the latest message in the log and verify that it says the agent is Ready to receive HipCheck requests.
  3. Finally, access the HipCheck agent service web page at:
    http://<IPaddress>:8081/HIPcheck.asmx
    where <IPaddress> is the IP address for the Windows system where you just installed the agent. You should see a "HIPcheckRequest" page that displays a list of supported operations.

For information on troubleshooting and administering the HipCheck agent, see Chapter 5, "Managing HipCheck agents".

Next steps:

Setting up port forwarding for NAT systems

If the system that you want to monitor uses NAT, or is located behind an ADSL router or firewall, you must configure your router to use port-forwarding and a static IP address from your Internet Service Provider.

After you install the HipCheck agent on the desired system, perform these steps:

  1. Make your ADSL router your default route. Use the command that is appropriate for your operating system.
    • For an SCO OpenServer and SCO UnixWare system, run this command: 
      # route add default <LAN-IPaddress>
    • For a Windows system, run this command: 
      C:\>  route add <LAN-IPaddress>
    Replace <LAN-IPaddress> with the IP address for the LAN side of your router (for example, 192.168.1.1).
  2. Verify that the HipCheck agent is running. Open a web browser and enter the URL that is appropriate for your operating system.
    • For an SCO OpenServer or SCO UnixWare system:
      http://<Agent-IPaddress>:8080/axis/services/SCOUnixAgentService
    • For a Windows system:
      http://<Agent-IPaddress>:8081/HIPcheck.asmx
    Replace <Agent-IPaddress> with the IP address for the system on which you installed the HipCheck agent (for example, 192.168.1.242).
    Note: If you cannot see these services, there is a problem with your agent installation. See Chapter 5, "Managing HipCheck agents" for troubleshooting information.
  3. Log in to your ADSL router/firewall and select the router's port redirection option.
  4. Create a service called "HipCheck".
    • If you installed an agent on an SCO UNIX system, redirect TCP/IP port 8080 to the IP address for the system where you installed the UNIX HipCheck agent, on port 8080. In this example, that would be 192.168.1.242 on port 8080.
    • If you installed an agent on a Windows system, redirect TCP/IP port 8081 (or the port number that you selected when you installed the agent) to the IP address for the system where you installed the Windows HipCheck agent, on port 8081. For example, 192.168.1.242 on port 8081.
    This step configures the router so that any requests for port 8080 or 8081 on the router are redirected to port 8080 or 8081 on the system running the UNIX or Windows HipCheck agent, respectively.
  5. Activate the new "HipCheck" service that you set up on the router.
  6. Determine your ADSL router's Internet (or WAN) IP address, so you can verify that you can access the HipCheck agent service from the Internet. Open a web browser and enter the URL that is appropriate to your operating system:
    • For SCO OpenServer and SCO UnixWare systems:
      http://<WAN-IPaddress>:8080/axis/services/SCOUnixAgentService
    • For Windows systems:
      http://<WAN-IPaddress>:8081/HIPcheck.asmx
    Replace <WAN-IPaddress> with your router's Internet IP address (for example, 83.217.55.123).
    You should see the same list of services that you see when you use the web address specified in Step 2.
    Note: If you cannot see these services, there is a problem with your router configuration. Consult your router documentation for further assistance.

Setting up systems, user privileges, and alert recipients on the HipCheck Mobility Server

Now you need to access the HipCheck Mobility Server and set up the systems that you want monitored by the HipCheck mobility service. You also need to configure permissions and responsibilities for the subscribers who will be running HipCheck clients.
Note: Before performing any of the tasks in this section, make sure that the HipCheck service has been activated by the account owner and that any subscribers who should have HipCheck monitoring privileges or alert responsibilities have been already been added to the account. See Getting Started with your Me Inc. Account -- Handbook for Account Owners and Account Managers for more information.

You do these tasks at the HipCheck Portal, a set of administration web pages available on the HipCheck Mobility Server.

To log in to the HipCheck Portal:

  1. Open a web browser and enter the following web address:
    https://<CommName>.hipcheck.me-inc.com/hipcheck/app
    where <CommName> is the Community Name for your Me Inc. account.
  2. Enter your Me Inc. account user name and password and click OK.
    You see the main HipCheck Portal page.

Complete the tasks described in these sections, in the following order:

After you complete these steps, proceed to the "Installing the HipCheck client" section.

Set up systems to be monitored

You need to provide information about the systems that you want to monitor on the HipCheck Mobility Server.
Note: Make sure that the appropriate HipCheck agent has been installed and is running on the desired system(s) before you proceed with the steps described here, otherwise you will not be able to successfully complete this procedure.

To set up the systems that you want monitored by HipCheck:

  1. Log in to the HipCheck Portal at:
    https://<CommName>.hipcheck.me-inc.com/hipcheck/app
    where <CommName> is the Community Name for your Me Inc. account.
  2. Click Create/Delete Systems.
  3. Click Create in the management toolbar.
    Note: You are prevented from setting up more systems than are currently supported by your HipCheck license. To purchase a HipCheck Server Month Extension license, to increase the number of systems that you can monitor, contact an authorized SCO partner.
    See Getting Started with your Me Inc. Account - Handbook for Account Owners and Account Managers for help upgrading HipCheck licenses.
  4. On the "Create New System" page, supply the following information for the system that you are setting up:
    Field  
    Enter the following...  
    System Name
    The Fully-Qualified Domain Name (FQDN) of the system. For example: system1.xyz.com.
    Alternately, you can enter the system's IP address.
    System OS Type
    Select the appropriate operating system from the pop-up list.
    System Description
    Descriptive text to help identify the system. This field is optional.
    System Admin User
    Administrator information is required to ensure that only authorized users can set up systems for monitoring. This field is automatically populated, based on the type of operating system selected in the "System OS Type" field. SCO UNIX systems require the root account; Windows systems require the default Administrator account. Localized versions of Administrator can be used.
    System Admin Password
    Enter the password that corresponds to the administrator account specified in the "System Admin User" field.
    Note: For Windows systems, you must supply the password for the default Administrator account. The password for a regular user account with administrative authority will not work.
    Note: If you are working within a Windows Domain group, use the password for the Administrator account for the system you are setting up. Do not use the domain-wide Administrator password.
    HipCheck sends the system admin user name and password to the HipCheck agent for authentication. The agent must be installed and running on the target system in order for this to work. If HipCheck cannot authenticate the user name and password, or if the authentication check fails, you cannot add the system.
    Note: The system admin user name and password entered on this screen are not saved by HipCheck.
    System URL
    Specify the web address for connecting to the system's HipCheck agent. Click Default to automatically enter the URL for a default agent installation. If you specified a non-default TCP/IP port when you installed the agent, enter the correct port number instead of the one supplied by the Default button.
    The default protocol is http, which is recommended for development and testing only. For production servers and agents, specify https instead of http if you want a secure connection. Passwords are sent over this connection so https is recommended if an insecure network, such as the Internet, is used.
    Agent Connection Type
    Specifies how the connection between the HipCheck Mobility Server and the HipCheck agent is configured. Must be one of the following choices:
    • Direct through http
      The server communicates directly with the agent using http or https. Recommended for development, evaluation, and test only.
      For more information, see "Direct through http" in Chapter 5, "Managing HipCheck agents".
    • Through proxy
      The server communicates with a proxy server, which then relays the message to the agent. The proxy can be located on the same system as the agent, or another system behind the firewall. Choosing this option displays the Proxy Server URL field. Enter the URL of the proxy. You can specify either the http or https protocol. The http protocol is recommended for development and test only. If https is chosen, a self-signed certificate is used.
      For more information, see "Through proxy" in Chapter 5, "Managing HipCheck agents".
    • Direct through https, default certificate
      The server communicates directly with the agent using https and a self-signed certificate (no proxy).
      For more information, see "Direct through https; default certificate" in Chapter 5, "Managing HipCheck agents".
    • Direct through https, user certificate
      The server communicates directly with the agent via https using client and server certificates. This connection type is not supported in the current release of HipCheck.
  5. Click Add to complete the setup process.
    Note: The HipCheck Mobility Server verifies the information that you provided by connecting to the HipCheck agent running on the system and checking the system's status. If the HipCheck Mobility Server cannot make a connection to the system -- either because of networking difficulties or because you have not yet installed the HipCheck agent on the system -- you have the following options:
    • Retry attempts to connect to the system again.
    • Cancel terminates the set-up process.

When a system is successfully set up, it is included in the HipCheck system monitoring list that is displayed on the "Create/Delete Systems" page. This list shows all of the systems that are set up to be monitored for which you have owner privileges.
Note: When you set up a system for monitoring at the HipCheck Portal, you are automatically assigned Owner privileges for the system. See "Set up user privileges and alert recipients" for more information on the Owner privilege and associated permissions.
Me Inc. account owners and account managers have Owner privileges for every system that is set up at the HipCheck Portal.

Next steps:

Set up user privileges and alert recipients

When you set up a system for HipCheck monitoring on the HipCheck Mobility Server, you are automatically assigned HipCheck Owner privileges, and also set up to receive alerts for problems that are detected on the system.

For each system that you own, you can authorize other subscribers or public groups in your Me Inc. account to have HipCheck monitoring or management privileges. You can also set up subscribers and public groups to receive alerts if problems are detected.

The HipCheck privilege levels that can be assigned to users and groups are:

Use the following table to determine the configuration steps needed to set up subscribers and groups with the desired combination of privilege levels and alert responsibilities.
HipCheck Portal permissions
HipCheck client permissions
Receive alerts?
Configuration steps
Management
Management
Yes
  1. Set privilege level to Owner
  2. Assign alerts
Management
Management
No
  1. Set privilege level to Owner
Monitoring
Management
Yes
  1. Set privilege level to Admin
  2. Assign alerts
Monitoring
Management
No
  1. Set privilege level to Admin
Monitoring
Monitoring
Yes
  1. Set privilege level to View
  2. Assign alerts
Monitoring
Monitoring
No
  1. Set privilege level to View

These configurations steps are described in the following procedure.

To assign user privileges and/or alert recipients for a system that you own:

  1. Log in to the HipCheck Portal at:
    https://<CommName>.hipcheck.me-inc.com/hipcheck/app
    where <CommName> is the Community Name for your Me Inc. account.
  2. Click Manage/View System Privileges and Attributes. You see the "Manage/View Privileges and Attributes" page.
    This page displays all of the systems in the HipCheck system monitoring list for which you have privileges. The "Your Privs" column indicates the level of privilege that you have for each system in the list. Note that account owners and account managers see the complete HipCheck system monitoring list; that is, every system that has been set up at the HipCheck Portal.

Assign HipCheck privileges to subscribers and groups

  1. Click Modify in the "Privileges" column for the desired system. The "Manage Privileges" page displays the current privilege list for the specified system.
    To add subscribers to the system's privilege list:
    • Click Add User in the management toolbar.
    • Select the checkbox next to the desired subscriber.
    Tip: You can select multiple subscribers if you want to assign them the same privilege level.
    Note, however, that checkbox selections are not maintained across multiple pages. If you cannot view the complete subscriber list on a single screen, add the selected subscribers on the current page before continuing to the next page.
    • Assign the desired privilege level to the selected subscriber(s) by clicking on one of the following links in the management toolbar: Add Owner, Add Admin, or Add Viewer.
      The subscriber is added to the privilege list as an authorized HipCheck user.
    • Repeat these steps to add additional subscribers to the privilege list.
    • Click Done in the management toolbar when you are finished.
    To add public groups to the system's privilege list:
    • Click Add Group in the management toolbar.
    • Select the checkbox next to the desired public group.
    Tip: You can select multiple groups if you want to assign the same privilege level to each group.
    Note, however, that checkbox selections are not maintained across multiple pages. If you cannot view the complete public group list on a single screen, add the selected groups on the current page before continuing to the next page.
    • Assign the desired privilege level to the members of the selected group(s) by clicking on one of the following links in the management toolbar: Add Owner, Add Admin, or Add Viewer.
      The public group is added to the privilege list and the group's members are now authorized HipCheck users. Groups are differentiated from subscribers in the list's "Type" column.
    • Repeat these steps to add additional public groups to the privilege list.
    • Click Done in the management toolbar when you are finished.

Configure users and groups to receive HipCheck alerts

  1. Click Modify in the "Alerts" column for the desired system.
    Note: Me Inc. subscribers and public groups must first be added to the system's privilege list, and therefore be authorized HipCheck users and groups, before you can assign them alert responsibilities.
    The "Manage Alerts" page shows the current alert list for the specified system. All of the HipCheck users displayed here, as well as every member of any public groups listed, receive alerts if the HipCheck agent detects problems with the system.
    To assign alerts to HipCheck users:
    • Click Add User in the management toolbar.
      The "Add Users to Alert List" page displays all of the HipCheck users who have been assigned a privilege level for the system and have not yet been set up to receive alerts.
    • Select the checkbox next to the desired HipCheck user(s).
    Note: Checkbox selections are not maintained across multiple pages. If you cannot view the complete list on a single screen, add the selected users on the current page before continuing to the next page.
    • Click OK in the management toolbar.
      The HipCheck user is added to the alert list.
    • Repeat these steps to assign alerts to additional users.
    • Click Done in the management toolbar when you are finished.
    To assign alerts to HipCheck groups:
    • Click Add Group in the management toolbar.
      The "Add Groups to Alert List" page displays all of the HipCheck groups that have been assigned a privilege level for the system and have not yet been set up to receive alerts.
    • Select the checkbox next to the desired HipCheck group(s).
    Note: Checkbox selections are not maintained across multiple pages. If you cannot view the complete list on a single screen, add the selected groups on the current page before continuing to the next page.
    • Click OK in the management toolbar.
      The HipCheck group is added to the alert list. Groups are differentiated from users in the list's "Type" column.
    • Repeat these steps to assign alerts to additional groups.
    • Click Done in the management toolbar when you are finished.
Next steps:

See also:

Installing the HipCheck client

The HipCheck client is the interface for monitoring system performance, performing administration actions, and responding to alerts to correct problems. There are two client versions available: a mobile client that runs on Windows Pocket PCs and a PC client that runs on Windows computers.

The HipCheck client can be used on the following platforms:
Supported mobile devices for the mobile client:
Supported operating systems for the PC client:
Windows Mobile 5.0 for Pocket PC
Windows XP (all editions)
Windows Mobile for Pocket PC 2003
Windows Server 2003 (all editions)

Windows 2000
Note: At this time, the HipCheck mobile client cannot be used on mobile devices that run Windows Mobile 5.0 Smartphone or Windows CE 5.0.

See "Before you begin" to confirm that your system configuration supports the use of the HipCheck client.

To install the HipCheck client, use the appropriate installation procedure:

Before you begin

The following resources must be configured on all systems running HipCheck clients:

Install the HipCheck client on Windows Mobile Pocket PCs

Installing the HipCheck mobile client requires the use of a Windows desktop or laptop computer, as well as your Pocket PC device. Prior to installing the HipCheck mobile client, verify that the Windows computer you will be using contains the following software:

To install the HipCheck mobile client on a supported Windows Mobile device:

  1. Connect your Windows Mobile Pocket PC to your Windows desktop or laptop, using the synchronization cable or cradle provided with your mobile device.
  2. Install Microsoft .NET Compact Framework Version 2.0 on your mobile device, if it is not already on the phone.
    Download the installer file:
    • Go to the HipCheck Portal at:
      https://<CommName>.hipcheck.me-inc.com/hipcheck/app
      where <CommName> is the Community Name for your Me Inc. account.
    • Log in, using your Me Inc. account user name and password.
    • Click on Downloads.
    • Click on the .NET Compact Framework Version 2.0 link in the "Windows Mobile Client" section and save the NETCFSetupv2.msi file to the desired location.
    Install .NET Compact Framework Version 2.0:
    • On your desktop or laptop, double-click on the NETCFSetupv2.msi file.
    • Follow the installation instructions.
      The installation copies necessary packages to your computer and then launches the ActiveSync Add/Remove Programs window and installs the software on your Pocket PC.
    • Restart Windows on your Pocket PC.
  3. Install the HipCheck mobile client on your Windows Mobile Pocket PC.
    Download the installer file:
    • At the HipCheck Portal, click on Downloads.
    • Click on the Mobile Client link in the "Windows Mobile Client" section and save the HipCheckMobileClient-1.0.2.msi file to the desired location.
    Install the HipCheck mobile client:
    • On your desktop or laptop, double-click on the HipCheckMobileClient-1.0.2.msi file. The HipCheck Client for Windows Mobile Setup Wizard starts. Click Next.
    • Accept the License Agreement terms, then click Next.
    • Select the desired installation directory, then click Next.
    • Click Next to confirm the installation.
      The Wizard copies necessary installation packages to your computer, then launches the ActiveSync Add/Remove Program window.
    • On your mobile device, click Yes when prompted to install HipCheck using the default application installation directory. HipCheck is installed.
    • Click OK when you are prompted to check your mobile device screen for additional installation steps. There are no other steps that need to be performed on the phone.
    • On your desktop or laptop, click Close to complete the installation.

The HipCheck mobile client is now available from the Programs screen on your Windows Mobile Pocket PC.

Next steps:

Install the HipCheck client on Windows computers

If you want to monitor systems from a Windows computer instead of from a Pocket PC, you can use the HipCheck PC client.

To install the HipCheck PC client on a supported Windows system:

  1. Install Microsoft .NET Framework Version 2.0, if it is not already on the system.
    Download the installer file:
    • Go to the HipCheck Portal at:
      https://<CommName>.hipcheck.me-inc.com/hipcheck/app
      where <CommName> is the Community Name for your Me Inc. account.
    • Log in, using your Me Inc. account user name and password.
    • Click on Downloads.
    • Click on the .NET Framework Version 2.0 link in the "Windows Native Client" section and save the dotnetfx.exe file to the desired location.
    Install .NET Framework Version 2.0:
    • Double-click on the dotnetfx.exe file.
    • Follow the installation instructions.
  2. Download and install the HipCheck PC client.
    Download the installer file:
    • At the HipCheck Portal, click on Downloads.
    • Click on the Windows Client link in the "Windows Native Client" section and save the HipCheckWin32Client-1.0.2.msi file to the desired location.
    Install the HipCheck PC client:
    • Double-click on the HipCheckWin32Client-1.0.2.msi file. The HipCheck Client for Windows Setup Wizard starts. Click Next.
    • Accept the License Agreement terms, then click Next.
    • Select the desired installation directory, then click Next.
    • Click Next to confirm the installation. HipCheck is installed on your system.
    • Click Close to complete the installation.

The HipCheck PC client is now available from the Me Inc folder in your Start menu.

Next steps:

Activating the HipCheck mobility service

You now need to authenticate the HipCheck client that you installed so it is authorized to connect to the HipCheck Mobility Server. Doing this activates your subscription to use the HipCheck mobility service, at which point you can begin monitoring configured systems.

To authenticate your HipCheck client:

  1. Run the HipCheck client for the first time.
    • For the mobile client, select Start > Programs and tap on the HipCheck icon.
    • For the PC client, select Start > All Programs > Me Inc > HipCheck.
  2. Complete the fields on the "Account Edit" screen:
    Field
    Enter the following....
    "Community"
    Enter the Community Name for your Me Inc. account, which is included in the welcome email that you received when your account subscription was created.
    "Domain"
    This field is automatically populated with the domain name for the HipCheck Mobility Server hosted by SCO. You should see:
    hipcheck.me-inc.com
    "App URL"
    This field is automatically populated with eps/epsmob.
    Do not change this data. This exact information is required for the HipCheck client to connect with the HipCheck Mobility Server.
    "User Name"
    Enter your Me Inc. account user name.
    "Password"
    Click Password not set..., then enter your Me Inc. account password.
    Tip: Select whether or not to see the password when you type it, using the Hide? checkbox. If you are using a mobile device, you may want to leave the Hide? checkbox unselected so that you can be sure of what you are typing.
    When you are finished, click OK.
  3. Select the Set as current checkbox.
  4. Click Save.
  5. While the HipCheck client contacts the HipCheck Mobility Server, you see an "Authenticating" dialog.
    Note: If you have not yet accepted the Subscriber License Agreement at the HipCheck Portal, you will be prompted to do so now. Read the contents of the Agreement and then click Accept.
    When you see the "Account authenticated and saved" message, click OK.
  6. Once you successfully authenticate with the HipCheck Mobility Server, the HipCheck client is launched. The list of systems that you can monitor or manage -- based on the settings made earlier in the "Setting up systems, user privileges, and alert recipients on the HipCheck Mobility Server" section -- is retrieved from the HipCheck Mobility Server. This operation may take a few seconds.
  7. See Chapter 3, "Using the HipCheck client" for help monitoring and managing systems using HipCheck views, alerts, and actions.
TOC PREV NEXT