The users_man/installation chapter has been split into three sections Obtaining Ptolemy Installation Trouble Shooting This text is generated from the users_man/obtainingPtolemy.ps file. This text file contains the latest and greatest version of the installation appendix. The version in the doc.tar.Z file may be out of date with respect to this version. Appendix A. Installation and Troubleshooting Authors: Joseph T. Buck Christopher Hylands Alan Kamas Other Contributors: Stephen Edwards Edward A. Lee Kennard White A.1 Introduction This appendix consists of three parts: "Obtaining Ptolemy" on pageA-1, discusses how to obtain Ptolemy. "Ptolemy mailing lists and the Ptolemy newsgroup" on pageA-3, discusses various forums for discussion about Ptolemy. "Installation" on pageA-5, discusses how to install Ptolemy. "Troubleshooting" on pageA-17, discusses how to find and fix problems in Ptolemy. "Known bugs" on pageA-33 lists known problems in Ptolemy. "Additional resources" on pageA-39 discusses other resources. A.2 Obtaining Ptolemy Ptolemy binaries are currently available for the following architectures: HP running HPUX10.01, Sun 4 (Sparc) running Solaris2.4, and Sun4 (Sparc) running SunOS4.1.3. In addition, Ptolemy has been compiled on HPUX9.x, Linux Slackware 3.0, NetBSD_i386, IBM RS/6000 AIX3.2.5, SGI Irix5.3, SGI Irix6.x and the DEC Alpha OSF1 V3.2 platforms. These additional platforms are not supported in house and thus these ports are not tested and may not be complete. Installing the full system requires about 140 Megabytes of disk space (more if you optionally remake). The demonstration version of Ptolemy, "Ptiny," only requires 12 Megabytes of disk space. All versions requires at least 8 Megabytes of physical memory. For the latest information on Ptolemy, get the Frequently Asked Question list. Send electronic mail to ptolemy-hackers-request@ptolemy.eecs.berkeley.edu with the message: get ptolemy-hackers.FAQ in the body (not the subject) of the letter. You may also send any questions on obtaining Ptolemy to the email address: ptolemy@eecs.berkeley.edu. If you have questions about using or enhancing Ptolemy, you should use the ptolemy-hackers mailing list. See "Ptolemy mailing lists and the Ptolemy newsgroup" on pageA-3 for details. A.2.1 Access via the Internet Ptolemy is available without support at no charge via Internet FTP. Source code, executables, and documentation are all available on the FTP site at ftp://ptolemy.eecs.berkeley.edu. This site contains the latest release of Ptolemy, patches to the current release, a Postscript version of the Ptolemy manual, the demonstration version of Ptolemy, Ptolemy papers and journal articles, as well as the archives for the mailing list. To obtain Ptolemy via FTP: a. FTP to Internet host ptolemy.eecs.berkeley.edu. b. Login as anonymous; give your full email address as the password. c. Change to the /pub directory: cd pub d. Follow the directions in the README file there. There is an FTP mirror in Japan: ftp://ftp.iij.ad.jp/pub/misc/ptolemy The notation above means log into ftp.iij.ad.jp and then cd to /pub/misc/ptolemy. There is also an FTP mirror in France at: ftp://chinon.thomson-csf.fr/mirrors/ptolemy.eecs.berkeley.edu/ A.2.2 Access via the World Wide Web There is a World Wide Web (WWW) page for Ptolemy: http://ptolemy.eecs.berkeley.edu/ The Ptolemy WWW page contains information about Ptolemy, demonstrations of Ptolemy programs, access to the Ptolemy FTP site, and a hypertext version of the Ptolemy Documentation. There is a WWW mirror of our site in France at: http://chinon.thomson-csf.fr/ptolemy A.2.3 Access via ordinary mail Organizations without Internet FTP capability can obtain Ptolemy without support from: EECS/ERL Industrial Liaison Program Office Software Distribution 205 Cory Hall #1770 University of California at Berkeley Berkeley, CA 94720-1770 phone: (510) 643-6687 fax: (510)643-6694 email: ilpsoftware@eecs.berkeley.edu www: http://www.eecs.berkeley.edu/ILP/ There is currently a handling fee of $250 for US orders, $265 for foreign. These prices are subject to change at any time. Please contact the ILP office at the address above for the exact price. Printed documentation is included. A.2.4 Obtaining documentation only All of the manuals as well as a number of Ptolemy related papers and journal articles are available from the WWW site and from the FTP site in the /pub/ptolemy/papers directory. These documents are all in the Postscript format, and require a Postscript printer or viewer. The paper overview.ps.Z gives an overview of Ptolemy and would be of particular interest to new users. Printed versions of the manuals are also available separately from the tape. Please contact the ILP office at the address above for the current price. A.3 Ptolemy mailing lists and the Ptolemy newsgroup There are two publically available mailing lists and a newsgroup that discuss Ptolemy. A.3.1 Ptolemy mailing lists The Ptolemy mailing lists are run by the Majordomo mailing list server. This server can automatically subscribe you to mailing lists and it can send you monthly archive files for each of thelists. To find out more about our Majordomo server, send an email letter to: majordomo@ptolemy.eecs.berkeley.edu with the word help in the body of the letter. There are two mailing lists for Ptolemy users: ptolemy-hackers@ptolemy.eecs.berkeley.edu ptolemy-interest@ptolemy.eecs.berkeley.edu ptolemy-hackers A forum for Ptolemy questions and issues. Users of the current release who have a Ptolemy question, comment, or think they've found a bug should send mail to ptolemy-hackers. Ptolemy users in companies and universities around the world who are interested in discussing Ptolemy post and read from the ptolemy-hackers group. To subscribe to the ptolemy-hackers mailing list, send mail to: ptolemy-hackers-request@ptolemy.eecs.berkeley.edu with the word subscribe in the body of the message. To leave the mailing list put the word unsubscribe in the body of your message. ptolemy-interest A mailing list for Ptolemy announcements. Messages about new releases, bug fixes, and other information of interest to all Ptolemy users is posted here. Note: This is not a discussion group, and you cannot post to this mailing list. Message volume is very light. All users of Ptolemy should belong to this group in order to stay current with work being done on Ptolemy. Announcements sent to ptolemy-interest are also sent to ptolemy-hackers, so you need not subscribe to both lists. To subscribe to the ptolemy-interest mailing list, send mail to: ptolemy-interest-request@ptolemy.eecs.berkeley.edu with the word subscribe in the body (not the subject) of the message. A.3.2 Ptolemy Newsgroup There is now a Ptolemy newsgroup: comp.soft-sys.ptolemy. Just like the ptolemy-hackers mailing list, the comp.soft-sys.ptolemy newsgroup is a forum of the discussion of Ptolemy questions, bug reports, additions, and applications. Note that all mail sent to the ptolemy-hackers mailing list is automatically posted to the comp.soft-sys.ptolemy newsgroup as well. The name is chosen to correspond to similar newsgroups for the Khoros and Matlab systems, which are also under comp.soft-sys.