---------------------------------------------------------- QuickStart Guide Sun Chili!Soft ASP 3.6.2 for Linux ---------------------------------------------------------- (c) Copyright Chili!Soft, Sun Microsystems Inc. 2002 ---------------------------------------------------------- Contents ---------------------------------------------------------- 1. Introduction 2. System Requirements 2.1 Hardware 2.2 Operating System 2.3 Web Server 2.4 Supported Software 3. Installing and Uninstalling Sun Chili!Soft ASP 3.6.2 3.1 First Steps 3.2 Installation 3.3 Important Notes about Linux Installations 3.4 Upgrading an Existing Installation 3.5 Uninstalling Sun Chili!Soft ASP 3.6.2 4. Getting Started with Sun Chili!Soft ASP 4.1 Product Documentation 4.2 Sample ASP Applications 4.3 The 10-Step Tour 4.4 Diagnostic Applications 5. Contacting Customer Support 6. Legal Notice ---------------------------------------------------------- 1. Introduction ---------------------------------------------------------- Welcome to Sun Chili!Soft ASP 3.6.2 for Linux. This QuickStart Guide provides system requirements, installation instructions, and basic information about getting started with Sun Chili!Soft ASP. Detailed information about configuring, managing, and using Sun Chili!Soft ASP 3.6.2 can be found in the Sun Chili!Soft ASP product documentation. Application notes and the latest information about this release is also provided in the Sun Chili!Soft ASP 3.6.2 README. You should review the README before proceeding with your installation. The README can be found in the same directory as this QuickStart Guide. On the CD-ROM, the README is in the root directory. The README can also be found on the Sun Chili!Soft Web site at: http://www.chilisoft.com/caspdoc Our goal is to make Sun Chili!Soft ASP the perfect product for you. To do that, we need your feedback. Please contact us with any suggestions and comments you might have. Send your comments to us via the Web form at: http://www.chilisoft.com/support/chili.eval.asp ---------------------------------------------------------- 2. Installation Requirements ---------------------------------------------------------- This section lists the hardware and software required for installing and running Sun Chili!Soft ASP 3.6.2 for Linux. 2.1 HARDWARE ------------- * 256 MB RAM * Pentium-class processor (x86) * 140 MB free hard disk space 2.2 OPERATING SYSTEM --------------------- Sun Chili!Soft ASP for Linux runs on the following operating systems: * Red Hat Linux 7.2 (2.4 kernel, GLIBC 2.2.4) * SuSE 7.3 Professional (2.4 kernel, GLIBC 2.2.4) * Mandrake Linux 8.1 (2.4 kernel, GLIBC 2.2.4) * Debian 2.2r5 (2.2 kernel, GLIBC 2.1.3) 2.3 WEB SERVER --------------- You must be running one of the following Web servers: * Apache Web Server 1.3.19 DSO * Apache Web Server 1.3.22 DSO * iPlanet Web Server, Enterprise Edition 6.0 SP1 * Zeus Web Server 4.0 NOTE: Sun Chili!Soft ASP may install to other versions of the supported Web servers listed above. However, versions not listed have not been certified to run with Sun Chili!Soft ASP 3.6.2, and their use is not supported by Sun Chili!Soft Customer Support. 2.4 SUPPORTED SOFTWARE ----------------------- The following software is supported and/or installed by Sun Chili!Soft ASP 3.6.2. a. Database ------------ Sun Chili!Soft ASP 3.6.2 includes DataDirect Connect ODBC 4.0 drivers (DataDirect is a former business unit of MERANT). ODBC drivers are provided for the following databases: * DB2 Universal Database (UDB) v7.1 * dBASE 5 * Informix Dynamic Server 2000 (9.20) * Microsoft SQL Server 7.0 SP1 * Microsoft SQL Server 2000 SP1 * Microsoft SQL Server 6.5 (via SequeLink 4.51a) * Microsoft Access 2000, 97, and 95 (via SequeLink 4.51a) * MySQL 3.22.30 and higher * Oracle 8i (8.1.6 and 8.1.7) * Oracle 9i * PostgreSQL 6.5.2 and higher * Sybase Adaptive Server Enterprise 11.9.2 * Sybase Adaptive Server Enterprise 12.5 * Text Files NOTE: Sun Chili!Soft ASP 3.6.2 may work with other versions of the databases listed above. However, versions not listed have not been tested to run with Sun Chili!Soft ASP 3.6.2, and their use is not supported by Sun Chili!Soft Customer Support. ODBC drivers are installed automatically by the Sun Chili!Soft ASP setup program. Following installation, you must configure the drivers for the data sources being used. For more information, see "Configuring a Database" in "Chapter 3: Managing Sun Chili!Soft ASP" in the product documentation. For information about accessing the product documentation, see section 4 in this guide. NOTE: To provide remote database connectivity with Microsoft Access and Microsoft SQL Server 6.5 databases, Sun Chili!Soft ASP 3.6.2 includes the client portion of the DataDirect SequeLink 4.51a software. On the Windows machine that contains your database, you also must download and install the server portion of this software from Sun Chili!Soft. For more information, see "Configuring SequeLink" in the product documentation ("Chapter 3: Managing Sun Chili!Soft ASP" => "Configuring a Database"). b. Java Runtime Environment ---------------------------- Sun Chili!Soft ASP 3.6.2 includes the Java Runtime Environment (JRE) 1.3.1 for Sun Chili!Beans. While JREs 1.2.x and 1.3.x are supported, and the Java 2 Runtime Environment can also be used, the use of JRE 1.3.1 is strongly recommended. Chili!Beans enables you to use Java class files as components called from VBScript or JScript. To use Chili!Beans, a Java runtime environment must be installed on the machine, and Chili!Beans must be enabled from the Administration Console. For more information, see "Chili!Beans Component Reference" in "Chapter 5: Developer's Reference" in the product documentation. c. Microsoft FrontPage 2002 Server Extensions ---------------------------------------------- Sun Chili!Soft ASP enables you to run ASP pages generated by Microsoft FrontPage. Microsoft FrontPage Server Extensions provide services to the Web server that work in conjunction with Sun Chili!Soft ASP to provide FrontPage functionality to computers not running Microsoft Windows NT or Windows 2000 and Internet Information Services (IIS). FrontPage Server Extensions are no longer installed with Sun Chili!Soft ASP; you must obtain them from Microsoft. For more information, see "Enabling FrontPage Publishing" in "Chapter 3: Managing Sun Chili!Soft ASP" in the product documentation. ---------------------------------------------------------- 3. Installing Sun Chili!Soft ASP 3.6.2 ---------------------------------------------------------- The setup program takes you through the steps required to install Sun Chili!Soft ASP 3.6.2 on Linux. As you perform the installation, you have many options to accept default configuration settings or to specify your own. The setup program installs the following components on the target server: * Sun Chili!Soft ASP Server * Sun Chili!Soft ASP Administration Console * Sun Chili!Beans support (the use of Chili!Beans is optional). Sun Chili!Soft ASP 3.6.2 includes Java Runtime Environment (JRE) 1.3.1. The use of this specific JRE version is not required, but is strongly recommended. * Sun SpicePack components * Apache Web Server 1.3.19 DSO ("bundled" with Sun Chili!Soft ASP 3.6.2) NOTE: If you are upgrading an existing installation of Sun Chili!Soft ASP for Linux, follow the instructions in section 3.4 of this guide. 3.1 FIRST STEPS ---------------- Before you begin your installation, make sure you meet the following requirements: * You are logged in as root. * You have 60 MB of hard disk space available to extract the installation files. * Your hardware and software meet the requirements listed in section 2 of this guide. * You know your product serial number. Sun Chili!Soft ASP requires a valid serial number to run. If you install Sun Chili!Soft ASP without a serial number, you will receive an evaluation license. * You know which language you want Sun Chili!Soft ASP to support (English - US, Japanese Shift-JIS, and so on). You can change the language after installation using the Sun Chili!Soft ASP Administration Console, as described in "Configuring International Support" in the product documentation ("Chapter 3: Managing Sun Chili!Soft ASP" => "Managing the ASP Server"). * If you choose to customize settings for the Sun Chili!Soft ASP Administration Console, you must specify a username and password for accessing the console. Be sure to specify a password that you can remember, or else plan to store the password in a secure location. If you forget your password you can run the admtool utility and set a new one, as described in "Configuring Usernames and Passwords" in the product documentation ("Chapter 3: Managing Sun Chili!Soft ASP" => "Using the Administration Console"). If you do not choose the customize settings option, the username is set as 'admin' and the password as 'root'. To protect the security of your server, you should run the admtool and change these settings as soon as possible following installation. * To use Chili!Beans, a Java runtime environment (JRE) must be installed on the machine, and Chili!Beans must be enabled from the Administration Console. During installation, Sun Chili!Soft ASP installs JRE 1.3.1, unless you choose to install another supported version (1.2.x or 1.3.x). Note that while you have the option to install a different JRE, and the Java 2 Runtime Environment can also be used, the use of JRE 1.3.1 is strongly recommended. Chili!Beans enables you to access Java objects and classes from an ASP script. For more information, see "Chili!Beans Component Reference" in "Chapter 5: Developer's Reference" in the product documentation. * If you are upgrading from a previous version of Sun Chili!Soft ASP, you must install Sun Chili!Soft ASP 3.6.2 into the same directory as your previous installation. Also, be sure to review section 3.4 of this guide. * If you are installing Sun Chili!Soft ASP to a Zeus Web server, you must take additional steps prior to installation. See "Installing Sun Chili!Soft ASP to a Zeus Web Server" below. If you are not installing to a Zeus Web server, proceed with the installation as described in section 3.2 of this guide. Installing Sun Chili!Soft ASP to a Zeus Web Server --------------------------------------------------- Before you can install Sun Chili!Soft ASP to a Zeus Web server you must first enable NSAPI (Netscape's Web server API) for a Zeus Virtual Server, and then copy the NSAPI configuration files to the proper location. For detailed information beyond what is provided here, see your Zeus product documentation. NOTE: When configuring the Zeus Web server to run with Sun Chili!Soft ASP, do not specify the Web server hostname as the fully qualified domain name (or "server address"). If you do, the Test DSN feature of the Administration Console will not work. Instead, use the hostname only. For example, do not use: hostname.domain.com. Instead, use: hostname. To enable NSAPI for a Zeus Virtual Server ------------------------------------------ 1. Go to the 'Configuration Summary' page for the Zeus Virtual Server. 2. Go to the 'Enabling NSAPI Functionality' page by clicking the 'NSAPI' link. 3. Click the 'Enabled' button, write down the value of [path_prefix] for future reference, and then click the 'Apply changes' button. 4. Commit the changes by clicking the yellow sun graphic in the top right section of the page, and then click the 'Commit' button. NSAPI has been enabled for a Zeus Virtual Server. You must now copy the NSAPI configuration files, as described in the following procedure. To copy the NSAPI configuration files -------------------------------------- Zeus provides copies of the NSAPI configuration files, which are typically located in the following directory: [zeushome]/webadmin-4.0r1/docroot/nsapi-skel/ where [zeushome] is the root of your Zeus installation (/usr/local/zeus). After locating the files, use the following commands: #> mkdir -p [path_prefix]/https-[virtual_server_name]/config #> cd [path_prefix]/https-[virtual_server_name]/config #> cp -r [zeushome]/webadmin-4.0r1/docroot/nsapi-skel/* . where [path_prefix] is the value you wrote down in step 3 of the previous procedure (the default will be [zeushome]/ns-config), and [virtual_server_name] is the name of the Zeus Virtual Server. Zeus is now configured correctly for installing Sun Chili!Soft ASP. 3.2 INSTALLATION ----------------- To install Sun Chili!Soft ASP ------------------------------ 1. If you are installing Sun Chili!Soft ASP 3.6.2 from the CD-ROM, go to step 2. If you are downloading Sun Chili!Soft ASP 3.6.2 from the Web, download the casp-3.6.2-linux.tar file to a temporary directory, and then extract the installation files using the following command: #> tar -xvf casp-3.6.2-linux.tar This step creates the following files in the temporary directory, which you can delete after completing the installation: * A QuickStart Guide with installation instructions * A README file containing the latest product information * The install.sh installation script * A package/EULA file containing the End-User License Agreement * A package directory containing files required to install Sun Chili!Soft ASP 2. Run the install.sh script by using the following command. For downloaded versions, this script is located in the temporary directory you created in the previous step. For CD-ROM versions, this script is located on your installation CD-ROM. #> ./install.sh 3. Review the End-User License Agreement (EULA) that displays. Enter 'yes' if you agree with its conditions. You must type the entire word, 'yes'. - or - Enter 'no' if you do not agree. If you enter 'no', the Sun Chili!Soft ASP setup program quits the installation. 4. On the next screen, press 'Enter' to accept the default Sun Chili!Soft ASP installation directory (/opt/casp). - or - Enter the absolute path name of a different installation directory. Make note of this location so you can easily find the Sun Chili!Soft ASP files at a later time. NOTE: To upgrade from the previous version of Sun Chili!Soft ASP, you must specify the installation directory of your existing installation. 5. If the setup program detects a previous installation of Sun Chili!Soft ASP in the specified directory, you will be prompted to uninstall the previous version (if a previous installation is not detected, you will go to step 6): Enter 'n' (no) to change the installation directory or cancel the installation. - or - Enter 'y' (yes) to uninstall the previous installation. You will then be prompted to proceed. At this confirmation prompt, enter 'n' to cancel the installation, or 'y' to uninstall the previous version. If you enter 'y', the previous version will be uninstalled by the installer. Once that process is finished, press 'Enter' to continue. NOTE: At the end of the Sun Chili!Soft ASP installation process you will be prompted to import your settings. 6. On the next screen, enter 'y' (yes) if you know the product serial number. - or - Enter 'n' (no) if you do not know the serial number. An evaluation license will be installed (go to step 8). NOTE: iPlanet 6.0 users are already licensed to use this product and do not need to enter a serial number. If you are using iPlanet 6.0, enter 'n' and you will receive a full, unlimited license (go to step 8). 7. When prompted, enter the product serial number. 8. Sun Chili!Soft ASP 3.6.2 includes a ready-to-run Apache 1.3.19 Web server configured with support for Microsoft FrontPage 2002 Server Extensions (the extensions themselves are not installed) and EAPI (Extended API). If you have not yet configured a Web server, you have the option to install this preconfigured Apache Web server. Enter 'y' (yes) to install the preconfigured ("bundled") Apache 1.3.19 Web server, and proceed to the next step. - or - Enter 'n' (no) if you do not want to install the preconfigured Apache Web server, and proceed to step 10. NOTE: Installing the preconfigured Apache Web server will not affect any other installed Web server. Make sure you do not install the preconfigured Apache Web server to the same port as that of an existing Web server. 9. The Apache Web server has many settings that you can choose and configure. Specify the desired configuration option for the preconfigured Apache 1.3.19 Web server: Enter '1' ('Default configuration') to direct Sun Chili!Soft ASP to automatically configure all settings for you. - or - Enter '2' ('Specify only the Web server listen port') to specify only the port number that the Apache Web server will listen on, and then specify the port. - or - Enter '3' ('Customize the configuration') to specify the configuration of many different settings, and then respond to the prompts. NOTE: All Apache configuration settings can be changed manually after installation by editing the Apache configuration file. 10. On the next screen, press 'Enter' to accept the default language (English - US). - or - Enter the number of a language shown in the list. 11. On the next screen, enable or disable Chili!Beans support as desired: Select 'Use the bundled 1.3.1 JRE' to enable Chili!Beans support and install JRE 1.3.1 (this is the recommended JRE), and then respond to the prompts. - or - Select 'Specify the path to an existing JRE' to specify the path to an existing JRE (JRE versions 1.2.x and 1.3.x are supported), or type 'none' to return to the previous screen, and then respond to the prompts. - or - Select 'Disable Java support' to disable Chili!Beans support, and then respond to the prompts. - or - Select 'Keep your current settings'. 12. The next screen provides options for choosing the Web server to configure with Sun Chili!Soft ASP. If you want the setup program to search your system and generate a list of installed Web servers from which to choose, enter the number of the desired search option (1, 2, or 3). If you select one of these search options, skip to step 15. - or - If you want to skip this search and provide information about the Web server, enter '4' ('Don't search'). The installer will not search for the Web server, and instead takes you to step 13. NOTE: If you chose to install the preconfigured ("bundled") Apache 1.3.19 Web server in step 8, go to step 15. 13. On the next screen, enter the number of the type of Web server to configure: '1' for Apache, '2' for iPlanet, or '3' for Zeus, and go to step 14. - or - To cancel the user-specified Web server configuration, enter '4'. If you choose this option, the setup program returns you to the previous screen. From this screen you can choose another option, as described in step 15. 14. At the prompts, enter the path of your Web server. If you do not know the correct path, type 'none' to cancel (this takes you to step 15). If you selected Apache in step 13, you will be prompted for the Web server binary. After all information has been added correctly, the installer takes you to step 15. There you will be able to select the Web server that was just added. 15. On the next screen, enter the number of the Web server you want the setup program to configure to run with Sun Chili!Soft ASP, and go to step 16 (if you selected option 1, 2, or 3 in step 12). - or - To provide information about the Web server to configure, enter the number for the option, 'Specify the Web server'. If you choose this option, follow the instructions in step 13. - or - To perform another search for installed Web servers, enter the number for the option, 'Attempt to auto-detect more Web servers'. If you choose this option, follow the instructions in step 12. - or - If you do not want to configure a Web server during installation, enter the number for the option, 'Do not configure a Web server', and then go to step 18. If you choose this option, the first time you open the Sun Chili!Soft ASP Administration Console you will be prompted to configure the ASP Server and a Web server. 16. On the next screen, verify the information that the setup program displays about your Web server. If the information is incorrect, the Sun Chili!Soft ASP installation could fail. If the installation does fail, you can run the installation script again. If you do this, it is recommended that you first run the uninstall script, as described in section 3.5 of this guide. If the information on the screen is correct, enter 'y' (yes), and go to step 17. - or - If the information is incorrect, enter 'n' (no). The setup program returns you to the previous screen (step 15). 17. On the next screen, choose a configuration option for the ASP Server: Enter '1' to choose a default configuration, and go to step 18. - or - Enter '2' to choose a custom configuration, and enter the following information at the prompts: 'Enable samples on this Web server?' Enter 'y' (yes) if you want the setup program to install and configure the Sun Chili!Soft ASP samples on your Web server, or enter 'n' (no). 'Enable documentation on this Web server?' Enter 'y' (yes) if you want the setup program to enable the Sun Chili!Soft ASP documentation on your Web server, or enter 'n' (no). If you enter 'n', the documentation will be available from the Administration Console, but not from the Sun Chili!Soft ASP Start Page. 'Start the ASP Server on system boot?' Enter 'y' (yes) if you want the setup program to start Sun Chili!Soft ASP automatically each time you start the computer, or enter 'n' (no). 'Would you like this [Web server] restarted?' Enter 'y' (yes) if you want the setup program to automatically restart the Web server after completing Sun Chili!Soft ASP installation, or enter 'n' (no). - or - Enter '3' to choose another Web server to configure for Sun Chili!Soft ASP, and follow the instructions in step 12. 18. On the next screen, select a configuration option for the Administration Console. When you choose 'Default configuration', the setup program configures the console using default settings. With this option, it specifies the username as 'admin' and the password as 'root'. To protect the security of your server, it is strongly recommended that you change these settings as soon as possible. For information about doing this, see "Configuring Usernames and Passwords" in the product documentation ("Chapter 3: Managing Sun Chili!Soft ASP" => "Using the Administration Console"). If you choose 'Custom configuration', enter the following information at the prompts: 'Administration Console port number': Enter the number of the port on which the Web server should listen for requests for the Administration Console, or press 'Enter' to accept the default. 'Automatically start the Administration Console on system startup': Enter 'y' (yes) if you want the Sun Chili!Soft ASP Administration Console to start automatically each time you start the computer, or enter 'n' (no). 'Type the username': Enter the administrator username. 'New password': Enter the administrator password, which is required to access the Administration Console. Be sure to make note of this password, because you cannot access the Administration Console without providing it. 'Confirm password': Reenter the password. 19. The next screen provides summary information about your Administration Console configuration. Be sure to make note of this information or else print this screen for future reference. When finished, press 'Enter' to complete the installation. 20. If you are upgrading from the previous version for Linux, and the setup program was able to export the settings from your previous installation, you will be prompted to import these settings into your new installation. Enter 'y' (yes) to import your settings. - or - Enter 'n' (no) if you do not want to import your settings. The setup program then completes the installation and writes a summary file to: [C-ASP_INSTALL_DIR]/logs/install_summary where [C-ASP_INSTALL_DIR] is the directory in which you installed Sun Chili!Soft ASP (/opt/casp by default). Be sure to print the information contained in the install_summary file for future reference. NOTE: With Sun Chili!Soft ASP for Linux on Zeus, you must access your Web server by using the "server address" specified in the Zeus Administration Console, rather than the address specified in the install_summary file. Before running your installation of Sun Chili!Soft ASP 3.6.2, see "Important Notes about Linux Installations" in section 3.3 of this guide. If you are upgrading from a previous version of Sun Chili!Soft ASP for Linux, see section 3.4 of this guide. 3.3 IMPORTANT NOTES ABOUT LINUX INSTALLATIONS ---------------------------------------------- Before running your installation of Sun Chili!Soft ASP 3.6.2, review the following information: * If you chose the default configuration for the Administration Console, the setup program configured the username as 'admin' and the password as 'root'. To protect the security of your server, it is strongly recommended that you change the username and password as soon as possible. For more information, see "Configuring Usernames and Passwords" in the product documentation ("Chapter 3: Managing Sun Chili!Soft ASP" => "Using the Administration Console"). * You use the Administration Console to start and stop the Sun Chili!Soft ASP Server and to change configuration settings. You can access the Administration Console by typing the following URL in your Web browser address bar: http://[HOSTNAME]:[PORT] where [HOSTNAME] is the valid DNS name or IP address of the Apache Web server running the Sun Chili!Soft ASP Administration Console, and [PORT] is the port on which the Administration Console is configured to run (5100 by default). The URL for accessing the Administration Console is provided in the following file: [C-ASP_INSTALL_DIR]/logs/install_summary where [C-ASP_INSTALL_DIR] is the directory in which you installed Sun Chili!Soft ASP (/opt/casp by default). * If you did not configure a Web server to run with Sun Chili!Soft ASP during installation, the first time you open the Administration Console you will be prompted to install a Web server. * The Sun Chili!Soft ASP setup program makes certain changes to the configuration files for the associated Web server. For more information, see "Changes to Web Server Configuration Files" in the product documentation ("Chapter 2: Installing and Configuring Sun Chili!Soft ASP" => "Installing and Uninstalling Sun Chili!Soft ASP"). * You can change some of the options that were configured during installation, such as the Web server with which Sun Chili!Soft ASP is configured to run, and the status of Java support (enabled or disabled). For more information, see "Changing Installation Options after Installation" in the product documentation ("Chapter 2: Installing and Configuring Sun Chili!Soft ASP" => "Installing and Uninstalling Sun Chili!Soft ASP"). * To use Chili!Beans, a Java runtime environment (JRE) must be installed on the machine, and Chili!Beans must be enabled from the Administration Console (JRE 1.3.1 is included with Sun Chili!Soft ASP 3.6.2 and is the recommended version). If you did not install a JRE during the installation of Sun Chili!Soft ASP, you can do so by following the instructions in "Enabling Java Support" in the product documentation ("Chapter 2: Installing and Configuring Sun Chili!Soft ASP" => "Installing and Uninstalling Sun Chili!Soft ASP" => "Changing Installation Options after Installation"). * After you have installed Sun Chili!Soft ASP 3.6.2, use the diagnostic applications to verify that your installation is working correctly. You can access the diagnostics from the following URL: http://[HOSTNAME]/caspsamp/diagnostics.htm where [HOSTNAME] is the hostname of the Web server configured to run with Sun Chili!Soft ASP. * Important summary information about the installation is located in the following file: [C-ASP_INSTALL_DIR]/logs/install_summary where [C-ASP_INSTALL_DIR] is the directory in which you installed Sun Chili!Soft ASP (/opt/casp by default). Be sure to print this information for future reference. * Certain Sun Chili!Soft ASP 3.6.2 settings have important implications for the security of the Sun Chili!Soft ASP Server. To ensure that the settings are appropriately configured for your specific environment, see "Securing the Server" in the product documentation ("Chapter 3: Managing Sun Chili!Soft ASP" => "Managing the ASP Server"). 3.4 UPGRADING AN EXISTING INSTALLATION --------------------------------------- Sun Chili!Soft ASP 3.6.2 automatically upgrades many of your settings from an existing installation. To perform an upgrade from Sun Chili!Soft ASP 3.6 to Sun Chili!Soft ASP 3.6.2, follow the instructions in sections 3.1 and 3.2 in this guide. In addition, review the information listed below and take any necessary steps. * The Sun Chili!Soft ASP 3.6.2 setup program preserves the settings from your Sun Chili!Soft ASP 3.6 installation, and then imports those settings into your new Sun Chili!Soft ASP 3.6.2 installation. The settings imported from your existing installation will override the settings that you configure during installation, with the exception of Chili!Beans support. During installation, you must configure Chili!Beans support and select the option for the bundled JRE 1.3.1 (or specify a path to a different JRE). While JREs 1.2.x and 1.3.x are supported, and the Java 2 Runtime Environment can also be used, the use of JRE 1.3.1 is strongly recommended. Java support must be configured, even if it was enabled in the installation you are upgrading. NOTE: SpicePack settings and Sybase DSNs are not migrated when upgrading to Sun Chili!Soft ASP 3.6.2. * The new installation will completely overwrite your existing installation. If there are any files in your current Sun Chili!Soft ASP installation directory that you want to preserve, copy them to another location. Otherwise, they will be lost. * If necessary, upgrade your Web server to meet the requirements listed in section 2.3 of this guide. * Back up your existing installation prior to beginning the upgrade. * Do not upgrade a mission-critical production server. Performing the upgrade and taking the additional configuration steps required might keep your server offline for an unacceptably long period of time. If possible, you should mirror the production server to a nonproduction server, perform the upgrade, and then test and debug the upgraded server before deploying it in your production environment. When the setup program has completed the installation, do the following: * Verify that any system DSNs defined for your previous installation are working correctly. For more information, see "Testing a DSN" in the product documentation ("Chapter 3: Managing Sun Chili!Soft ASP" => "Configuring a Database" => "Configuring Data Source Names"). If system DSNs are not functioning you can create or edit them as needed, as described in the same section in the product documentation. You can find the configuration information for the system DSNs that were defined for your previous installation in the following file: [C-ASP_INSTALL_DIR]/casp/INSTALL/settings.import where [C-ASP_INSTALL_DIR] is the path name of the Sun Chili!Soft ASP 3.6.2 installation directory. 3.5 UNINSTALLING SUN CHILI!SOFT ASP 3.6.2 ------------------------------------------ You uninstall Sun Chili!Soft ASP by running the script named 'uninstall' located in the Sun Chili!Soft ASP installation directory. When you run the uninstall program, you can delete all of the directories and files contained in the Sun Chili!Soft ASP installation directory. Before you run the uninstall program, make copies of any files contained under this directory that you do not want to lose. To uninstall Sun Chili!Soft ASP 3.6.2 -------------------------------------- NOTE: To perform this procedure you must be logged in as root on the computer running Sun Chili!Soft ASP. 1. From the Sun Chili!Soft ASP installation directory (/opt/casp by default), type the following command: #> ./uninstall 2. Choose the number of the desired uninstall method. Choose '1. Uninstall the entire product' to remove all Sun Chili!Soft ASP components and all files and directories under the installation directory. If you choose this option, go to step 5. - or - Choose '2. Perform a stage-based uninstall' to select which components to uninstall. If you choose this option, go to step 3. - or - Choose '3. Cancel the uninstall' to stop the uninstall without removing any files. 3. If you chose option '2. Perform a stage-based uninstall', you are prompted to select the components to uninstall. At the prompts, enter the number of the component(s) to remove. 4. Uninstall the Web server-Sun Chili!Soft ASP association, responding to the prompts as desired. 5. Delete the directories and files in the Sun Chili!Soft ASP installation directory. Before deletion you are prompted to stop the uninstall and make backup copies of any files. To perform this action, enter 'y' (yes). To continue the uninstall and delete the directories and files, enter 'n' (no). ---------------------------------------------------------- 4. Getting Started with Sun Chili!Soft ASP ---------------------------------------------------------- The resources described in this section will help you get started with Sun Chili!Soft ASP 3.6.2. Your primary resource is the product documentation (see section 4.1). There are two versions of this documentation: one in HTML format that includes dynamic index and search functionality, and one in Adobe PDF format. To view and print the PDF version, Adobe Acrobat Reader must be installed. To obtain a free copy of Acrobat Reader, go to: http://www.adobe.com/products/acrobat/readstep2.html In addition to the product documentation, the following resources will help you learn more about Sun Chili!Soft ASP: * Sample ASP applications demonstrate the basics of building Sun Chili!Soft ASP applications (see section 4.2). * The 10-Step Tour provides a basic introduction to Sun Chili!Soft ASP technology (see section 4.3). * Diagnostic applications verify that the features of your ASP environment are working correctly (see section 4.4). NOTE: To use ASP functionality in the diagnostics, the 10-Step Tour, and the sample applications, 'Allow session state' must be set to 'yes' on the 'Server Settings' page in the Administration Console. For more information about this setting, see "Enabling Session State" in the product documentation ("Chapter 3: Managing Sun Chili!Soft ASP" => "Managing the ASP Server"). You can access these resources from the Sun Chili!Soft ASP Start Page at: http://[HOSTNAME]/caspsamp where [HOSTNAME] is the hostname of your Web server. 4.1 PRODUCT DOCUMENTATION -------------------------- The Sun Chili!Soft ASP 3.6.2 product documentation includes information about installing, configuring, and using Sun Chili!Soft ASP for Linux. It introduces the basics of building Sun Chili!Soft ASP applications, and provides reference information about using scripting languages, connecting to databases, and developing and using components. The product documentation is structured so you can easily find the information you need. The contents of each chapter are described below. * "Introduction: About this Documentation": Provides an overview of the Sun Chili!Soft ASP product documentation and other Sun Chili!Soft ASP resources. * "Chapter 1: About Sun Chili!Soft ASP": Describes what's new in this release. Also provides an introduction to ASP technology, and describes the Sun Chili!Soft implementation of ASP. * "Chapter 2: Installing and Configuring Sun Chili!Soft ASP": Tells you how to install Sun Chili!Soft ASP on your server, and describes changes the setup program makes to your Web server configuration files. Also provides instructions for performing basic server-configuration tasks and enabling users to publish ASP applications to the Web server. * "Chapter 3: Managing Sun Chili!Soft ASP": Provides information about administering Sun Chili!Soft ASP, including changing ASP Server configuration settings, configuring security, optimizing server performance, and troubleshooting server problems. * "Chapter 4: Building a Sun Chili!Soft ASP Application": Introduces the basics of developing ASP applications: creating an ASP page, adding scripts and server-side includes, and defining the application on the server. Also discusses extending ASP applications by using objects and components, and connecting to databases. This chapter concludes with information about publishing a Sun Chili!Soft ASP application. * "Chapter 5: Developer's Reference": Provides reference information about using built-in ASP components, additional "off-the-shelf" ASP components, and custom components. Also provides a scripting reference for VBScript and JScript, and reference information about using ActiveX Data Objects (ADO), Sun Chili!Beans, and Sun SpicePack components. * "Appendix A: Error Messages": Explains error messages you might encounter when using Sun Chili!Soft ASP. * "Appendix B: Troubleshooting": Provides troubleshooting tips for problems you might encounter when running Sun Chili!Soft ASP. * "Appendix C: Glossary": Contains a glossary of terms you might encounter when administering Sun Chili!Soft ASP and developing ASP applications. You can access the product documentation in a number of ways: * Following installation, you can access the product documentation from the Administration Console by clicking the 'documentation' link in the left navigation pane. * The Sun Chili!Soft ASP setup program gives you the option to enable the product documentation on your Web server. If you choose this option, when your Web server is running, you can also access the HTML version of the documentation at: http://[HOSTNAME]/caspdoc/ where [HOSTNAME] is the hostname of your Web server. * From the first page of the HTML documentation, you can click a link to open the version in PDF format. To access the PDF version directly, use the following URL: http://[HOSTNAME]/caspdoc/pdf/chilisoft_asp_docs.pdf where [HOSTNAME] is the hostname of your Web server. * You can access the product documentation from the Sun Chili!Soft Web site at: http://www.chilisoft.com/caspdoc/ * When your Web server is running, you can access the product documentation from the Sun Chili!Soft ASP Start Page at: http://[HOSTNAME]]/caspsamp/ where [HOSTNAME] is the hostname of your Web server. 4.2 SAMPLE ASP APPLICATIONS ---------------------------- The Sun Chili!Soft ASP setup program gives you the option to enable the sample ASP applications on the computer running Sun Chili!Soft ASP. The sample applications demonstrate the basics of building Sun Chili!Soft ASP applications. NOTE: To use the sample ASP applications, 'Allow session state' must be set to 'yes' on the 'Server Settings' page in the Administration Console. For more information about this setting, see "Enabling Session State" in the product documentation ("Chapter 3: Managing Sun Chili!Soft ASP" => "Managing the ASP Server"). You can access and view samples in a number of ways: * When your Web server is running, you can access the samples from the Sun Chili!Soft ASP Start Page, at: http://[HOSTNAME]]/caspsamp/ where [HOSTNAME] is the hostname of your Web server. * You can access the samples from the Sun Chili!Soft Web site at: http://www.chilisoft.com/caspsamp/ * You can view a list of installed sample ASP applications on the 'ASP Applications' page of the Sun Chili!Soft Administration Console, as described in "Adding an ASP Application" in the product documentation ("Chapter 3: Managing Sun Chili!Soft ASP" => "Managing the ASP Server" => "Configuring ASP Applications"). The sample applications are located in your file system at: /caspsamp="[C-ASP_INSTALL_DIR]/caspsamp" where /caspsamp is the directory alias (virtual directory) for the caspsamp sample application, and [C-ASP_INSTALL DIR] is the path name of the Sun Chili!Soft ASP installation directory. 4.3 The 10-STEP TOUR ---------------------- If you are new to ASP technology we recommend that you take our 10-Step Tour, which provides a basic introduction to Sun Chili!Soft ASP. NOTE: To use ASP functionality in the 10-Step Tour, 'Allow session state' must be set to 'yes' on the 'Server Settings' page in the Administration Console. For more information about this setting, see "Enabling Session State" in the product documentation ("Chapter 3: Managing Sun Chili!Soft ASP" => "Managing the ASP Server"). When Sun Chili!Soft ASP is installed and your Web server is running, you can access the tour from the Sun Chili!Soft ASP Start Page at: http://[HOSTNAME]/caspsamp/ where [HOSTNAME] is the hostname of your Web server. 4.4 DIAGNOSTIC APPLICATIONS ----------------------------- Diagnostics enable you to verify that various features of your ASP environment are working correctly. The diagnostic applications listed below are installed with Sun Chili!Soft ASP. NOTE: To use the diagnostics, 'Allow session state' must be set to 'yes' on the 'Server Settings' page in the Administration Console. For more information about this setting, see "Enabling Session State" in the product documentation ("Chapter 3: Managing Sun Chili!Soft ASP" => "Managing the ASP Server"). * HELLO: Tests the functionality of ASP and VBScript by using a simple "Hello World" script. * SERVER: Tests the ASP Server-to-Web server connection by retrieving the standard Web server variables. * JSCRIPT: Tests the functionality of JScript. * COMPONENTS: Tests the functionality of additional components installed with Sun Chili!Soft ASP. * ADO: Accesses ActiveX Data Objects (ADO) from VBScript. It connects to a sample database by using ODBC (Open Database Connectivity) to test the functionality of ADO and the dBASE ODBC driver. * JSADO: Performs the same test as the ADO test, but accesses ADO from JScript rather than VBScript. * SQLEXECUTE: Uses ADO to execute an SQL statement and display the results. To use this application, you must first create a system DSN for your database on the ASP Server, as described in "Adding a DSN" in the product documentation ("Chapter 3: Managing Sun Chili!Soft ASP" => "Configuring a Database" => "Configuring Data Source Names (DSNs)"). When your Web server is running, you can access the diagnostic applications from the Sun Chili!Soft ASP Start Page at: http://[HOSTNAME]/caspsamp/ where [HOSTNAME] is the hostname of your Web server. ---------------------------------------------------------- 5. Contacting Customer Support ---------------------------------------------------------- Use one of the following methods to contact Sun Chili!Soft Customer Support: Web form: http://www.chilisoft.com/support/chili.eval.asp Support Forum: http://www.chilisoft.com/forum/ Following the installation of Sun Chili!Soft ASP 3.6.2, you can also contact Customer Support from the Sun Chili!Soft ASP Administration Console. Click the 'customer support' link in the left navigation pane, and then click the 'Submit a question' tab. ---------------------------------------------------------- 6. Legal Notice ---------------------------------------------------------- Copyright 2002 Chili!Soft, Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, California 94303, U.S.A. All rights reserved. Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more additional patents or pending patent applications in the U.S. or other countries. This product documentation and the technology it describes are distributed under licenses restricting their use, copying, distribution, and decompilation. No part of this product documentation may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd. Sun, Sun Microsystems, the Sun Logo, Java, Solaris, and Chili!Soft ASP are trademarks or registered trademarks of Chili!Soft, Inc. or Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks of SPARC International, Inc. in the U.S. and other countries. Federal Acquisitions: Commercial Software - Government Users Subject to Standard License Terms and Conditions. DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.