1.5 OpenWindows Start-up Considerations

Before you start the OpenWindows software, take note of these considerations. If none of these considerations apply to you, skip ahead to "1.6.1 Displaying the OpenWindows Software".

• If it is your responsibility to set up an OpenWindows server on your network, refer to the installation manual for your platform.

• If you are currently running the OpenWindows Version 2 software see Appendix A, Migrating to OpenWindows Version 3.3, or Later Versions.

• If you are currently running the SunView user environment, see Appendix A, Migrating to OpenWindows Version 3.3, or Later Versions.

• If you are currently running a version of OpenWindows that is earlier than Version 3.3, see "1.5.1 The OPENWINHOME Environment Variable" and "1.5.2 Using the Correct Start-Up File".

If you changed the type of mouse device, keyboard, or video adaptor card on your system after installing Solaris, you'll need to run the devconfig program to update system configuration. See the devconfig(1M) man page.

1.5.1 The OPENWINHOME Environment Variable

If you are currently running a version of the OpenWindows software earlier than Version 3.3, you may have set up your system to use the OPENWINHOME environment variable. It is no longer recommended that users set the OPENWINHOME environment variable, either by-hand or from a start-up file.

When you run the openwin command it automatically sets the OPENWINHOME environment variable to /usr/openwin; therefore, you do not need to do it.

If you have set the OPENWINHOME environment variable in either the .profile or .cshrc file in your home directory, comment out the line or delete it altogether before running OpenWindows Version 3.3, or a later version.

To remove, or comment out, the OPENWINHOME environment variable in the .profile or .cshrc file:

1. Open the .profile or .cshrc file using a text editor such as vi.

2. Type a pound sign (#) before the variable, as shown below, or delete the line entirely.

   If you are working in the .profile file, do Step 1; if you are working in the .cshrc file, do Step 2.

   1. In the .profile file:

      #OPENWINHOME=/usr/openwin

   2. In the .cshrc file:

      #setenv OPENWINHOME /usr/openwin

3. Save and quit the file.

4. Unset the OPENWINHOME environment variable (or log out and log back in).

   If you are running the Bourne or Korn shell, do Step 1. If you are running the C shell, do Step 2.

   1. In the Bourne or Korn shell, type:

      $ unset OPENWINHOME

   2. In the C shell, type:

      example% unsetenv OPENWINHOME

   Once you have unset the environment variable you are ready to run the OpenWindows software, as described in "1.6.1 Displaying the OpenWindows Software", in this chapter.

1.5.2 Using the Correct Start-Up File

If you are currently running a version of the OpenWindows software earlier than Version 3.3, it is important to determine the status of your .xinitrc file. The .xinitrc file is an OpenWindows start-up file your home directory that may contain user-defined options.

To determine the status of your .xinitrc file, type the following commands:

$ cd
$ ls -a .xinitrc

Depending on the output of this command, do one of the following things:

• If you do not have a .xinitrc file (that is, the results of the previous ls -acommand does not return a listing for the file) do nothing. If there is no .xinitrc file in your home directory, OpenWindows uses the system default start-up file.

• If you have a .xinitrc file (that is, the result of the previous ls -acommand returns a listing for the file), but you have never made any changes to the file or do not want to keep the changes you have made, do Step 1 in "1.5.2.1 Start-Up File Procedures".

• If you have a .xinitrc file (that is, the result of the previous ls -a command returns a listing for the file), and you have made changes to the file that you want to keep, do Step 2 in "1.5.2.1 Start-Up File Procedures".

1.5.2.1 Start-Up File Procedures

1. To delete the .xinitrc file from your home directory, type the following command:

   $ rm .xinitrc

2. To retain the changes to your .xinitrc file, do the following steps:

   1. Move .xinitrc to .xinitrc.save:

      $ mv .xinitrc .xinitrc.save

   2. Copy /usr/openwin/lib/Xinitrc to .xinitrc in your home directory:

      $ cp /usr/openwin/lib/Xinitrc $HOME/.xinitrc

   3. Add the lines that you want to keep from the .xinitrc.save to .xinitrc.

      ---

      Caution -

      When editing the .xinitrc file, do not add a secondary version of olwm, do not add svenv, and do not remove the line containing /usr/openwin/lib/openwin-sys.

      ---