Linux and OS X Installation, Updating, and Removal
Updating and installation is most conveniently handled by using the wr_install script,
downloaded from the same location as the package files. Unlike
earlier releases, this script does not manage the Safe Install feature, so that users
can use the underlying package manager commands for their operating
system directly, if desired. The wr_install script is just a
wrapper around these native commands, but it detects which commands to
use, and which options to give.
However, there is one big exception: the wr_install script
will handle cleanup of old XicTools packages that may exist on
your system. It is highly recommended that all pre-4.3 packages be
uninstalled from your system, to avoid any potential conflicts. The
wr_install script will do this automatically, the first time
a 4.3 package is installed. Of course, you can remove the old
programs by hand using your native package manager commands, however
use of wr_install provides an advantage: existing Xic
and WRspice installations can optionally be saved in the Safe
If is recommended that the initial installation of 4.3 tools, at least,
be performed using wr_install. Future updates of Xic
and WRspice can be performed from within those programs.
Other 4.3 XicTools programs will have a new checking/updating
mechanism to be determined, so chances are that the tedious manual
downloading and installing need only be done once.
Once Xic and WRspice have been installed, updating could
not be simpler. See the program documentation:
give the commands "help passwd" and "help wrupdate".
In Xic , with the mouse pointer in the main drawing window,
type "?!passwd" and "?!update"". These help topics
explain how to set up and use the update features. The programs will
check for updates when started. The user can download and install
updates when available.
- Download the necessary distribution files and scripts.
Probably, the easiest course is to download everything in the
distribution directory for your operating system, into a new, empty
temporary directory. Presently, there are eight package files and two
scripts. When downloading completes, cd to the new
- Make sure that the wr_install and wr_uninstall
scripts are executable (they might not be after the download). If
chmod 0755 wr_install wr_uninstall
- Become 'root'. For future use of the automated updating features
of Xic and WRspice, you will need to have your account
enabled for the "sudo" command, i.e., your account name
should be listed in "/etc/sudoers". For now, you can either
become root explicitly, or sudo a bash shell.
- When installing on other that OS X, you will be given a choice of
installation location. The installation location is under
/usr/local/xictools by default, and can not be changed under
OS X. Other operating systems provide a choice of an alternate path
prefix to replace "/usr/local". Life will be simpler if you
choose the default location, but if necessary, an alternate can be
- Run wr_install with the argument(s) being the names of
the distribution files. This automates the installation procedure.
Do NOT change the names of the files, or wr_install will
probably fail. On Linux with ".rpm" distribution files, you
Or in OS X, from a Terminal window, give
- If you installed in a location other than /usr/local, you
should set the XT_PREFIX environment variable. The
XT_PREFIX environment variable should be set to the name of the
directory corresponding the /usr/local, which we call
/path/mydir below. This will cause all internal default paths
to point to the right directory. Most conveniently, this variable can
be set in the user's shell startup file.
For C shell:
setenv XT_PREFIX /path/mydir
For Bourne/Bash shell:
This is generally all that is required to configure the programs
for an alternative installation location.
- Add the /usr/local/xictools/bin (or equivalent) directory to
your shell search path, if you haven't done so.
If you had a 4.2 distribution of Xic or WRspice installed,
your search path will already have the above directory, but in addition it
may have one or both of
If present, these should be removed from your shell search path. Note
that if you changed the installation location, the /usr/local
will be something else.
You're done, and should be able to run the programs (C-shell users may
have to type "rehash" first).
Removing the Installation
When performing an update, one should never have to remove any
distribution files, unless specifically instructed to do so. This
section describes how to remove the distributions from the system.
These operations must be done as root.
It is recommended to use the wr_uninstall script for package
removal. Users can also use their native packager commands to do
this, except on OS X where there is no such command. There are
probably only two reasons to uninstall a package: if you no longer
have any use for the program and want to get rid of it forever, or if
somehow your installation is corrupted and you want to uninstall and
You need to have root privileges to uninstall packages, and therefor
wr_uninstall should be run as root, or from a bash shell
started under the sudo command.
wr_uninstall progname ...
The arguments are program names from among these: adms, fastcap,
fasthenry, mozy, mrouter, vl, wrspice, xic. Actually, you only
need the first few characters of eacn name, enough to make it
unambiguous. For each program, if a corresponding package is
currently installed, it will be uninstalled. The packages files will
be completely deleted, there will be no saving for Safe