<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>Installations on PCGen Documentation</title>
    <link>http://docs.pcgen.com/installation.html</link>
    <description>Recent content in Installations on PCGen Documentation</description>
    <generator>Hugo -- gohugo.io</generator>
    <language>en-us</language>
    <lastBuildDate>Mon, 01 Aug 2016 00:00:00 +0000</lastBuildDate>
    <atom:link href="http://docs.pcgen.com/installation.xml" rel="self" type="application/rss+xml" />
    
    <item>
      <title>Index : Installation of Java and PCGen</title>
      <link>http://docs.pcgen.com/installation/installation_index.html</link>
      <pubDate>Mon, 01 Aug 2016 00:00:00 +0000</pubDate>
      
      <guid>http://docs.pcgen.com/installation/installation_index.html</guid>
      <description>&lt;p&gt;The following sections describe how to install Java and PCGen Manually
for PC, Macintosh, and the UNIX and Linux varieties.&lt;/p&gt;

&lt;p&gt;The first section describes the steps for manually installing Java on
your specific OS and how to determine what version you may have and
which version to install.&lt;/p&gt;

&lt;p&gt;The later sections describes how to install PCGen directly from the zip
files, and how to upgrade from a previous version.&lt;/p&gt;

&lt;p&gt;PCGen is distributed in 4 different versions:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;pcgenXXX_full.zip : everything including GMGen and PDF, best
installed in new directory.&lt;/li&gt;
&lt;li&gt;pcgenXXX_partial.zip : everything except the GMGen plugins.&lt;/li&gt;
&lt;li&gt;pcgenXXX_win_install.exe : A Windows specific installer.&lt;/li&gt;
&lt;li&gt;pcgenXXX_mac_install.dmg : A Macintosh specific installer.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Where XXX is the version number of PCGen (e.g. 5140 for version 5.14.0.)&lt;/p&gt;

&lt;p&gt;The platform specific installers are the same PCGen version everyone
else is using, just packaged with installers which target Windows and
Mac OSX users specifically. Typically there is a gap between when the
official release is done and when these special installers are ready.&lt;/p&gt;

&lt;hr /&gt;
</description>
    </item>
    
    <item>
      <title>Installing Java</title>
      <link>http://docs.pcgen.com/installation/java.html</link>
      <pubDate>Mon, 01 Aug 2016 00:00:00 +0000</pubDate>
      
      <guid>http://docs.pcgen.com/installation/java.html</guid>
      <description>

&lt;p&gt;PCGen 5.10.2 and higher requires Java version 1.5.0_x or higher.
Previous versions (5.10.1 and below) will run under Java 1.4.x.&lt;/p&gt;

&lt;h2 id=&#34;on-windows-operating-systems&#34;&gt;On Windows Operating Systems&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;Open Start Menu&lt;/li&gt;
&lt;li&gt;Open Programs&lt;/li&gt;
&lt;li&gt;select MS-DOS Prompt  (Alternately, you can click Start, then Run,
and type &amp;lsquo;command&amp;rsquo; in the window and hit ok)&lt;/li&gt;
&lt;li&gt;type &amp;ldquo;java -version&amp;rdquo; (without the quotes)&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;You need to see the following or something similar:&lt;/p&gt;

&lt;p&gt;&lt;code&gt;java version &amp;quot;1.5.0_11&amp;quot; Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_11-b03) Java HotSpot(TM) Client VM (build 1.5.0_11-b03, mixed mode)&lt;/code&gt;&lt;/p&gt;

&lt;p&gt;If you see a correct version of java, close the MS-DOS window and you
should be able to run PCGen.&lt;/p&gt;

&lt;p&gt;If you do not see the correct version, close the MS-Dos window and go to
&lt;a href=&#34;http://java.com/&#34;&gt;http://java.com/&lt;/a&gt; and download the latest non-beta version (currently
1.6.0_01 as of April 2007)&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Click &amp;ldquo;Download Now&amp;rdquo;&lt;/li&gt;
&lt;li&gt;Verify the version offered is suitable for your system, if not,
click on &amp;ldquo;Download other Java software versions&amp;rdquo;&lt;/li&gt;
&lt;li&gt;Click &amp;ldquo;Begin Download&amp;rdquo;&lt;/li&gt;
&lt;li&gt;Follow the instructions to install Java&lt;/li&gt;
&lt;/ol&gt;

