Downloading and Installing Freedom Desktop

To access the latest copy of this document, please visit

Change to InstallDir (Installation directory). The recommended directory is /usr/local.
cd InstallDir

Choose the appropriate version for your architecture. For instance:
freedom4sunos.tar.Z (SunOS 4.1.x also known as Solaris 1)
freedom4solaris.tar.Z (Solaris 2 also known as SunOS 5.x)
freedom4linux.tar.gz (Linux demo version)

Uncompress the software
uncompress freedom4solaris.tar.Z

Extract the files
tar xvf freedom4solaris.tar

In order to receive a sofkey to unlock the software, send us or fax us the architecture and hostid of the target machine. You should receive a softkey within few days.

Change to the bin directory (freedom_software/bin)
cd InstallDir/freedom_software/bin

Install the softkey by running the installation program
./installkey

Bourne Shell
PATH=InstallDir/freedom_software/bin:$PATH;export PATH

C Shell
setenv PATH InstallDir/freedom_software/bin:$PATH

Use the EDITOR variable to specify the editor of your choice. Freedom Desktop supports any Unix editor (i.e. nedit, vi and emacs). For instance, to use the Motif editor nedit, issue the following command at the shell prompt:

setenv EDITOR nedit

Before starting Freedom Desktop, make sure that the X window server and the window manager are already running. In order to use the OpenWindows server and window manager, follow the procedure below. To run Freedom Desktop, type the following command:

freedom

The following steps of the installation procedure are optional. However, for better results it is recommended that you follow them.

• Using the OpenWindows window manager and applications

To use the OpenWindows environment in conjunction with Freedom Desktop, follow the procedure:

Set the OPENWINHOME variable to point to the directory where OpenWindows reside. For instance:
setenv OPENWINHOME /usr/openwin


Add the OpenWindows directory to your search path. For instance:
setenv PATH /usr/openwin/bin:$PATH


If there is a file called .xinitrc in your home directory. Save a copy of the file.
cp .xinitrc .xinitrc.old


Copy InstallDir/conf/arch/openwin/.xinitrc to your home directory. arch is the name of the target architecture (i.e. sunos5.x).
cp InstallDir/freedom_software/conf/arch/openwin/.xinitrc $HOME/.xinitrc

If there is a file called .openwin-menu in your home directory. Save a copy of the file.
cp .openwin-menu .openwin-menu.old


Copy InstallDir/conf/arch/openwin/.openwin-menu to your home directory. arch is the name of the target architecture (i.e. sunos5.x).

Start the OpenWindows server. This should automatically invoke freedom desktop (don't execute openwin) . Type:
xinit (sunos5.x)
or
xinit -- $OPENWINHOME/bin/xnews (sunos 4.1.x)

• Using the OSF/Motif window manager

If there is already a file called .xinitrc in your home directory. Save a copy of the file.
cp .xinitrc .xinitrc.old

Update your .xinitrc using InstallDir/conf/arch/openwin/.xinitrc as a guide or copy InstallDir/conf/arch/openwin/.xinitrc to your home directory. arch is the name of the target architecture (i.e. sunos5.x).
cp InstallDir/freedom_software/conf/arch/motif/.xinitrc $HOME/.xinitrc

Start the X Window server. This should automatically invoke freedom desktop. There might be other ways of invoking the X window server (i.e. startx); consult with your system administrator for details.
xinit (sunos5.x)
or
xinit -- $OPENWINHOME/bin/xnews (sunos 4.1.x)

If you need to uninstall the software, run the following script:
InstallDir/freedom_software/bin/uninstall

Depending on the window manager used, you might need to remove or restore .xinitrc and .openwin-menu (user's home directory).

In order to troubleshoot problems, check the release notes for the specific architecture (i.e InstallDir/freedom_software/release_notes/sunos4.x).

Freedom Desktop's default colors are grey and white. If you notice any problems with the appearance of Freedom Desktop (fonts and/or colors) make sure that the Freedom resource file is being loaded. This can be enforced by typing:
setenv XENVIRONMENT $HOME/Freedom

Please email comments and suggestions to support@freedom.lm.com