
SMARTWARE INSTALL README


Creating the SmartWare Directory
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  Option 1:

	If you are installing SmartWare for use by yourself only, the
	recommended location is a subdirectory called angoss below
	your home directory.

	To create and move to this directory, use the following
	commands:

		cd
		mkdir angoss
		cd angoss

  Option 2:

	If you are installing SmartWare for use by a number of users, the
	recommended location is /usr/angoss. You will probably need
	super user access to perform the following commands.

	As super user, create the directory then change the ownership of
	that directory to an appropriate user. For example:

		su
		mkdir /usr/angoss
		chown smartusr /usr/angoss

	Note: Creating a specific SmartWare user may make
	administration of the system easier. For instance, the above
	example uses one called smartusr. However, this is not
	necessary and any user, other than the super user, is valid.





Installing the SmartWare Packages
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  Step 1: Become the appropriate user.

	If you are not already the appropriate user, use the su command
	to switch to it. For example:

		su smartusr

	This is required because, after issuing the installation command,
	the current user will own the SmartWare files. Note that this can
	be anyone except the super user. If you restore as the super user,
	ownership of SmartWare files may be unpredictable.

  Step 2: Change to the directory that contains the SmartWare packages.

	If you are not already in this directory, change to it. For example:

		cd /usr/angoss

  Step 3: Run the installation script

	The anginstall script uncompresses then unarchives each of the
	SmartWare packages and optionally deletes each package after it
	is processed. Note that this script must be run from the directory
	that contains the packages.

	The anginstall script has the following command line parameters:

	-d <dir>	The destination directory. If the current
			directory and the destination directory are not
			the same, the -d parameter must be used. By
			default, the current directory is used.

	-r		Remove packages after processing. Cannot be used
			with the -s parameter. *

	-s		Save (do not remove) packages after processing.
			Cannot be used with the -r parameter. By default,
			packages are not removed. *

	-x		Display usage information. This is equivalent to
			using no parameters.

	* If you are installing from a read-only directory or CD ROM,
	the packages are copied before they are uncompressed. In this
	case, the -r and -s parameters refer to the copied files.

	At least one parameter must be used. For example, to install
	SmartWare in the recommended directory and remove the
	packages, execute:

		./anginstall -r -d /usr/angoss

	When the script has successfully completed its processing, a
	directory structure below the destination directory will contain
	the SmartWare files.

	Note: You can avoid installing one (or more) of the packages by
	deleting it prior to running the anginstall script. For example, to
	avoid installing the tutorials, delete the package named tutorial.
	Do not delete base or system. Also, the X11 and font packages
	are required for X and the char package is required for character
	mode.

  Step 4: Setting environment variables.

	To run properly, you must have the location of the SmartWare
	executable files in the PATH variable. If you have installed in the
	recommended location, add the following directory to your
	PATH - see the example for the Bourne and C shells:

		/usr/angoss/bin

	Also, the ANGOSS environment variable must be set. If you
	used the recommended installation location, it should be set to
	the following directory - see the example for the Bourne and C
	shells:

		/usr/angoss

	For the Bourne shell, the following lines can be inserted at the
	end of a user's .profile file:

		PATH=/usr/angoss/bin:$PATH
		export PATH
		ANGOSS=/usr/angoss
		export ANGOSS

	For the C shell, insert the following lines at the end of a user's
	.login or .cshrc file:

		set path = (/usr/angoss/bin $path)
		setenv ANGOSS /usr/angoss

	If you are running SmartWare on a SUN machine, the
	LD_LIBRARY_PATH variable on SUN machines must be set to
	the shared library paths and the ANGOSS lib directory. For
	example:

		/usr/lib/X11:/opt/SUNWmotif/lib:/usr/angoss/lib

  Step 5: Run the X11 font installation script.

	If you intend to run SmartWare on X11, execute the xfontinstall
	script. This installs the ANGOSS SFF fonts recommended for
	use as the SmartWare WYSIWYG fonts (e.g., font.italic). The
	script must be run from the ANGOSS root directory - super user
	access is probably required. For example:

		cd /usr/angoss
		su
		./xfontinstall

	Although no parameters must be passed, the xfontinstall script
	uses:

	-d <dir>	The font destination directory. By default,
			/usr/lib/X11/fonts/misc is used except on the SUN
			where /usr/openwin/lib/fonts is the destination.

	-x11 <dir>	The location of the X11 executables: mkfontdir
			and xset. By default, the script looks in
			/usr/bin/X11, /usr/X11/bin, or /usr/openwin/bin.

	-pcf		Font type. Default on all but UnixWare and SUN.

	-snf		Font type. Default on UnixWare.

	-fb		Font type. Default on SUN

	-x		Display usage information.




Nodes
~~~~~

	After installation, SmartWare does not yet contain serial numbers or
	user nodes. If no user nodes are present, SmartWare will run in
	demonstration mode.

	Note: Printing from any module and saving in the wordprocessor and
	spreadsheet modules are disabled when running in this mode.

  Adding Initial Nodes

	A node key card, included with the product, specifies two key
	codes used to generate the first node - this does not apply to
	downloaded or demonstration copies of SmartWare unless nodes
	were ordered separately (see the order.txt file in the angoss
	root directory).

	To add the initial nodes, the newnodes program is executed in
	the nodes directory. For example:

		cd /usr/angoss/nodes
		/usr/angoss/bin/newnodes nodes.usr <environment_key>
		/usr/angoss/bin/newnodes devnodes.usr <developer_key>




SEE THE readdemo.txt FILE FOUND IN THE ANGOSS ROOT DIRECTORY
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