&lt;h2 id=&#34;on-macintosh-apple-operating-systems&#34;&gt;On Macintosh/Apple Operating Systems&lt;/h2&gt;

&lt;p&gt;The Java Runtime Environment is only available on Mac OS X. Mac 8 &amp;amp; 9
users will have to use Virtual PC and install Java for Windows by
following the &lt;strong&gt;Windows&lt;/strong&gt; steps in the section above. For PCGen PCGen
5.10.2 (and higher) you&amp;rsquo;ll want to use Java 1.5.0_x. This means that
you&amp;rsquo;ll need Mac OS 10.4.x to run the latest version of PCGen, e.g.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Mac OS X 10.2.8 runs Java version 1.4.1_x.&lt;/li&gt;
&lt;li&gt;Mac OS X 10.3.3 runs Java version 1.4.2_x.&lt;/li&gt;
&lt;li&gt;Mac OS 10.4.x runs Java version 1.5.0_x.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Mac OS X users should be able to open a command line and type &amp;ldquo;java
-version&amp;rdquo; (without the quotes). If you see java version 1.5.0_x (or
higher) then you are good to go, though there have been some issues
exporting to PDF under java 1.4.1 on Mac OS 10.2.&lt;/p&gt;

&lt;p&gt;If you don&amp;rsquo;t have the right version, then visit
&lt;a href=&#34;http://www.apple.com/downloads/macosx/apple&#34;&gt;http://www.apple.com/downloads/macosx/apple/&lt;/a&gt;
and download Java for Mac OS X and install it. Then you should be ready
to launch PCGen.&lt;/p&gt;

&lt;h2 id=&#34;on-unix-and-linux-operating-systems&#34;&gt;On UNIX and Linux Operating Systems&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;Open a command prompt&lt;/li&gt;
&lt;li&gt;type &amp;ldquo;java -version&amp;rdquo; (without the quotes)&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;You need to see the following or something similar:&lt;/p&gt;

&lt;p&gt;&lt;code&gt;java version &amp;quot;1.5.0_11&amp;quot; Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_11-b03) Java HotSpot(TM) Client VM (build 1.5.0_11-b03, mixed mode)&lt;/code&gt;&lt;/p&gt;

&lt;p&gt;If you see the correct version of java, close the command prompt window
and you should be able to run PCGen.&lt;/p&gt;

&lt;p&gt;If you do not see the correct version, close the command prompt window
and go to &lt;a href=&#34;http://java.com/&#34;&gt;http://java.com/&lt;/a&gt; and download the latest non-beta version
(currently 1.6.0_01)&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Click &amp;ldquo;Download Now&amp;rdquo;&lt;/li&gt;
&lt;li&gt;Verify the version offered is suitable for your system, if not,
click on &amp;ldquo;Download other Java software versions&amp;rdquo;&lt;/li&gt;
&lt;li&gt;Click &amp;ldquo;Begin Download&amp;rdquo;&lt;/li&gt;
&lt;li&gt;Follow the instructions to install Java&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Now you should be ready to launch PCGen.&lt;/p&gt;

&lt;hr /&gt;

&lt;p&gt;&lt;a href=&#34;http://validator.w3.org/check?uri=referer&#34;&gt;&lt;img src=&#34;../images/system/valid-html401.png&#34; alt=&#34;Valid HTML 4.01
Strict&#34; /&gt;&lt;/a&gt;&lt;/p&gt;
</description>
    </item>
    
    <item>
      <title>Installing PCGen Manually</title>
      <link>http://docs.pcgen.com/installation/pcgen.html</link>
      <pubDate>Mon, 01 Aug 2016 00:00:00 +0000</pubDate>
      
      <guid>http://docs.pcgen.com/installation/pcgen.html</guid>
      <description>

&lt;p&gt;If you have PCGen currently installed on your system, you can either
install the new version into a new directory or overwrite the old
version on your system. The PCGen team recommends strongly that you
install new versions into a new directory.&lt;/p&gt;

