Instruction/ maintenance manual of the product FrameMaker 8.0 Adobe
Go to page of 78
ADOBE FRAMEMAKER 8 INST ALLA TION GUIDE FOR UNIX.
© 2007 Adobe Sy stems I ncorpora ted and i ts licensors. All righ ts reserved. Ins talling A dobe® Fram eMak er® 8 fo r UNIX If this guide is distributed with software that includes an end-user ag .
This product in cludes software devel oped by the Apache Sof tware Foundation (htt p://ww w .apache.org/). Certain Spelling portions of this pr oduct is based on Pro ximity Linguistic T echnology . ©Copyright 1990 Me rriam-W ebste r Inc. ©Co p yright 1990 All rig hts res er ved .
Burlingto n, New J ersey USA. ©Copyright 1989 I DE a.s. ©Copyrigh t 1989 All rights r eserved. Proximit y T echnology A Division of Fr ankl in El ectroni c Publishers, I nc. Burling ton, N ew Jersey USA. ©Cop yright 1990 Espasa-Calpe ©Copyright 1990 All right s reserved.
v Co n t e n t s Chapter 1: Getting started About multiple -p latform networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 System requirements . . . . . . . . . . . . . . . . . . . .
CONTENT S vi Specifying an XKeysymDB file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Chapter 4: Setting up lic enses Licensing basics . . . . . . . . . . . . . . . . . . .
vii Using fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CONTENT S viii.
1 C h ap te r 1 : G e tti n g s t ar te d This guide describes how a UNIX® syst em administrato r can in stall and license Adobe® F rameM aker®. A software developer installing the Frame® Develope.
2 CHAPTER 1 Getting started S y stem requir ements T o use Fra meM aker f or UNIX , yo u need the f ollo wing h ard war e a nd softwa re . Platfo rm and soft ware r equirements The fo llo wing ta ble sh ows the su pported system configura tio n. See also “ M emory req uir emen ts ” o n pag e 3.
3 ADOBE FRAMEMAKER 8 Installation Guide Memory requirements The foll owing tabl e shows requirem ents for RAM, disk spac e, and swap spa ce. Disk sp ace requ irements are 25 MB lar ger fo r J apan ese fun ctio nali ty .
CHAPTER 1 4 Getting started.
5 Ch a p t e r 2 : I n s ta lli n g f ile s This chap ter describes how to install Adobe® F rameMaker® 8 files from a CD-RO M on to a works tation or server .
6 CHAPTER 2 Installing files Setting up the F rameMak er direc tor y If you a re installing for mo re than on e user , you must p ut the files in a directory for which all us ers have r ead and execute permissions. The directory must also be mounted on all users ’ systems.
7 ADOBE FRAMEMAKER 8 Installation Guide T o set up the FrameMak er installation directory: 1 U se the mkdir comman d to crea te the directory . Fo r example , enter mkdir /usr/fram e 2 U se the chmod comman d to ensur e that users can run the pr oducts from this directory .
CHAPTER 2 8 Installing files • Executable files for the pla tfo rm from which y ou ar e installing • An English-language user interface, o r a J apa nese-language interface if the LANG envir onment va riable is set to ja • Ty p e 1 f o n t s • M ultibyte fon ts.
9 ADOBE FRAMEMAKER 8 Installation Guide • S elect individual international dictionar y and Thesaurus f ile sets to install, inst ead of installing all files. (This saves disk sp ace, but may affe ct the formatting of text in t he languages for w hich you have not insta lle d dict io- naries.
CHAPTER 2 10 Installing files Choosing the user-interface language for int ernational products A custo m installa tion also lets you ch o ose which user -in terfa ce languages to install.
11 ADOBE FRAMEMAKER 8 Installation Guide • Mount the CD -ROM drive, i f nece ssar y • Run the CD-R OM installa tion scri pt t o install F rameMaker files • T roublesho ot t he inst all ation Y o u can ins tall f ro m a CD-ROM driv e on yo ur local system or fr om a remo te syst em.
CHAPTER 2 12 Installing files T o d etermine if the CD-ROM drive has already been mounted: Enter the following command: /sbin/mo unt Y o u should see a list of moun ted fi le systems.
13 ADOBE FRAMEMAKER 8 Installation Guide T o mount the drive on a local system: 1 L o g i n a s t h e r o o t u s e r a n d i n s e r t t h e F r a m e M a k e r C D i n t o t h e C D d r i v e . O t h e r w i s e , t h e m o u n t c o m m a n d m a y not work.
CHAPTER 2 14 Installing files Mounting the CD-ROM drive fr om a remot e syst em If th e CD-RO M dri ve is a t tached t o a r emot e sys tem, c heck wheth er it i s list ed in the exports file o n the r emo te system, and add i t if necessar y . The exports fi le specifies directories that can be exported to local systems.
15 ADOBE FRAMEMAKER 8 Installation Guide If yo u see this line, skip to the pr ocedure , “T o mount the CD-ROM drive fro m a remot e system:” o n page 15. I f you do not see this line, yo u need to add it t o the file as described in the f ollo wing p rocedur e.
CHAPTER 2 16 Installing files /sbin/mount - F hsfs - r /dev/sr0 /cdr om The value of dev ice_name de pe nds on your s ystem . The -r opt ion m ounts t he dr ive as rea d-on ly . U s e t his option to prevent media error messages fro m appearing. 2 E xit r oot on the r emote syst em by en tering exit 3 L og in as the root user on yo ur local system.
17 ADOBE FRAMEMAKER 8 Installation Guide 2 En ter th e fo llowing C D-R OM i nstalla tion co mma nd: ./read.cd 3 Read the instruct ions pr ovided by the CD-ROM installation scr ipt a nd answer the questions. The script asks you to sp ecif y t he FrameMaker insta ll ation director y and which file s to instal l.
CHAPTER 2 18 Installing files C o pying F rameMak er files If you ne ed to copy the Fr ameMake r di rec tor y and its sub di rec torie s f rom one l oc ation to anoth er , u se the f mc opy shell script loca ted in install_dir /bin. T o se e instruct ions fo r using this script, change to in stall_dir /bin a nd enter .
19 Cha p t e r 3: Set t i n g u p th e u se r env iron ment Y o u should change the P A TH enviro nment varia ble for each user so t hey can start Adobe® Fra meMaker® fro m an y d i r e c t o r y. T h e e a s i e s t w ay t o d o t h i s i s t o r u n t h e pr o v i d e d f m u s e r s e t u p s c r ip t .
20 CHAPTER 3 Setting up the user environmen t U sing the fmusersetup script The fmusersetup script alters the user’ s s tartup files to define t he en vironmen t variable FMH OME (which specifies t he directory in whi ch you in stalled FrameMaker p roducts).
21 ADOBE FRAMEMAKER 8 Installation Guide 5 T est the scrip t by s tarting F rameM aker fro m an y directo r y . (For inf orma tion, see “ Starting F rameMaker ” on page 57) Running fmusersetup as .
CHAPTER 3 22 Setting up the user environmen t If the path assignment sta tement is defined absolu tely , you m ust edit the file after fmusersetup changes it. (The path is defined absolutely if the path sta temen t doesn ’t hav e the enviro nment variable P A TH on the right side of the equal sign.
23 ADOBE FRAMEMAKER 8 Installation Guide T o set up a user’ s environmen t without r unning fmusersetup: 1 Define FM HO ME by doing o ne of the following (wher e install_dir is the name of the directory in which you installed F rameMak er): • If you use the C shell, add this line to the .
CHAPTER 3 24 Setting up the user environmen t U sing aliases or scripts to a v oid modifying paths If y ou do n ’t wa nt t o modify p a ths, you ca n use aliases or scrip ts to make it easier f or user s to start FrameM aker.
25 ADOBE FRAMEMAKER 8 Installation Guide • If you use the Bourne shell, define the alias in t he .pr ofile file. For exam ple: { install_dir /bin/maker } • If you use the Ko r n shell, define the alias in the .
CHAPTER 3 26 Setting up the user environmen t #!/bin/sh case $# in 0) ex ec install_dir /bin/make r;; *) exec install _dir /bin/maker "$@" ;; esac Us in g FM H OM E The remaining instructions in this guide assume that yo u’ ve defined FMHOME to rep resent the F rameMaker inst al lati on dire ctor y ( in stall_dir ).
27 ADOBE FRAMEMAKER 8 Installation Guide Subject: W arning: transla tion table syntax error: U nknown keysym name: osfPageLeft Y o u can corr ect this problem b y setting the XKEYS YMD B envir onmen t variable to ref er to an updat ed version of the XKeysymDB file, wh ich is pro vided in $FMHOME/fminit.
CHAPTER 3 28 Setting up the user environmen t.
29 C ha pt er 4: Se t ting u p licens es This chapter describes how to set up licenses, get reports on license us age, and tro ubleshoot licensing pr oblems. Not e: P lea se skip this chapter if you are installing a de mon stration ve rsion of FrameMaker .
30 CHAPTER 4 Setting up licenses Per s on al l ice n se s A personal license allows a single user to use FrameMak er. When you set up licensing, yo u must assign a user name to each personal license. A licensed use r can use FrameM aker from an y syst em on y our net work, but c an only star t th e produ ct on one sy stem at a ti me.
31 ADOBE FRAMEMAKER 8 Installation Guide Not e: Ma k e c o p i e s o f y o u r l i c e n s i n g i n f o r m a t i o n a n d s t o r e t h e m i n a s a f e p l a c e . I f y o u r l i c e n s i n g f i l e s b e c o m e d a m a g e d , you must cr eat e them aga in from th e original in forma tion.
CHAPTER 4 32 Setting up licenses Setting up shared lic enses If yo u are installing shared licenses, you m ust designate a system as the license ser ver host.
33 ADOBE FRAMEMAKER 8 Installation Guide Setting up license servers After the installation scrip t installs FrameM aker, i t recommends tha t you in stall licenses. T o do this, you run the fmsetu pfls script , which sets up the lic ense server . Y ou can also run fm setu pfls at a l at er time t o set u p addi tion al licenses.
CHAPTER 4 34 Setting up licenses where <different_loca tion_dir> is the ful l pathname of the directory where the licensing fi les will be stor e d. Specify a dir ectory to which all mem b ers o f the wo rkgro up ha ve read a nd execu te permissio n.
35 ADOBE FRAMEMAKER 8 Installation Guide T o set up licensing variables when a user star ts FrameMak er: 1 Create an fminit directory in t he user’ s home directory . 2 Chan ge t o tha t di rect ory . 3 Create a s ymbol ic li nk to the work group ’ s e nv .
CHAPTER 4 36 Setting up licenses Setting up personal licenses Y o u s e t u p p e r s o n a l l i c e n s e s b y e n t e r i n g t h e i n f o r m a t i o n f r o m y o u r r e g i s t r a t i o n c a r d ( o r o t h e r l i c e n s i n g s h e e t ) i n t o the licenses file.
37 ADOBE FRAMEMAKER 8 Installation Guide 2 Start the fmaddlicense progra m by en tering:| 3 U se fm addlicense to enter the info rmation on yo ur registra tion car d (or other licensing sheet) int o the licenses file. Fo r instructions, see the fo llowin g section, “ U sing the fmaddlicense p rogram.
CHAPTER 4 38 Setting up licenses wher e license_path is the path to the licenses file. The default pa th is $FMHOME/fminit. The fmaddlicense prompt appe ars: fmaddlic ense-> 2 Use fmaddlicense by entering commands a t the pro mp t and pr essing Return.
39 ADOBE FRAMEMAKER 8 Installation Guide T o add a shared license: Ent er regi stra tion_num ber wher e regi stration_number is t he regi st ration numb er on your reg istr ation card (or ot her lic ensi ng s hee t). If t he regist ration numb er is not a val id shared licens e reg istration numb er , fmad dlicen se war ns you.
CHAPTER 4 40 Setting up licenses F or eac h license , fmaddlic ense r eports pr oduct type, lic ense type , and pa rt of the re gistra tio n n umber . I t al so reports the user names assigned to personal licenses.
41 ADOBE FRAMEMAKER 8 Installation Guide Removing and reassigning licenses Y ou mus t delete a license before mo v ing it t o a different licenses file.
CHAPTER 4 42 Setting up licenses T o have yo ur changes take effect, you must r einitialize the license s er ver process on the license ser ver to load the new licens ing inf orma tion from the licenses file . Before exitin g, fmaddlicense asks whether y ou want to r eini- tialize the licen s e server proce ss.
43 ADOBE FRAMEMAKER 8 Installation Guide wher e host is the name of the license ser ver host and command is an fmfls adm command. Y o u ca n omit -flshost host to chec k the hos t specified b y the FM_FL S_HO ST en vir on men t varia ble .
CHAPTER 4 44 Setting up licenses T o star t the license server process automa tically: Add the fo llowing line to the license ser ver host’ s system startu p file: licenses_f ile > /dev/console 2>&1 wher e licenses_f ile i s the full pa thnam e of the licenses file yo u wan t to u se.
45 ADOBE FRAMEMAKER 8 Installation Guide env .sh and env .csh scripts The fmsetupfls progra m creates en v .sh and en v .csh scripts, or u pdates them if they already exist. These scripts set the values of the FM_FLS_HOS T and FM_FLS_A UTO licensing envir onmen t variables.
CHAPTER 4 46 Setting up licenses Not e: T he f m_ f lb licen se broad caste r i s des igne d to transmit inf orm ation f rom ea ch machine running FrameMaker to en sure that there are no duplicate licenses being u sed on the net work. All net work broadcasts commun icate with all I/ O por ts, which could activate dial -on-d emand connect ions.
47 ADOBE FRAMEMAKER 8 Installation Guide 2 The product searches f or a personal license in $HOME/fminit/licenses and then in $FMHOME/fminit/licenses. • If i t finds a perso nal lice nse, the li censed ve rsio n of th e pr oduct s tarts.
CHAPTER 4 48 Setting up licenses • If fm_fls doesn ’t respo nd, the pr oduct runs the fm _fls_auto scrip t (the script named by FM_FLS_A UTO) to start the license ser ver process, and then con tinues with step 5. (I t can ’ t run fm_f ls_au to if FM_FLS_A UT O is not set.
49 ADOBE FRAMEMAKER 8 Installation Guide The log_file op tion specifies the pa thna me o f the fm_fls.log file fr om whic h yo u will gen erat e the r eport.
CHAPTER 4 50 Setting up licenses T o display additional messages at startup: Add the -nlverbose command-line o ption to the command that starts the product. Fo r examp le: - For a list of c ommands for st ar ting Frame Maker, see , “Start ing Frame Maker .
51 ADOBE FRAMEMAKER 8 Installation Guide Fr ameMaker r epor ts that ther e are no lic enses This prob lem occurs when the FrameMak er cannot find the licenses file in $HOME/fminit o r in $FMHOME/fminit. I t asks if you wan t to run a demonstration version.
CHAPTER 4 52 Setting up licenses T o get a license when the product cannot communicate with the license server: 1 D o on e of t he fol lowi ng: • If your w orksta tion is the license s er ver host, chan ge the name of the license server host in the Lice nse dialog box to localhost a nd try to get a license again.
53 ADOBE FRAMEMAKER 8 Installation Guide wher e host is t he name of the l icens e ser ver ho st. Y o u can omit -f lshost host to chec k the hos t specified b y the FM_FLS_H OST en vir onmen t v ariab le. The fmflsadm p rogr am r eports wh ether o r not the licen se server pr ocess is running.
CHAPTER 4 54 Setting up licenses • The dat e on your worksta tion is differen t f ro m the date on the licen se ser ver host. (If the difference is 4 hours or less, y ou sho uld be able to obta in a license. If the d iffer ence is between 4 an d 8 hour s, you ma y be able to obta in a license .
55 ADOBE FRAMEMAKER 8 Installation Guide • T o start the s er ver and s tore the licensin g log file in the standard location, en ter : license s_file • T o start the server and specify a non stan.
CHAPTER 4 56 Setting up licenses Fo r exam ple: - 4 O n any systems th at are still run ning FrameMaker, kil l the f m_f lb proc ess. For each workstation, us e th e comman d shown in step 3 to determine the process n umber , and use the kill command to kill the process.
57 C h a pt er 5: Star ting F r am eMak er This cha pter describes how to sta rt licensed and dem ons tratio n version s of A dobe® Fram eMak er® and how to run the pr oduct on a r emot e wo rkstatio n or server . While running a demon stratio n ver sion, y ou can u se all featur es except the Save co mmand.
58 CHAPTER 5 Starting FrameMak er Not e: These comman ds work onl y if you ha ve put t he F ra meMa ker directo ry in your path, as de scribed in , “Setti ng up the user envir onment. ” I f you have not do ne so , you mus t enter th e full path name (f or examp le, /usr/fra me/bin/maker).
59 ADOBE FRAMEMAKER 8 User Guide Running F r ameMaker on a r emote sy stem FrameM aker can run loc ally or remotely . When running loc ally , FrameMaker runs as a client ap plication o n a user’ s worksta tion.
CHAPTER 5 60 Starting FrameMak er 3 D esignate a worksta tion as a displa y ser ver by doing on e of the following (where myh o st i s t h e h o s t n a m e o f t h e workstati on): • If yo u are usin g the C shell, en ter sete nv DIS PLA Y myh o st :0.
61 Ap p e n d i x A : U pgradin g fr o m a n ea rlie r versi on If you ha ve an earlier version of A dobe® FrameMaker® installed, you might wan t to retain its setup files and fon t informa tion.
62 CHAPTER 6 U sing existing setup files The reso urce file s an d o ther se tu p files in $F MHO ME/fmini t a nd $FM HO ME/fmini t/ UILa nguage directories let yo u custo mize F rameMak er for yo ur installatio n. ( UILanguage is a user - interface languag e directory , for exam ple, use ngli sh or f ranc ais.
63 ADOBE FRAMEMAKER 8 Installation Guide T o customize the new featur es of F rameMaker, co mpar e your existing r esource files with the standard ones installed with this version. (I f you open the files in FrameMak er, you can use the document co mparison f eatur e to do this .
CHAPTER 6 64 Not e: W i th version 8, you ca n open documen ts crea ted with earl ier versions of F ra meM aker. H owever , you can open a F r a m e M a k e r 8 d o c u m e n t i n e a r l i e r v e r s i o n s o n l y i n d i r e c t l y.
65 ADOBE FRAMEMAKER 8 Installation Guide If you added any o ther Adobe T yp e 1 fon ts to version 7.2 or earlier , follow these steps to add each font to the curr en t ver sion. T o add fonts from v ersion 7.2 or earlier to the current version: C opy al l cust om font f ile s to t he c ur rent font di rect or y ($ FMHOME /f min it/fontdi r).
CHAPTER 6 66.
67 ADOBE FRAMEMAKE R 8 Installing Fr ameMaker for UNIX In d e x A add command 27 Adobe Acrobat 7.0, installing 5 Adobe Acrobat Reader, installing 5 aliases for starting FrameMaker products 18 C CD-ROM.
INDEX 68 fmcopy script 14 fmflsadm program 29–?? ping command 29 reinit command 29 FMHOME environment varia ble 15 fmreport prog ram 32 fmsetupfls s cript 23 fmusersetup script 15 fonts installing 7.
69 ADOBE FRAMEMAKE R 8 Installing Fr ameMaker for UNIX finding , problem s in 34 listing 27 network requirement s 22 obtaining, problems in 35 personal 21 process for getting 31 reassigning 27 registr.
INDEX 70 V variables, environme nt FM_FLS_AUTO 30 FM_FLS_HOST 30 FMHOME 15 LANG 6 XKEYSYMDB 19 X XKEYSYMDB environment variable 19 XkeysymDB file , using u pdated 19.
An important point after buying a device Adobe FrameMaker 8.0 (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Adobe FrameMaker 8.0 yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Adobe FrameMaker 8.0 - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Adobe FrameMaker 8.0 you will learn all the available features of the product, as well as information on its operation. The information that you get Adobe FrameMaker 8.0 will certainly help you make a decision on the purchase.
If you already are a holder of Adobe FrameMaker 8.0, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Adobe FrameMaker 8.0.
However, one of the most important roles played by the user manual is to help in solving problems with Adobe FrameMaker 8.0. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Adobe FrameMaker 8.0 along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
