Installing SoftBench Manufacturing Part Number: B6454-97011 June 2000 © Copyright 2000 Hewlett-Packard Company.
Legal Notices The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance, or use of this material. Warranty.
Copyright © 1979, 1980, 1983, 1985-1990 Regents of the University of California. This software is based in part on the Fourth Berkeley Software Distribution under license from the Regents of the University of California. Copyright © 1990 Motorola, Inc. All Rights Reserved. PostScript is a trademark of Adobe Systems, Inc. Copyright © 1985-1986, 1988 Massachussetts Institute of Technology. X Window System is a trademark of the Massachussetts Institute of Technology.
Printing History Table 1 June 2000 B6454-97011 Revised for SoftBench 6.60 Edition 1 September 1999 B6454-93002 Revised for SoftBench 6.50. Edition 1 Cfront-based C++ compiler is no longer provided. February 1999 B6454-90015 Revised for SoftBench 6.30. Edition 1 Network Licensing is no longer required. SoftBench Solutions CD is no longer provided. August 1998 B6454-90011 Edition 1 Patch bundle is no longer provided. PC X server information has been updated.
Contents 1. Preparing for Your Installation Installation Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Choose Which Products to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Note to SoftBench 5.X Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Changes in SoftBench 6.30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Additional SoftBench CM Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 6. Setting Up Network-Distributed Operation Displaying a Remote SoftBench Session Locally . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using SoftBench with Remote Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting the Execution Host in a SoftBench Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents D. Using SoftBench on X Terminals and PC X Servers Configuring an X Terminal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring Reflection X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Accessing Fonts on a Remote HP-UX System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing Reflection X Fonts Locally . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 8
Preparing for Your Installation 1 Preparing for Your Installation This manual describes how to install and configure SoftBench 6.X products. You need superuser (root) access for most of the tasks in this manual. Checklists are provided to help you perform your installation tasks. Checklist A ( Table 1-1) helps you prepare for your installation and helps you choose the appropriate checklist for the remainder of your installation tasks.
Preparing for Your Installation Installation Checklist Installation Checklist Make a copy of Checklist A so you do not need to turn back as you follow the instructions in this chapter. Check off each step as you complete it. Table 1-1 Checklist A New Installation of SoftBench Refer To ❏ 1. Choose which products to install. page 11 2. Choose software servers (for the products you are installing): page 13 ❏ SoftBench execution host ❏ SoftBench CM server ❏ 3. Check your system prerequisites.
Preparing for Your Installation Choose Which Products to Install Choose Which Products to Install If you do not have SoftBench 6.X installed, you need to choose which type of SoftBench to install. SoftBench is available for C and C++. (Limited support is also provided for FORTRAN). In most cases, you should not choose more than one type of SoftBench. For example, if some users on the system want to use C and others want to use C++ and others want to use both, you can install C++ SoftBench on the system.
Preparing for Your Installation Choose Which Products to Install • SoftRCS is no longer provided. The RCS integration with SoftBench is no longer provided. SoftBench now provides SoftBench CM instead. You can also use a third party Configuration Management integration, or you can create your own RCS integration using SoftBench SDK. • SoftBench 6.X does not read softinit files.
Preparing for Your Installation Choose Your Software Servers Choose Your Software Servers This section is intended to help you choose where to install SoftBench and where to set up a SoftBench CM server. SoftBench CM requires a CM server system to manage its archive files. If you have more than one system in a network, you can choose to have your SoftBench CM server reside on a different system than where SoftBench is installed.
Preparing for Your Installation Choose Your Software Servers Choosing Your SoftBench CM Server A SoftBench CM server system will contain the SoftBench CM archive files. When choosing a server system, consider the following: • Keep the number of SoftBench CM servers to a minimum. Each server requires additional system administration in maintaining the SoftBench CM archives. Generally, all archive files for a project should be stored on the same server system.
Preparing for Your Installation Check Your System Prerequisites Check Your System Prerequisites Before installing SoftBench products, you need to check that your system(s) meet all of the necessary prerequisites. Refer to Appendix A, “Prerequisite Details,” on page 59 for further information. Check the SoftBench Release Notes document for any requirements that are not listed in this manual. Computer: HP 9000 Workstation or Server, HP-PA 1.1 or higher Operating System: HP-UX 10.20 or 11.
Preparing for Your Installation Check Your System Prerequisites Disk Space: Table 1-2 The following disk space values are for the SoftBench products with compilers. Disk Space Requirements for SoftBench SoftBench Product Disk Space Required On HP-UX 10.20 On HP-UX 11.0 C SoftBench 286 Mbytes 210 Mbytes C++ SoftBench 322 Mbytes 261 Mbytes SoftBench CM server only a 60 MBytes (plus space for archive files) a. SoftBench CM is included with SoftBench.
Preparing for Your Installation Enter CD Installation Codeword Enter CD Installation Codeword This step is needed only if you are installing SoftBench from an HP-UX Application CD. Skip this step if you are installing from a software depot. SoftBench requires a codeword to allow you to install SoftBench from the CD. The codeword is shipped with your HP-UX Application CD on a certificate entitled Codeword For Updating Software. To use the codeword, edit the file /etc/update.
Preparing for Your Installation Choose Your Installation Checklist Choose Your Installation Checklist Use Table 1-4 to choose the installation checklist you need to complete for your configuration. Make a copy of the checklist you choose, and check off each task in the checklist as you complete it. Table 1-4 Choosing Your Installation Checklist for SoftBench For This Configuration Use This Checklist New Installation of SoftBench.
Preparing for Your Installation Installation Checklists Installation Checklists Use Table 1-4 to choose a checklist. Make a copy of the checklist you choose, and check off each task as you complete it. Table 1-5 Table 1-6 Table 1-7 Checklist B New Installation of SoftBench Refer To ❏ 1. Install SoftBench page 21 ❏ 2. Install Required Patches page 26 ❏ 3. Configure SoftBench page 29 ❏ 4. Verify the Installation page 33 Checklist C Upgrading SoftBench Refer To ❏ 1.
Preparing for Your Installation Installation Checklists 20 Chapter 1
Installing SoftBench 2 Installing SoftBench The instructions that follow describe the steps to install SoftBench from a CD ROM onto a single system. If you want to install SoftBench on more than one system, you may want to use a software depot. Refer to swcopy(1M) for information on setting up a software depot. For an overview of Software Distributor commands, see sd(5). Warning If you are using COBOL SoftBench 5.X and you install SoftBench 6.X, COBOL SoftBench will be removed from your system.
Installing SoftBench Loading the SoftBench Software Loading the SoftBench Software 1. Become the root user on the target (destination) system. 2. If you are installing SoftBench from an HP-UX Application CD, a codeword is required to copy the software from the CD. This is not required if you are installing from a software depot. Refer to “Enter CD Installation Codeword” on page 17 for instructions. 3. Mount the SoftBench CD. You can mount the disk with sam(1M) or mount(1M). 4. Execute swinstall. 5.
Installing SoftBench Loading the SoftBench Software Table 2-1 SD Bundle Names of SoftBench Products Product to Be Installed HP 9000 Workstation SD Bundle HP 9000 Server SD Bundle C++ SoftBench B6451EB B6447EB Japanese C++ SoftBench B6452EB B6448EB SoftBench CM server only To install the SoftBench CM server without SoftBench, use the instructions in “Selecting the SoftBench CM Server Without SoftBench” on page 24. 7.
Installing SoftBench Loading the SoftBench Software Selecting the SoftBench CM Server Without SoftBench If Your System Has a Previous Version of SoftBench If your system has a previous version of SoftBench, do not install the SoftBench CM server without SoftBench. If you have SoftBench 5.X installed on your system, you can do one of the following: • Install SoftBench 6.X rather than just the SoftBench CM server software. SoftBench includes the SoftBench CM server software.
Installing SoftBench Correcting Installation Problems Correcting Installation Problems Problems with NIS SoftBench requires that an entry be added to the /etc/services file. This is normally done for you when SoftBench is installed. If your /etc/services file is managed via the Network Information Service (NIS), an error message will appear in the install log file.
Installing SoftBench Install Required Patches Install Required Patches Some SoftBench products require patches to function correctly. You need to install any required patches before you can use the product. Patch information is available in the following locations: • The latest patch information is available from the World Wide Web. Visit the URL: http://devresource.hp.com/softbench Check the website to see if new patches are required. You can download new patches from the website.
Installing SoftBench After Installing SoftBench After Installing SoftBench Once the products have loaded successfully, you can unmount the CD. Refer to Chapter 3, “Configuring SoftBench,” on page 29 for instructions on configuring the SoftBench products you have installed.
Installing SoftBench After Installing SoftBench 28 Chapter 2
Configuring SoftBench 3 Configuring SoftBench This chapter describes configuration tasks required to run SoftBench. You may choose whether to perform the SoftBench configuration tasks for each user or to inform the users of the configuration steps that they each need to do before they run SoftBench.
Configuring SoftBench Required Configuration Tasks for SoftBench Required Configuration Tasks for SoftBench Setting the PATH Environment Variable The directory /opt/softbench/bin must appear before the required /bin and /usr/bin and /usr/ccs/bin directory paths in each SoftBench user's PATH. /usr/bin/X11 must also appear somewhere in the PATH. Table 3-1 SD Bundle Names of SoftBench Products Shell Examples for Setting PATH sh, ksh Edit your $HOME/.
Configuring SoftBench Required Configuration Tasks for SoftBench Common Desktop Environment (CDE) does not automatically read your .profile or .login file (unless you have configured it to do so). Refer to $HOME/.dtprofile for more information. You need to log out and log in before changes to the .profile or .login file become effective.
Configuring SoftBench For the Latest Configuration Information For the Latest Configuration Information The SoftBench Release Notes contain information on other configuration steps that may be required for SoftBench to run correctly. The /opt/softbench/README file has additional information about the current release of the product. The very latest configuration information is available via the URL: http://devresource.hp.
Verifying SoftBench Installation and Configuration 4 Verifying SoftBench Installation and Configuration This chapter provides information on how to verify that SoftBench is ready to use. Verifying SoftBench Operation To verify that SoftBench operates correctly, do the following: 1. For each SoftBench user, log in as that user. 2. Start one of the window managers supported by SoftBench. 3. Start SoftBench by typing softbench in a terminal window.
Verifying SoftBench Installation and Configuration Correcting SoftBench Startup Problems Correcting SoftBench Startup Problems Here are several possible problems that can occur when starting up SoftBench, along with appropriate remedies. Table 4-1 Troubleshooting SoftBench Problem Possible Causes and Solutions SoftBench main window does not appear on the screen. • Patches required by SoftBench may be missing.
Verifying SoftBench Installation and Configuration Correcting SoftBench Startup Problems Table 4-1 Troubleshooting SoftBench Problem Possible Causes and Solutions SoftBench applications appear on the screen, but colors appear incorrect. • You may be using a schemes file from SoftBench 5.X. In SoftBench 6.X, you should be letting CDE manage your colors. If a *Scheme resource is set, delete it. • The color map may be full; SoftBench automatically switched to a white-on-black color scheme.
Verifying SoftBench Installation and Configuration Correcting SoftBench Startup Problems 36 Chapter 4
Configuring the SoftBench CM Server 5 Configuring the SoftBench CM Server This chapter describes configuration tasks required to set up a SoftBench CM server. Configuring SoftBench CM You must complete the following steps before SoftBench CM will work on your server: 1. Create a user called softcm. 2. Add an entry for the SoftBench CM server to the /etc/inittab file. 3. Start the SoftBench CM server.
Configuring the SoftBench CM Server Creating the softcm User Creating the softcm User The SoftBench CM server program always runs as the user softcm, and all files managed by SoftBench CM are owned by softcm. To create the softcm user, add an entry to the /etc/passwd file that looks something like this: softcm:*:10000:10000:SoftBench CM:/:/bin/sync • You can use any UserID and GroupID numbers that do not conflict with other users in the /etc/passwd file.
Configuring the SoftBench CM Server Adding a SoftBench CM entry to /etc/inittab Adding a SoftBench CM entry to /etc/inittab During installation, a line similar to the following should have been added to your /etc/inittab file: #sbcm:23456a:once:/opt/softbench/sbin/cmserver 'LANG=C' 'TZ=MST7MDT' This entry is used to automatically start the SoftBench CM server each time your system reboots. Make the following changes to the line: 1.
Configuring the SoftBench CM Server Starting the SoftBench CM Server Starting the SoftBench CM Server The softcm entry in /etc/inittab starts the SoftBench CM server each time your system is rebooted. You can also start the SoftBench CM server manually. Use the following instructions to start the SoftBench CM server initially so that you can see that the server has been installed and configured correctly: 1. Log in as root. 2.
Configuring the SoftBench CM Server Verifying the SoftBench CM Server Verifying the SoftBench CM Server Once SoftBench CM has been installed on the server and client systems, and the server program (cmserver) has been started on the server(s), the following test will determine whether your installation of SoftBench CM is successful.
Configuring the SoftBench CM Server Correcting SoftBench CM Startup Problems Correcting SoftBench CM Startup Problems You may see the following errors when you verify access to the archive directory /TestArchive: • fls: no permission for operation on archive item /TestArchive This means that the cm.permission or the inetd.sec files (both on the SoftBench CM server system) may have been modified since the installation. • fls: archive file '/TestArchive' not found This may mean that the cm.
Configuring the SoftBench CM Server Additional SoftBench CM Configuration Additional SoftBench CM Configuration After you start the SoftBench CM server, you will probably want to customize your configuration management environment (such as specifying the access rights for each user and where archive files are stored). See Appendix C, “Customizing SoftBench CM Configuration,” on page 69 for details.
Configuring the SoftBench CM Server Additional SoftBench CM Configuration 44 Chapter 5
Setting Up Network-Distributed Operation 6 Setting Up Network-Distributed Operation This chapter describes how to customize SoftBench to be distributed over a network.
Setting Up Network-Distributed Operation Displaying a Remote SoftBench Session Locally Displaying a Remote SoftBench Session Locally This section describes the requirements to run SoftBench on a remote system and display it on your local system: • Remote SoftBench is supported with the following local window managers: — VUE window manager (HP-UX 10.20 only) — CDE window manager • The system where SoftBench is running needs access to the display server. See xhost(1) for more information.
Setting Up Network-Distributed Operation Using SoftBench with Remote Data Using SoftBench with Remote Data You can use SoftBench with data on a file system that is NFS-mounted or automountable from another system. The mount point can be anywhere you choose. Check the following list to see if you need to do any special setup to access your remote data with SoftBench: • If you are using the automounter to mount remote file systems, you may want to set up the automounter with the -hosts special map.
Setting Up Network-Distributed Operation Setting the Execution Host in a SoftBench Tool Setting the Execution Host in a SoftBench Tool SoftBench Builder and SoftBench Debugger allow you to specify an Execution Host for subprocesses started by that tool. For example in SoftBench Builder, you can specify that the build program (such as make) be executed on another system by setting the compile host to that system name.
Setting Up Network-Distributed Operation Setting the Execution Host in a SoftBench Tool Compile Host Requirements for SoftBench Builder In addition to the general requirements in “Setting the Execution Host in a SoftBench Tool” on page 48, you need to set up the following before you can use a remote compile host from SoftBench Builder: • The directory where SoftBench was installed on the remote compile host needs to be accessible through NFS from the host where SoftBench is running.
Setting Up Network-Distributed Operation Customizing Subprocess Control Customizing Subprocess Control Whenever SoftBench starts a process (either local or remote), it uses the Subprocess Control (SPC) service. This section describes how you can customize SPC behavior. The SPC Authentication Directory SoftBench uses the SPC to start a SoftBench tool on a remote system. Before you can use a remote SoftBench tool, access must be authenticated.
Setting Up Network-Distributed Operation Customizing Subprocess Control Changing the Authentication Directory The default SPC authentication directory is /var/tmp on the remote execution host. An alternate location can be defined. The default location may not always be practical. For example, you may not be able to export /var/tmp with write permission if the parent directories have different access permissions.
Setting Up Network-Distributed Operation Customizing Subprocess Control Other Authentication Configurations If you are using remote SoftBench processes between more than two systems, you may want to set up a single authentication directory for a group of systems. The advantage of this is • it may be much simpler to create and export a single authentication directory.
Setting Up Network-Distributed Operation Customizing Subprocess Control Customizing Environment Variables for SoftBench When one of the SoftBench tools needs to control other processes, such as SoftBench Builder running make, it can run these processes on a different host. To do this type of remote processing, your access rights are checked on the remote system, and your current environment is transmitted to the remote process. To check access rights on the remote system: 1.
Setting Up Network-Distributed Operation Customizing Subprocess Control Using softenv Files with Remote Processes When SoftBench starts a process on a remote system, customizations to environment variables used by SPC are evaluated in the following order: 1. The environment is modified according to the following files on the local host: • /opt/softbench/config/softenv • $HOME/.softenv • $HOME/.softenv.local-host (where local-host is the name of the local system) 2.
Setting Up Network-Distributed Operation Customizing Subprocess Control Creating a Custom softenv File To specify an environment variable in the /opt/softbench/config/softenv, $HOME/.softenv, or $HOME/.softenv.hostname files, use varname=value, where varname is the name of the environment variable and value is the desired value. The format of a softenv file is similar to other shell command files (such as .login) with the following exceptions: • Only environment variable assignments are supported.
Setting Up Network-Distributed Operation Customizing Subprocess Control Controlling Access and Security in SoftBench Remote execution of SoftBench Debugger and remote compiles from SoftBench Builder require that the inetd process be configured and running on the remote system. The normal installation procedures configure the inetd automatically, and the networking services described in the Installing and Administering LAN/9000 manual are required. The inetd.sec file is described in detail in the inetd.
Setting Up Network-Distributed Operation Customizing Subprocess Control Example of Controlling Access For example, on a cluster of three nodes, the inetd.sec file contains the following after installation: mserve spc allow allow hostA hostB hostC hostA hostB hostC To add a new host, simply append it to the end of the line. To add a complete network, simply include the network or subnet component of the address: mserve spc allow allow hostA hostB hostC 192.6.36.* hostA hostB hostC 192.6.36.
Setting Up Network-Distributed Operation Customizing Subprocess Control 58 Chapter 6
Prerequisite Details A Prerequisite Details Prerequisites for SoftBench are described in “Check Your System Prerequisites” on page 15. This appendix provides additional information about the prerequisites.
Prerequisite Details Swap Space Swap Space If not enough swap space is available for SoftBench, processes (including the X server) may abort and data may be lost. Swap space requirements are described in “Check Your System Prerequisites” on page 15. Refer to swapinfo(1M) for information on determining the swap space available.
Prerequisite Details NLS Filesets NLS Filesets To use non-USASCII data-related features of SoftBench, you must have the NLS-AUX fileset and a language-specific fileset for each language you will be using. Support for 16-bit character sets also requires the Asian System Environment (ASE).
Prerequisite Details Kernel Parameters Kernel Parameters For initial use of SoftBench, you may not need to change kernel parameters. It is recommended that you finish installing and verifying simple SoftBench operation before modifying kernel parameters. This is because modifying these parameters necessitates regenerating the kernel, and regenerating the kernel at the same time that you install a product makes troubleshooting problems much more complex.
Prerequisite Details Kernel Parameters Table A-1 Recommended Kernel Parameter Values for SoftBench Parameter Description Recommended Value npty Maximum number of pty devices in the system. The default value is generally sufficient. Systems running more than 10 sessions of SoftBench simultaneously may need to increase this value.
Prerequisite Details System Type System Type SoftBench requires an HP 9000 Workstation or Server, HP-PA 1.1 or higher. To determine the version of HP-PA for your system, do the following: 1. Run the command /bin/uname -m to determine your system type. 2. Look up the HP-PA version for your system type by viewing the file /usr/lib/sched.models For example, if uname -m returns the value 9000/710, and /usr/lib/sched.models has the following entry for 710: 710 1.
SoftBench Directories B SoftBench Directories This appendix describes the directories for SoftBench. SoftBench places most files under /opt/softbench. The following table describes the directory structure which SoftBench creates during installation.
SoftBench Directories SoftBench Directories SoftBench Directories Table B-1 SoftBench Directory Description Subdirectory Description app-defaults Application resources bin Executables charmaps Bit maps config Configurations and default startup files used by SoftBench applications config.5x SoftBench 5.X config files that were saved when SoftBench 6.X was installed. contrib Contributed software for SoftBench.
SoftBench Directories SoftBench Directories Table B-1 SoftBench Directory Description Subdirectory Description newconfig Configuration files for SoftBench customization lib/nls/msg Native Language Support files schemes Color and font scheme files share SoftBench Debugger related files In addition to the above directories, SoftBench places files in the directories described below. Table B-2 Additional SoftBench Directories Directory Description /etc Modified services and inetd.
SoftBench Directories SoftBench Directories 68 Appendix B
Customizing SoftBench CM Configuration C Customizing SoftBench CM Configuration SoftBench CM lets you customize your configuration management environment at the user, system, or global level.
Customizing SoftBench CM Configuration Modifying the Configuration Files Modifying the Configuration Files The following configuration files come with SoftBench CM and are usually maintained by the SoftBench CM administrator. However, each SoftBench CM user can configure the default .fmrc file. The server reads and acknowledges modifications to these files every 30 seconds. The system writes a record to the /var/opt/softbench/cm/msglog file every time it reads a configuration file.
Customizing SoftBench CM Configuration Modifying the Configuration Files begin with a "#" character. Configuring Where Archive Files are Stored The cm.mapping file determines where archive files are physically stored on the server. This file is created during installation and contains default entries that MUST be modified to map to your archive file structure.
Customizing SoftBench CM Configuration Modifying the Configuration Files In this entry, /TestArchive is the logical archive path by which the SoftBench CM client and server communicate, and /var/tmp is the physical path where the example files are stored on the SoftBench CM server. Every file managed by SoftBench CM should have exactly one logical path name. You should not map multiple, logical archive path names to the same physical file or directory. When creating or updating the cm.
Customizing SoftBench CM Configuration Modifying the Configuration Files Defining User Access to the Server The cm.permission file determines users' access rights to the SoftBench CM archive files. When you make changes to this file, they take effect within 30 seconds of saving the file. The cm.permission file consists of a series of entries. Each entry contains three types of fields terminated by a semicolon, as follows: f1 f2 f3 ... [ f2 f3 ... ] ... ; where f1, f2 and f3 are three distinct types.
Customizing SoftBench CM Configuration Modifying the Configuration Files Table C-2 Options Used in the cm.permission and cm.option Files Option Description n Create a new symbolic revision name. o Obsolete a revision. p Modify the mode of a file. q Delete a file and all of its revisions. s Change the state of a revision. t Change the descriptive text for a file. u Delete a lock on a revision. v Rename a file. w Break a lock which is owned by another. x Delete a directory.
Customizing SoftBench CM Configuration Modifying the Configuration Files The permission symbols come in three groups: • lower case letters control access to individual operations • upper case letters control access to groups of operations • numbers set relative priorities for the associated entry These priorities, coupled with the best match criteria, apply a single set of permissions to a given access.
Customizing SoftBench CM Configuration Modifying the Configuration Files Recommended Format for Permissions File You can order fields within an entry in two formats: Format 1. Place user field first and permissions field second. user1@host.domain.hp.com RM /project1 /project2 S /project3 # system admin R / # read-only default ; user2@hp* S /project1 RM /project2 /project3 ; Format 2. Place path field first and permissions field second. / R ; /project1 S ; /project2 RMD ; *@* RM user1@host* user2@15.1.
Customizing SoftBench CM Configuration Modifying the Configuration Files Setting Logging and Debug Options The cm.option file specifies two archive options: LogOptions LogOptions: LogOptions: The recommended (default) setting for logging is to log every modification operation into the /var/opt/softbench/cm/activityLog file. The option letters are position independent (see Table C-2).
Customizing SoftBench CM Configuration Performing SoftBench CM Administrator Tasks Performing SoftBench CM Administrator Tasks SoftBench CM requires a few maintenance tasks to ensure a smooth-running configuration management environment. Migrating Archive Files From RCS You can import individual RCS files into SoftBench CM using the -ARCS option of fci. SoftBench CM can also assume management of an existing hierarchy of RCS files. To migrate archive files from RCS: 1. Edit the /opt/softbench/config/cm.
Customizing SoftBench CM Configuration Performing SoftBench CM Administrator Tasks 5. Run "fci -ARCS file,v" to create the initial SoftBench CM archive files. 6. Begin using SoftBench CM for file versioning. This conversion process preserves the history and contents from the SCCS files. Modifying the Lockinfo File The file /var/opt/softbench/cm/lockinfo holds all archive file lock information and is created and maintained automatically.
Customizing SoftBench CM Configuration Performing SoftBench CM Administrator Tasks Moving Archive Storage Locations As a project grows and you add more files to an archive, the archive may exceed the size of the disk. Several options exist for moving archive locations: To move an entire archive hierarchy to another disk: 1. Stop the cmserver process. 2. Copy or move the hierarchy. 3. Modify the cm.mapping file to reflect the new physical location.
Customizing SoftBench CM Configuration Performing SoftBench CM Administrator Tasks All changes should be made such that the logical paths to files are not modified. This way, users are less affected by the move and locks are preserved. Changing the logical hierarchy during a move can cause loss of lock information. Troubleshooting SoftBench CM uses archive log files for quick resolution of problems you may encounter.
Customizing SoftBench CM Configuration Performing SoftBench CM Administrator Tasks 82 Appendix C
Using SoftBench on X Terminals and PC X Servers D Using SoftBench on X Terminals and PC X Servers SoftBench requires a number of special fonts to support all its functions. When you run SoftBench on an HP-UX workstation, your X server finds the necessary fonts under the /opt/softbench/fonts directory. However, if you use an X terminal or PC-based X server software, your display will not find the necessary fonts. SoftBench issues font errors and warnings to notify you of the problem.
Using SoftBench on X Terminals and PC X Servers When you have correctly configured your X display using one of the above options, you should not see any font errors when running SoftBench, either in stdout or in dialog boxes, with one exception. On all PC X servers, a warning dialog may appear when you first start SoftBench Online Help. This warning can be ignored. For the latest fonts and font information, refer to the URL: http://devresource.hp.
Using SoftBench on X Terminals and PC X Servers Configuring an X Terminal Configuring an X Terminal Accessing SoftBench fonts on most X terminals is very straightforward. Using a font server is the recommended solution. If that is not an acceptable option, configure the X terminal to retrieve fonts from a remote file system. In addition to the basic X fonts under /usr/lib/X11/fonts, you should also retrieve the fonts under /opt/softbench/fonts.
Using SoftBench on X Terminals and PC X Servers Configuring Reflection X Configuring Reflection X SoftBench 6.X supports version 6.00 of Reflection X. Other versions have not been tested. Reflection X can access its fonts from a font server, from a remote file system, or from the PC's local file system. See the Reflection X documentation for details on accessing font servers and modifying the X font search path.
Using SoftBench on X Terminals and PC X Servers Configuring Reflection X The xset command must be executed after you start mwm or other window manager. Each SoftBench user can add this command to his or her X startup script. If you prefer, you could create a SoftBench startup script that adds the font paths and then starts SoftBench. This allows you to handle all X font issues in one location. Be aware that the "xset +fp" command adds the fonts to the start of the font path.
Using SoftBench on X Terminals and PC X Servers Configuring Exceed Configuring Exceed SoftBench 6.X supports version 5.1.3.0 of Exceed. Other versions have not been tested. Exceed can retrieve its fonts from a font server or from locally-installed font files. Exceed cannot use standard Unix-format X fonts, so you cannot access fonts on a remote file system. See the Exceed documentation for details on accessing a font server or for changing the X font path.
Using SoftBench on X Terminals and PC X Servers Configuring PC-Xware Configuring PC-Xware SoftBench 6.X supports version 4.08.00 of PC-Xware. Other versions have not been tested. PC-Xware can retrieve its fonts from a font server or from locally-installed font files. PC-Xware cannot access fonts on an HP-UX system. PC-Xware uses a Font Path to determine where to find the fonts requested by X applications.
Using SoftBench on X Terminals and PC X Servers Configuring PC-Xware After unpacking the zip file, bring up the PC-Xware GUI and choose “Configure: X Server -> Fonts”. Add the following font directory names, in this order, to the beginning of the Font Path. softbench hp_roman8 x11-iso Misc Other applications may need the other font directories listed in the Font Path, so do not remove them from the path. When you are through, restart PC-Xware to access the new fonts.
Index Symbols /etc/inittab entry for SoftBench CM, 39 /etc/X0.hosts, 56 /usr/adm/inetd.
Index migration, 78 README file, 32 Reflection X, configuring for SoftBench, 86 Release notes, 32 Remote data, 47 execution, 48 execution on local display, 46 V Verifying SoftBench, 33 SoftBench CM, 41 S SCCS migration, 78 Security, 56, 73, 77 Server, choosing for SoftBench CM, 14 SoftBench configuring, 30 directories, 65 execution host, 13 troubleshooting, 33 verifying, 33 SoftCM /etc/inittab entry, 39 accessing, 73, 77 administration, 69, 79 choosing the server, 14 cmserver errors, 40 configuring, 37 cu