&lt;h2 id=&#34;windows-users&#34;&gt;Windows Users&lt;/h2&gt;

&lt;p&gt;We recommend that you use the Windows installer.&lt;/p&gt;

&lt;h2 id=&#34;mac-users&#34;&gt;Mac Users&lt;/h2&gt;

&lt;p&gt;We recommend that you use the OSX Mac Installer,
&lt;em&gt;pcgenXXX_mac_install.dmg&lt;/em&gt; .&lt;/p&gt;

&lt;p&gt;This configuration of the program includes all the necessary files
included with the program package, or app file. You can still access the
files by right clicking the program and choosing &lt;strong&gt;Show Package
Contents&lt;/strong&gt; . See the notes included in the installer for all the
details.&lt;/p&gt;

&lt;h2 id=&#34;other-system-or-advanced-users&#34;&gt;Other System (or Advanced) Users&lt;/h2&gt;

&lt;p&gt;Pick the package with the features you want and unzip it. It is highly
recommended that you use a new directory for every new release. Once the
package is unzipped, see &lt;em&gt;docs\index.html&lt;/em&gt; for the full documentation.&lt;/p&gt;

&lt;p&gt;Note: Installing a new version over an old version of PCGen may not run
well. See &lt;a href=&#34;../installation/upgradepcgen.html&#34;&gt;Upgrading PCGen&lt;/a&gt; for further
info.&lt;/p&gt;

&lt;p&gt;A fresh install is best performed by &lt;em&gt;unzipping pcgenXXX_full.zip&lt;/em&gt; to a
desired folder on your computer. To run the application, run either
&lt;em&gt;pcgen.jar&lt;/em&gt; (the Java executable) or &lt;em&gt;pcgen.bat&lt;/em&gt; (Windows, which will
also open a debug window which will display any errors during the run)
or pcgen.sh (UNIX and Linux).&lt;/p&gt;

&lt;p&gt;To transfer characters from one version of PCGen to the new version of
PCGen, copy the pcg files from the &amp;ldquo;characters&amp;rdquo; directory from the old
version of PCGen to the new version.&lt;/p&gt;

&lt;p&gt;NOTE: If you copy PCGen from one location to another you must delete the
&lt;em&gt;options.ini&lt;/em&gt; file. This file holds directory locations that will no
longer be valid! Deleting the options.ini file will reset PCGen to all
its default settings. As such, note your current settings before
proceeding. A new file will be created when PCGen is started if
necessary.&lt;/p&gt;

&lt;hr /&gt;
</description>
    </item>
    
    <item>
      <title>Requirements for PCGen</title>
      <link>http://docs.pcgen.com/installation/requirements.html</link>
      <pubDate>Mon, 01 Aug 2016 00:00:00 +0000</pubDate>
      
      <guid>http://docs.pcgen.com/installation/requirements.html</guid>
      <description>&lt;ul&gt;
&lt;li&gt;All versions of PCGen need Sun&amp;rsquo;s Java Runtime Environment (JRE)
which is available for all common OS&amp;rsquo;s, including Windows, Mac OS,
UNIX and Linux.&lt;/li&gt;
&lt;li&gt;PCGen 5.10.2 (and above) needs to run under Sun&amp;rsquo;s JRE (Java) 1.5.x
(or above).&lt;/li&gt;
&lt;li&gt;If you wish to view PDF output sheets, you&amp;rsquo;ll need a PDF viewer.&lt;/li&gt;
&lt;li&gt;Minimum RAM is 256MB (recommended 1-2GB)&lt;/li&gt;
&lt;li&gt;Minimum CPU is 1GHz (recommended 2Ghz+)&lt;/li&gt;
&lt;li&gt;200MB of free HD space&lt;/li&gt;
&lt;/ul&gt;

&lt;hr /&gt;
</description>
    </item>
    
    <item>
      <title>Upgrading PCGen</title>
      <link>http://docs.pcgen.com/installation/upgradepcgen.html</link>
      <pubDate>Mon, 01 Aug 2016 00:00:00 +0000</pubDate>
      
      <guid>http://docs.pcgen.com/installation/upgradepcgen.html</guid>
      <description>

