Configuring Rose for UNIX/Linux

This chapter details Rose for UNIX/Linux configuration, performed after installation. You must complete these steps before using Rose.

The following topics are covered in this section:

• Rose for UNIX/Linux Configuration Files
• Rose.ini File Replace By rose.reg
• Configuring Your Printer
• Using Rose for UNIX/Linux
• Initial Runtime Instructions When Upgrading
• Installing and Utilizing Converted Fonts Provided in this Release
• Configuring the Rose/ClearCase Integration

---

Rose for UNIX/Linux Configuration Files

Executing rational_dir/releases/rose.I.J.K/bin/rose will run the Rose configuration file config.sh prior to bringing up Rose. The configuration file sets environment information such as the ROSE home directory and location of the license file.

---

Rose.ini File Replace By rose.reg

Any settings previously in the Rose.ini file are now in the registry file, rose.reg. This new registry file is located in the rational_dir/releases/rose.I.J.K/registry directory of the release. The settings in this file are entered in your registry, after running "rose_cleanup" and then "rose". Any changes made to the release rose.reg file will apply to all users running rose. If you wish to make changes specific for your environment, a rose.reg.template file is available in rational_dir/releases/rose.I.J.K/registry. Copy this file to your $HOME directory and name it $USER.reg. Edit this file with the settings you prefer, run rose_cleanup and then rose. Rose will automatically register your $HOME/$USER.reg file and your settings will be available in your Rose session.

---

Configuring Your Printer

Perform the following steps to configure your printer for use with Rose for UNIX/Linux.

• You may print to your default $PRINTER by selecting the appropriate print options within Rose. Rose will print to the printer defined in the PRINTER environment variable.
• You may install a default printer, or redefine or add ports by editing your $HOME/windows/win.ini file as described below. Any changes made to your $HOME/windows/win.ini will apply to your personal configuration.

  You may also edit the release win.ini file (rational_dir/releases/rose.I.J.K/mw/win.ini). In this case, the same change will apply to any new user who runs the release.

  • Specify the default printer under the "[windows]" section, using the following syntax:

    device=outputdevicename, PSCRIPT, portconnection:
    

    The keyword "PSCRIPT" (PostScript) is used in place of the 'devicedriver'.

    Rose for UNIX/Linux supports PostScript printing only.

  • Specify the UNIX/Linux command in the "[ports]" section. The "[ports]" section lists available communication and printer ports. The "LPTn" keywords are mapped to UNIX/Linux commands. In the example below LPT1 and LPT2 are mapped to the print command "lp". The print job output is sent to a file. The output file is then sent to the printer. The term "%s" tells the system to substitute the name of the PostScript intermediate output file. The term "-dps1700" in the example directs the print job to a printer named "ps1700".

    [ports]
    LPT1:=lp -c "%s"
    LPT2:=lp -c -dps1700 "%s"
    LPT3:=
    

  Note: When using lp, the -c option should always be used.

  • Rose does not use the "[PrinterPorts]" section. Modifying this section will have no effect.
  • The "[devices]" section lists the active and inactive output devices that can be accessed by device driver "PSCRIPT" and specifies 'ports' to which these devices are connected. In the following example, "Default Postscript Printer=PSCRIPT,LPT1:" specifies that the printer is connected to the PSCRIPT queue that is connected to LPT1:

    [devices]
    Default Postscript Printer=PSCRIPT,LPT1:
    Postscript Printer QMS=PSCRIPT,LPT2:
    

    The devices listed in this section will appear in the File > Print ... dialog, under "Name". In this dialog you may select the printer you wish to use.

---

Using Rose for UNIX/Linux

Use the following commands to start Rational Rose products:

Product	Command
Rose for UNIX/Linux	rose
Analyzer*	analyzer
Rose Model Integrator	modelint

*Not available in Rose Linux x86 release due to availability of ANSI C++.

These commands are shell scripts contained in the rational_dir/releases/rose.I.J.K/bin directory.

---

Initial Runtime Instructions When Upgrading

Any user running a previous version of Rose for UNIX/Linux, should do the following prior to running Rose.

• Run rational_dir/releases/rose.I.J.K/bin/rose_cleanup

It is only necessary to perform this step once - prior to running Rose for UNIX/Linux.

To run Rose, see the previous topic Using Rose for UNIX/Linux .

---

Installing and Utilizing Converted Fonts Provided in this Release

Rose for UNIX/Linux includes fonts that are compatible and may be used on both PC and UNIX/Linux displays. For more information on using these fonts, please see the Release Notes.

---

Configuring the Rose/ClearCase Integration

It may be necessary to reconfigure a previous Rose/ClearCase integration set up. Prior to using the Rose/ClearCase integration with this release, review the following file (located in this release):

rational_dir/releases/rose.I.J.K/addins/clearcase/README