AppViewXS: Getting Started Guide

System Requirements

Supported Web and Application Servers

AppViewXS requires that a web server and an application manager be present to operate. As a Java application with standard web architecture, AppViewXS should operate correctly within a wide range of environments. The following is a list of the Web server/Application manager combinations which have been thoroughly tested.

Browser Requirements for Studio

The following browser requirements apply to the Studio only:

Netscape Navigator 4.75 or higher (Windows 2000/XP), with the latest Java Virtual Machine (JVM)
Microsoft Internet Explorer 5.0 or higher with SP1 (Windows 2000/XP), IE 5.5 and higher with the latest JVM
Minimum platform requirements: 266 MHz Pentium II class CPU with 64MB or better, Java Development Kit (JDK) 1.1.8, and 30 MB free disk space

Note: Although the Studio is a servlet that is installed on the Web Server, customization must be performed on a 32-bit Windows system. All customization is automatically stored on the server. It is also important, when saving files, maps, or graphics, that only lowercase letters be used in filenames. This prevents any conflicts when migrating files to a system that only supports lowercase filenames.

Host Connectivity Requirements

One of the following is required for AppViewXS to connect properly to a host:

• IBM mainframe using TN3270 connectivity directly or through a TN server
• IBM AS/400 using TN5250 connectivity
• Hewlett-Packard NonStop using TN6530 connectivity

Installation of AppViewXS

The AppViewXS Rendition Engine (the AppViewXS servlet) and its public Internet files must be installed on a web server and must run under an application server. Instructions for configuring supported application servers are provided in the included help files. AppViewXS Installation creates sub-directories in the web server’s Public Internet Directory and the application server’s Servlet Root Directory

In all cases, the documentation assumes that the administrator is familiar with servlets and with their Web server’s software. The documentation also assumes a “standard” installation of both, the Web and application server. Should your configuration differ, please adjust accordingly.

ZIP files have been provided for administrators of non-windows Web servers. The setup of servlets is similar across platforms.

Your Web and Application servers should be set up prior to installing AppViewXS’s server components.

Note: You must have Java installed on your machine in order to complete the installation. The install programs have the same Java requirements as the application servers under which they run.

To install the AppViewXS Rendition Engine and Internet directory files.

1. Install and configure both your Web and Application servers.

2. On the installation CD, locate and open the install directory.

3. Move all the installation files to your platform’s hard drive (optional). You can create a temporary directory for this purpose.

4. To install AppViewXS:

-GUI installation – Find the executable file for your platform: appviewxs_win32.exe (win), appviewxs_solaris_sparc.bin (unix), appviewxs_solaris_x86.bin (unix) or appviewxs_linux.bin (linux). Start the installation by double-clicking on the executable file or through the command line. There is also an applet installation in the applet directory. This can be started through the setup.htm page. Java installation can be started by using the following command: java -jar suite.jar

-Non-GUI installation – Find the executable file for your platform: appviewxs_win32.exe (win), appviewxs_solaris_sparc.bin (unix), appviewxs_solaris_x86.bin (unix) or appviewxs_linux.bin (linux). Start the installation by using the following command: executable_file_name -console -is:javaconsole. Java installation can be started by using the following command: java -jar suite.jar -console

5. Follow the prompts as generated by the installation program.

6. Enter the location of the AppViewXS documentation and uninstaller:

e.g. C:\Program Files\Crystal Point\AppViewXS1_0

Note: This is the path for the Studio documentation you will require during customization.

7. Enter the location of the AppViewXS Public Internet Directory (Web Server Component)

e.g. /Inetpub/wwwroot/appviewxs
e.g. /IBM HTTP Server/htdocs/appviewxs
e.g. /Netscape/Server4/docs/appviewxs
e.g. /iPlanet/Servers/docs/appviewxs
e.g. /tomcatt/webapps/appviewxs
e.g. /apache/htdocs/appviewxs

8. Enter the location of the AppViewXS Rendition Engine (Servlet Component)

e.g. /WebSphere/AppServer/hosts/default_host/default_app/servlets
e.g. /WebSphere/AppServer/classes
e.g. /Netscape/Server4/manual/https/servlets
e.g. /iPlanet/Servers/manual/https/servlets
e.g. /tomcat/webapps/ROOT/WEB-INF/classes
e.g. /NewAtlanta/ServletExecAS/se-yourserver/classes

9. Enter the URL to the AppViewXS start-up page (Portal.html)

e.g. http://yourserver/appviewxs

10. Enter the URL to the AppViewXS servlet

e.g. http://yourserver:8080/servlet

11. Enter the AppViewXS servlet name

e.g. appviewxs

Note: The servlet URL and the URL configured under the web application server to invoke AppViewXS must be in agreement, and the AppViewXS servlet name must also be in agreement with the web application server URL.

12. You will then be presented with the information that you have entered for verification. Click Next to accept the information you entered and install or click Back to modify the information. Click Cancel to cancel the installation.

13. After AppViewXS has been installed, you need to copy the following license files, resqportal.reg and portaladm.reg, from the CD into the Servlet Component directory.

e.g. /WebSphere/AppServer/hosts/default_host/default_app/servlets directory
e.g. /WebSphere/AppServer/classes directory
e.g. /Netscape/Server4/manual/https/servlets directory
e.g. /iPlanet/Servers/manual/https/servlets directory
e.g. /tomcat/webapps/ROOT/WEB-INF/classes directory
e.g. /NewAtlanta/ServletExecAS/se-yourserver/classes directory

The installation CD also contains a zip_files directory. In there you can find servlet.zip and web.zip files, which can also be used to install AppViewXS. Servlet.zip file contains a servlet component, web.zip file contains a web server component. However, when installing through the zip files, the HTML pages and properties files must be edited manually. See Getting Started for more information.