&lt;p&gt;If you have PCGen Currently installed on your system, you can overwrite
it with a newer version to maintain your settings and the location of
your characters. This will unfortunately, unless you have taken
precautions against it, also overwrite your homebrew datasets and
gamemode folder. This page provides some guidance in how best to avoid
these problems by helping you prepare your homebrew and custom data for
transfer into an updated version of PCGen.&lt;/p&gt;

&lt;p&gt;NOTE: Additional information about upgrading PCGen versions may be
available in the &lt;a href=&#34;http://sourceforge.net/docman/display_doc.php?docid=104618&amp;amp;group_id=25576&#34;&gt;Release
Notes&lt;/a&gt;
.&lt;/p&gt;

&lt;hr /&gt;

&lt;h2 id=&#34;important-files-to-know-about-before-the-upgrade&#34;&gt;Important Files To Know About before the Upgrade&lt;/h2&gt;

&lt;p&gt;The &lt;span class=&#34;lstfile&#34;&gt; options.ini &lt;/span&gt; and &lt;span
class=&#34;lstfile&#34;&gt; filter.ini &lt;/span&gt; files, see below, are automatically
stored in the users home directory and are picked up automatically when
PCGen is upgraded. If the old files are not desired, the new &lt;span
class=&#34;lstfile&#34;&gt; filepaths.ini &lt;/span&gt; file can be deleted. PCGen will
then ask for where the new files are to be placed.&lt;/p&gt;

&lt;p&gt;&lt;span class=&#34;lstfile&#34;&gt; filepaths.ini &lt;/span&gt;&lt;/p&gt;

&lt;p&gt;This file tells PCGen the location of the other ini files so you can
change the &lt;span class=&#34;lstfile&#34;&gt; filepaths.ini &lt;/span&gt; to point to the
folder which contains the &lt;span class=&#34;lstfile&#34;&gt; options.ini &lt;/span&gt; and
&lt;span class=&#34;lstfile&#34;&gt; filter.ini &lt;/span&gt; that you want to use.&lt;/p&gt;

&lt;p&gt;&lt;span class=&#34;lstfile&#34;&gt; options.ini &lt;/span&gt;&lt;/p&gt;

&lt;p&gt;This file holds your PCGen Preferences, such as file paths, so if you
are going to point to your old one you may need to correct various paths
to things such as the location of the output sheets.&lt;/p&gt;

&lt;p&gt;WARNING: Installing a new version of PCGen over an old version may cause
the new version to not run well. If you experience some unexpected
behavior after upgrading, please try deleting the &lt;span class=&#34;lstfile&#34;&gt;
options.ini &lt;/span&gt; file, or you may choose to rename it in order to
preserve the file. The &lt;span class=&#34;lstfile&#34;&gt; options.ini &lt;/span&gt; file
contains information on structure and contents that may have changed
with the new version, rendering it useless if different implementations
become mixed in the file.&lt;/p&gt;

&lt;p&gt;&lt;span class=&#34;lstfile&#34;&gt; filter.ini &lt;/span&gt;&lt;/p&gt;

&lt;p&gt;This file holds the various filters on each of the tabs. (See the filter
button in the docs)&lt;/p&gt;

&lt;p&gt;See &lt;a href=&#34;../installation/upgradepcgen.html#custom&#34;&gt;Migrating Custom Data Sets&lt;/a&gt;
below.&lt;/p&gt;

&lt;h2 id=&#34;upgrading-on-the-windows-platform&#34;&gt;Upgrading on the Windows Platform&lt;/h2&gt;

&lt;p&gt;The steps for upgrading PCGen on the Windows platform are included
below:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Create a new PCGen directory. e.g. &lt;em&gt;C:\PCGen\PCGen_x.x.x&lt;/em&gt; .&lt;/li&gt;
&lt;li&gt;Unzip the pcgenXXX_full.zip into the new folder. (We recommend that
you use the Windows install file for best results.)&lt;/li&gt;
&lt;li&gt;Copy the old &lt;span class=&#34;lstfile&#34;&gt; *.ini &lt;/span&gt; files, custom
datasets, homebrew datasets, and homebrew gamemode files, as
required, back to your PCGen directory.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Note: Using the Windows installer automatically installs PCGen in a new
folder.&lt;/p&gt;

