InstantPalace Installation

      • Overview

        • Palace server version 4.3.2, which shipped for Unix, Linux, and Windows NT platforms, shipped with InstantPalace version 2.0 build 32, which was the last released version of InstantPalace. Unix and Linux 4.4.1 and 4.5.1 servers shipped without InstantPalace. Since Unix, Linux, Win95/98/ME, and WinNT servers all use the same directory structure, the information below can be used to assist in setting up InstantPalace on any of these versions. For more specific information regarding Windows 4.4 servers, try InstantPalace with 4.4 Windows Server. The server's root directory referred to below would be equivalent to the PalaceServer directory on a Windows 4.4 server installation.

        Many Hosting Services use non-standard directory structures, and some have their own system for InstantPalace operations. If you are with a Palace Hosting Service, you should contact your host for additional information before proceeding with installation.

      • Required Directories and Files

        • First you will need to download the files needed to set up InstantPalace:

        Download InstantPalace Files

        Below is a list of the directories, which need to include their default contents, and other files that should be added to a palace server installation to activate InstantPalace. All directory names and file names are case sensitive.

        • Place these items in the server's root directory:

          • In the root directory of your pserver, there should already be directories named bin, conf, logs, and palace. You are adding the following directories and files: 

          binc (directory)

            Contains 9 files: 3 .cab files, 3 .zip files, and 3 .jar files. Don't unzip the zip files, but leave these files the way they are.
          cgi-bin (directory)
            Contains 2 files in this directory by default that aren't used by this version of IP. Nothing to worry about in here.
          common (directory)
            Contains 2 directories: images and servermonitor. The servermonitor directory has a cab, jar, and zip file. Don't unzip the zip files, but leave these files the way they are.
          index.html (file)

        • Place these items in the palaceroot/palace directory:

          • In the palace directory, you should already have directories called media, logs and psdata. You are adding the following directories and files: 

          avatars (directory)

            Contains 104 small images named cf0.gif through cf103.gif.
          client (directory)
            Contains several directories and files. The most important file in the client directory is the one called instantpal.html.
          contents.html (file)
index.html (file)
pal_admin_stat.html (file)
        The files and directories that were used in these tests came from a Linux server installation, but it is reasonable to assume that the files and directories from Windows NT or other Unix installations would also migrate successfully.

      • Check The Paths

        Open the instantpal.html file with a text editor. This file is located in the palace/client directory. Check the paths, as these may have been changed by those who previously installed InstantPalace, such as Hosting Services. A default linux, unix, or 4.4 Windows server installation should use the default settings in the instantpal.html file. Near the top of the file, the setting for psRoot should be:

        psRoot="/palace";

        Check the paths to the jar and zip files by locating the lines in the instantpal.html file with the entries below. The default settings for the two Netscape archives and the Mac version of Internet Explorer archives are:

        ARCHIVE=/binc/pal_arch.jar
ARCHIVE=/binc/pal_arch.zip
ARCHIVE=/binc/pal_arch.zip

        The setting for the path to the cab file for Windows versions of Internet Explorer is located at the top of the parameters section, which is located near the end of the instantpal.html file. The default entry is:

        document.writeln("<PARAM name=cabbase value=/binc/pal_arch.cab>");

      • Check Web Server Operations

        By default, your server should be configured to use port 9990 for web server operations. On a linux/unix installation, this setting is found in the palaceroot/conf/httpd.conf file. After launching your server, verify that your web server is operational. Go to your web browser, and put this address in the location field, using your domain name or numeric IP address instead of "yourdomain.com":

        http://yourdomain.com:9990/palace/media/clouds.gif

        Replace clouds.gif with the name of any picture that is in your palace/media directory. If your web server is working, the picture will display in your web browser. Now try this address, using your domain or numeric IP address instead of "yourdomain.com":

        http://yourdomain.com:9990/palace/client/instantpal.html

        If the directories and files are in the right places, then you should now see InstantPalace start to load. The download is approximately 200K, so give it time to load.

      • Configure the pserver.prefs file

        For the InstantPalace avatars in your palace/avatars directory to be used, this line must appear on a separate line in the pserver.prefs file, which is located in the palace/psdata directory:

        USEOTHERAVATARSERVER

        If this line isn't in the pserver.prefs file, it can be added with a text editor. For this change to take effect, the pserver.prefs file should be edited while your server is not running.

      • Connecting to InstantPalace

        To connecting to InstantPalace after a default installation, use this address:

        http://yourdomain.com:9990/palace/client/instantpal.html

        Replace "yourdomain.com" with your numeric IP address or domain name. The Resource Center can be accessed by using this address:

        http://yourdomain.com:9990/palace/index.html

        The Resource Center is a web page with a red and green light that shows whether your server is running, how many people are on your server, the server version, capacity, and other data. Again, replace "yourdomain.com" with your numeric IP address or domain name to access the Resource Center.

      • InstantPalace Troubleshooting

        If problems are encountered after following the above installation and configuration procedures, you can try the InstantPalace Troubleshooting web page for additional information. Another option would be to join the InstantPalace Discussion Group, and post questions there regarding installation or configuration difficulties.

      • Additional Resources

        • InstantPalace Resources Index
        • Scripting for InstantPalace
        • Customizing InstantPalace
        • 104 Avatars for InstantPalace
        • Using Larger Avatars with InstantPalace
        • Using Sounds with InstantPalace
        • InstantPalace with 4.4 Windows Server
        • Mac InstantPalace and Browser Issues
        • InstantPalace Troubleshooting
        • Iptscrae Quick Reference Table
        • InstantPalace Demos
        • InstantPalace Parameters
        • InstantPalace Discussion Group

        © 2002