User Tools

Site Tools


pergamonmu:quickstart:install:initial

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
pergamonmu:quickstart:install:initial [2017/09/30 15:26]
admin
pergamonmu:quickstart:install:initial [2017/11/13 09:36] (current)
admin
Line 6: Line 6:
 Ensure that you have been provided or have downloaded the correct ZIP file version for your operating system. All file names will include both the Operating System (along with whether the file is 32 or 64 bit), and the software version. Ensure that you have been provided or have downloaded the correct ZIP file version for your operating system. All file names will include both the Operating System (along with whether the file is 32 or 64 bit), and the software version.
  
-At this time, Esferico ltd. have released desktop versions of Pergamon MU for Windows (v7.1 SP1 onwards), MacOSX, and Linux. See the bottom of this document ​for minimum specifications.+At this time, Esferico ltd. have released desktop versions of Pergamon MU for Windows (v7.1 SP1 onwards), MacOSX, and Linux. See the [[pergamonmu:​quickstart:​system_requirements|here]] ​for minimum specifications.
  
  
Line 12: Line 12:
  
 This version of the Pergamon Mu application has been provided in a conventional Zip file format and without an installer. As Pergamon does not require special information to be written into the operating system (e.g. This version of the Pergamon Mu application has been provided in a conventional Zip file format and without an installer. As Pergamon does not require special information to be written into the operating system (e.g.
-Registry entries), there is little to no advantage in providing an installer and may actually hinder the install process.+Registry entries), there is little to no advantage in providing an installer and may actually hinder the install process ​(e.g. when creating distributable images etc.)
  
   - Download the installation file (as discussed above) – the link should have been provided either with your order confirmation,​ or directly from Esferico ltd. by email, but may also be available from clearly marked [[http://​www.esferico.net/​index.php/​main-vendors|download archives]] on the Esferico website.\\ \\   - Download the installation file (as discussed above) – the link should have been provided either with your order confirmation,​ or directly from Esferico ltd. by email, but may also be available from clearly marked [[http://​www.esferico.net/​index.php/​main-vendors|download archives]] on the Esferico website.\\ \\
-  - Move the file to where you want to install the software - we recommend doing so in a sub-directory called **Pergamon**. You may wish to place this directory under the ‘Program Files’ directory of Windows (the conventional place for final installed applications),​ or place it in another separate directory. Location is irrelevant to Pergamon – it will run from any location that you choose, including USB flash drives.\\ \\ **Remember however**, that Pergamon needs to have write-permissions to the database. Depending upon how your have your O/S configured, it may be better to place the installation away from Program Files.\\ \\ +  - Move the file to where you want to install the software - we recommend doing so in a sub-directory called **Pergamon**. You may wish to place this directory under the ‘Program Files’ directory of Windows (the conventional place for final installed applications),​ or place it in another separate directory. Location is irrelevant to Pergamon – it will run from any location that you choose, including USB flash drives.\\ \\ **Remember however**, that Pergamon needs to have write-permissions to the database. Depending upon how you have your O/S configured, it may be better to place the installation away from Program Files.\\ \\ **Special Note:** If you intend to use a SQLITE database (a standalone installation),​ remember that the SQLITE database system is **not** designed for network use (e.g. a mapped drive on a server). Network latency etc. may cause unexpected results. While **Esferico ltd.** have successfully run a networked installation using a SQLITE database, this has been under test conditions and is certainly not recommended for **any** live installation. If you require a true networked installation,​ **please look at installing a PostgreSQL server (free of charge) to do so**.\\ \\
   - Extract everything from the ZIP file. Two new directories should be created called **PergamonMU** (containing the application software) and **resource**. Depending upon the version of software downloaded, you may also have a new sterile database called **pergamon.sqlite**.\\ \\   - Extract everything from the ZIP file. Two new directories should be created called **PergamonMU** (containing the application software) and **resource**. Depending upon the version of software downloaded, you may also have a new sterile database called **pergamon.sqlite**.\\ \\
-  - If you have been provided with a separate pre-licensed database (this will happen usually only if you have had a database conversion from previous software), download it now using the provided link and copy the extracted file (with a .sqlite suffix) into the same Pergamon directory.\\ \\ +  - If you have been provided with a separate pre-licensed database (this will happen usually only if you have had a database conversion from previous software), download it now using the provided link and copy the extracted file (with a .sqlite suffix) into the same Pergamon directory, replacing the current **pergamon.sqlite** (if existing).\\ \\ 
   - If copied correctly, this directory will now contain only three entries: **PergamonMu** (a folder), pergamon.sqlite (the database file) and **resource** (a folder).\\ \\    - If copied correctly, this directory will now contain only three entries: **PergamonMu** (a folder), pergamon.sqlite (the database file) and **resource** (a folder).\\ \\ 
-  - To run the software, enter the directory called ‘PergamonMu’. Here, either:\\ \\ a. Double-click the file here called ‘PergamonMu.exe’ – this will start the application this time only, or;\\ \\ b. Right-click on the file and select ‘Create Shortcut’. This will create a shortcut icon in this directory, but which you can then drag-and-dropped ​onto your desktop for ease of repeated access at a later time.\\ \\+  - To run the software, enter the directory called ‘PergamonMu’. Here, either:\\ \\ a. Double-click the file here called ‘PergamonMu.exe’ – this will start the application this time only, or;\\ \\ b. Right-click on the file and select ‘Create Shortcut’. This will create a shortcut icon in this directory, but which you can then drag-and-drop onto your desktop for ease of repeated access at a later time.\\ \\
  
 ===== Creating Your Database ===== ===== Creating Your Database =====
  
 ---- ----
-{{:​pergamonmu:​stop048.png?​nolink |}}\\ If you have been provided with a pre-licensed database, you do not need to +{{:​pergamonmu:​stop048.png?​nolink |}}\\ If you have been provided with a pre-licensed ​database, or you intend to use the shipped empty sterile **pergamon.sqlite** ​database, you do not need to follow the instructions in this section.\\ \\ 
-follow the instructions in this section.\\ \\ +
 ---- ----
  
Line 57: Line 56:
  
 ---- ----
-{{:​pergamonmu:​stop048.png?​nolink |}}If you have been provided with a pre-licensed or otherwise pre-configured database, you will already have two managerial users created for you: **admin / password** and **user / password**. You only need to following these instructions to create **new** users (note: **not** readers)\\ \\ +{{:​pergamonmu:​stop048.png?​nolink |}}If you have been provided with a pre-licensed or otherwise pre-configured database ​(including the empty sterile database), you will already have two managerial users created for you: **admin / password** and **user / password**. You only need to following these instructions to create **new** users (note: **not** readers)\\ \\ 
 ---- ----
  
pergamonmu/quickstart/install/initial.1506785168.txt.gz · Last modified: 2017/09/30 15:26 (external edit)