&lt;h2 id=&#34;upgrading-on-the-macintosh-platform&#34;&gt;Upgrading on the Macintosh Platform&lt;/h2&gt;

&lt;p&gt;The steps for upgrading PCGen are included below:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Download and mount the latest &lt;em&gt;pcgenXXX_mac_install.dmg&lt;/em&gt; file.&lt;/li&gt;
&lt;li&gt;Locate the PCGen directory. e.g. &lt;em&gt;Applications/PCGen_x.x.x&lt;/em&gt; .&lt;/li&gt;
&lt;li&gt;Drag and drop &lt;em&gt;PCGen X.X.X.app&lt;/em&gt; from the dmg file into the
PCGen folder.&lt;/li&gt;
&lt;li&gt;Copy the old custom datasets, homebrew datasets, and homebrew
gamemode files, as required, to the appropriate folders inside the
PCGen application package. The package contents can be accessed by
Command-Clicking (Right-Click) on the application package and
pulling down to &lt;strong&gt;Show Package Contents&lt;/strong&gt; .&lt;/li&gt;
&lt;/ol&gt;

&lt;h2 id=&#34;span-id-custom-span-migrating-custom-data-sets&#34;&gt;&lt;span id=&#34;custom&#34;&gt;&lt;/span&gt; Migrating Custom Data Sets&lt;/h2&gt;

&lt;p&gt;PCGen provides two simple ways of adding your own data, these are the
built-in LST Editors and the starter data set my_dataset. Both of these
need some attention when upgrading PCGen.&lt;/p&gt;

&lt;p&gt;WARNING: The data syntax for the old version of PCGen may be incorrect
for the new version so before you start up PCGen you should verify your
data&amp;rsquo;s compatibility with the new version of PCGen. You can check with
the PCGen community forums to find out what tools may be available to
help you with this task.&lt;/p&gt;

&lt;h3 id=&#34;migrating-data-created-in-the-lst-editor&#34;&gt;Migrating Data Created in the LST Editor&lt;/h3&gt;

&lt;p&gt;If, as is recommended, you install PCGen into a new directory each time
you upgrade, you will need to copy over the data created using the LST
Editors. To do this follow these steps.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Stop PCGen, if it is currently running. PCGen must not be running
when you copy the files, as PCGen writes a new copy of these files
on exit.&lt;/li&gt;
&lt;li&gt;Copy the data/customsources folder and all of its contents from your
old PCGen install directory to the new install directory.&lt;/li&gt;
&lt;li&gt;Start the new version of PCGen and verify that your custom data
is present.&lt;/li&gt;
&lt;li&gt;If you install PCGen in the same directory as your previous install,
your LST editor data will still be present in the new version.&lt;/li&gt;
&lt;/ol&gt;

&lt;h3 id=&#34;migrating-data-created-using-the-my-dataset-files&#34;&gt;Migrating Data Created Using the My_Dataset Files&lt;/h3&gt;

&lt;p&gt;PCGen ships with an example set of data files ready to go to create you
own data. This is in the data/homebrew/my_dataset folder. As the
example files ship with PCGen, it is very important to note that these
can be overwritten by a new PCGen install if you have not renamed the
data set and install the new version of PCGen in the same location as
the old one.&lt;/p&gt;

&lt;p&gt;As a result, we strongly recommend that when using the my_dataset
example files, you create a copy in a new folder and work with that
copy, rather than editing the example files directly.&lt;/p&gt;

&lt;p&gt;If you install PCGen into a new directory each time you upgrade, you may
need to copy over the data you have created. If you cannot see your
custom data, simply copy over the folder with your custom data to the
same location in the new PCGen install. The data should then be visible
when you restart PCGen.&lt;/p&gt;

&lt;p&gt;If you are installing PCGen into the same directory, backup your custom
data first, then make sure it does not use the default my_dataset
folder name. Once you are sure your data is safe, then proceed with the
upgrade of PCGen.&lt;/p&gt;

&lt;hr /&gt;
</description>
    </item>
    
  </channel>
</rss>