Razor(R) Copyright 1992 - 2002 Visible Systems Corporation www.visible.com Client applications for Windows NT/95/98 README file contents -------------------- - Distribution content - Distribution formats - Installation instructions - Startup instructions - Login instructions - Troubleshooting Distribution content -------------------- This distribution contains everything necessary to install the Razor/PC client applications (issues, versions and threads) onto a WIN32 platform. RazorSCC, an integration with Windows IDE's, is also included. Refer to the Razor manual, Appendix E, for details. Distribution format ------------------- - RazorPC_.exe (self-extracting exe) Installation instructions ------------------------- If upgrading to a more recent version of Razor, it is only necessary to uninstall* if you are running a pre-4.1e release. After retrieving the Razor/PC distribution to a WIN32 machine, simply run the self-extracting executable. RazorSCC may also be installed at this time (refer to Appendix E of the Razor manual for details). The WIN32 machine must be able to resolve the host name of the Razor license manager if using the hostname instead of IP address when starting up. If the PC is not setup for name service (DNS), add entries to the local host table for the license manager host. *On WINNT3.5, this is done by activating the 'Uninstall' icon in the Razor program group. On WIN(95/98) and WINNT4.0, you should uninstall by executing 'Add/Remove Programs' from the Control Panel. It is important that all windows applications be terminated before uninstalling. Startup instructions -------------------- WIN(95/98)/WINNT(4.0): Execute "razor" from the Start menu by selecting Start->Programs->RazorPC->razor. This will start a new Razor desktop. Specific Razor client applications may then be run on this new desktop by selecting from the "Applications" menu pulldown on the Razor desktop. WINNT(3.5): Double click on the "razor" icon in the RazorPC program group in the Program Manager. This will start a new Razor desktop. Specific Razor client applications may then be run on this new desktop by selecting from the "Applications" menu pulldown on the Razor desktop. Login instructions ------------------ Login involves two separate dialogs. The first dialog requests server information. Specifically, the user is required to provide information necessary to connect with the Razor license manager and desired Razor database server on the network. The second dialog requests user information. The user/ password information that is required is dependent upon the Razor license manager mode. The possible user authentication modes are to use the Razor password file, the local password file or a combination of both. Refer to Chapter 2 of the manual, "License manager" for details. The Razor administrator will be able to provide the mode so that you can determine the correct user/password information to enter. Administrators should refer to the Razor manual or run "razor -help" for information regarding the password file and the Razor interface provided for password file maintainance. It may be necessary to contact your local Razor administrator for some of the following information. A more detailed explanation of each field on the two dialogs follows: UniverseDir The UniverseDir field must contain the fully expanded path to a Razor database as it would be entered on the database server host machine. This path should end with RAZOR_UNIVERSE (without trailing '/'). NOTE: Remember to use the UNIX style slash ('/' is good and '\' is bad). Port The Port field must contain the port of the License manager. The installation default is 16151. Host The Host field must contain the host of the License manager. This may be given in either hostname format or IP address format. Local Host This Host field specifies the IP address of the client machine. This field appears disabled unless more than one IP address has been detected. If multiple addresses are available, select the IP address by which the PC is known to the machine hosting the database server. UserID/Password User/password combination dependent upon the license manager mode. The possible modes are to use the local password file, the Razor password file or a combination of both. Change password This toggle will remain insensitive until the Razor password file is created by the Razor administrator. If toggled on then the "New password" and "Verify" fields are made sensitive and are used to specify a new password. New password/Verify Used to specify a new password. Troubleshooting --------------- If you are experiencing difficulty connecting to a Razor database, one of the following problems may exist: 1) A message similar to the following appears on the "Razor output log..." window. "The Database server for "/home/joe/DB/RAZOR_UNIVERSE" does not appear to be running." "Please contact your RAZOR Administrator." This usually indicates that either the database is not being served or the database path contains a typographic error. Verify that the database path begins with a forward slash ('/'). Verify that the database path ends with "/RAZOR_UNIVERSE" (no trailing '/'). Once you have verified the path is typographically correct, verify that a database server is running for your particular database by logging onto the machine hosting the database server and entering the command "razor info". Remember to "source" or "dot" the appropriate 'rz_prep' or 'rz_prep.sh' file to set the environment variables. Each Razor database created will contain the files 'rz_prep' and 'rz_prep.sh'. This pair of files will uniquely configure the user's environment for operation with the corresponding database. Following is a sample output from running "razor info". -> razor info The license manager is running on zoot, pid = 19854 Remote Clients are using Razor Password file Connections: ------------ Database '/home/filmer/DB/test/RAZOR_UNIVERSE', is active on kermit, rz_server pid = 5820 1 - filmer is running Versions on machine waldorf, pid = 190 2 - filmer is running Issues on machine waldorf, pid = 164 3 - filmer is running Threads on machine waldorf, pid = 147 4 - mark is running Versions on machine waldorf, pid = 61 5 - deb is running Versions on machine waldorf, pid = 169 ---- Database '/home/filmer/DB/SCCS/RAZOR_UNIVERSE', is active on kermit, rz_server pid = 17630 1 - filmer is running Versions on machine waldorf, pid = 180 2 - filmer is running Issues on machine waldorf, pid = 182 There are 7 applications connected. The path you provide for "Universe Dir:" must exactly match one of the Databases as reported by "razor info". From the example above this would mean either "/home/filmer/DB/test/RAZOR_UNIVERSE" or "/home/filmer/DB/SCCS/RAZOR_UNIVERSE". 2) The following message appears on the "Razor output log..." window. "The Host/Port you are trying to connect to does not" "appear to be running the RAZOR license server program." "Please contact your RAZOR Administrator." This usually indicates that either the license manager is not running or the specified license manager host or port (or both) are incorrect. You can detect whether or not the license manager is running by executing the command "ps" on the machine which hosts the license manager and looking for "razor_lm" (i.e. "ps -elf | grep razor_lm"). If it appears that the license manager is not running, contact your local Razor administrator. If the license manager is running, you can verify the Host and Port by looking at the content of file $RAZOR_LICENSE_DIR/License_status. 3) A notice dialog pops up with the message... "Unknown Userid []". This indicates the the username provided does not appear in the password file being used by the license manager. Contact your local Razor administrator. 4) A notice dialog pops up with the message... "Invalid password". This indicates that the password provided is not the correct password for the username provided. Contact your local Razor administrator. 5) The following message appears on the "Razor output log..." window. "Could not spawn kid." "/rz_remote_kid is missing." The script used to start the clients helper application is missing as stated. Contact your local Razor administrator. 6) The following message appears on the "Razor output log..." window. "Could not spawn kid." " does not have execute permission for /rz_remote_kid The script used to start the clients helper application does not have the required execute permission. Contact your local Razor administrator. 7) The following message appears on the "Razor output log..." window. "Kid did not connect." Causes are varied. A few things to check include the following... (NOTE: The environment variable RAZOR_HOME is set by the file 'rz_prep' associated with the database you are connecting to.) - Verify that $RAZOR_HOME/bin/kid_of_issues, $RAZOR_HOME/bin/kid_of_versions, $RAZOR_HOME/bin/kid_of_threads exist and are executable. - Verify that the client and server are not seperated by a firewall. 8) A message similar to the following appears on the "Razor output log..." window. "Error during program identification." "Version mismatch - Server = v4.1d, Client = v4.1(c)" "Please update your Razor installation on ALL platforms." This typically indicates an incompatability between the version of Razor run by the client and the version run by the server. Verify the release version as follows: PC client) Select "Help-->About" from the Razor desktop window and record the version and date. Server host) cat $RAZOR_HOME/VERSION Once it is demonstrated that indeed there is a version mismatch, it is generally recommended to upgrade all platforms to the latest release version of Razor. If the above suggestions do not help resolve the problem, please send the following information to 'razor_support@visible.com': Login dialog fields ------------------- Universe Dir: Host: Port: Username: Password: (Please provide only the length of the password) Software version ---------------- PC client) Select "Help-->About" from the Razor desktop window and record the version and date. Server host) cat $RAZOR_HOME/VERSION Error information ----------------- Please provide the complete contents of the "Razor output log..." window. Please provide the complete content of the "exit notice" dialog if it appeared. Miscellaneous information ------------------------- Does the problem seem to be isolated to a specific user or does it occur regardless of user? Does the problem seem to be isolated to a specific database or does it occur regardless of database. Is this a first attempt at using Razor's PC client application or has it worked in the past and now is "broken"? Have any Razor upgrades been made lately either to the PC client and/or Server installation? Whatever other information you can provide regarding the circumstance of the failure, no matter how trivial it may seem, may prove useful. Finally ------- Enjoy! And please send your suggestions/comments to: razor_support@visible.com Your inputs (good or bad) are very important to us! Visible Systems Corporation www.visible.com