pergamonmu:quickstart:install:initial
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
pergamonmu:quickstart:install:initial [2017/08/08 09:16] 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. |
| ===== Initial Installation ===== | ===== Initial Installation ===== | ||
| 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 – you may wish to place it 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. A new directory will be created called ‘Pergamon’.\\ \\ | + | - 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 36: | Line 36: | ||
| //***Special note:** Most operating systems give priority to internal processes rather than updating the screen. On occasion, on some workstations, this database creation process appears to ‘hang’ or the message ‘not responding’ is | //***Special note:** Most operating systems give priority to internal processes rather than updating the screen. On occasion, on some workstations, this database creation process appears to ‘hang’ or the message ‘not responding’ is | ||
| displayed. Please ignore this message – this is simply the operating system interpreting the process incorrectly and it will correct itself after only a few seconds.// | displayed. Please ignore this message – this is simply the operating system interpreting the process incorrectly and it will correct itself after only a few seconds.// | ||
| + | |||
| ===== Licensing Your Database ===== | ===== Licensing Your Database ===== | ||
| Line 50: | Line 51: | ||
| - Enter the license code (without the dashes) that you have been provided for your installation.\\ \\ This license determines your client number in the online Pergamon Hub, the type of license that you have (e.g. the primary school ‘Mu’ software rather than for a secondary or college), and the number of terminals permitted in your installation. In the case of primary schools, no limit has been included in your license, however any multi-user installation requires a networked relational database (e.g. PostgreSQL, MySQL, Oracle, MSSQLServer etc.).\\ \\ | - Enter the license code (without the dashes) that you have been provided for your installation.\\ \\ This license determines your client number in the online Pergamon Hub, the type of license that you have (e.g. the primary school ‘Mu’ software rather than for a secondary or college), and the number of terminals permitted in your installation. In the case of primary schools, no limit has been included in your license, however any multi-user installation requires a networked relational database (e.g. PostgreSQL, MySQL, Oracle, MSSQLServer etc.).\\ \\ | ||
| - Select to continue / license. You will be permitted to enter further license codes for special functions, but these are not used in the primary school version of Mu. Click ‘No’ and the license dialog will close. | - Select to continue / license. You will be permitted to enter further license codes for special functions, but these are not used in the primary school version of Mu. Click ‘No’ and the license dialog will close. | ||
| + | |||
| ===== Creating a Working User ===== | ===== Creating a Working User ===== | ||
| ---- | ---- | ||
| - | {{: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)\\ \\ |
| ---- | ---- | ||
| Line 67: | Line 69: | ||
| - Click the golden ‘**Lock**’ toolbar button again to display the managerial menu.\\ \\ | - Click the golden ‘**Lock**’ toolbar button again to display the managerial menu.\\ \\ | ||
| - Click on ‘**Tools**’, then select ‘**Users**’\\ \\ | - Click on ‘**Tools**’, then select ‘**Users**’\\ \\ | ||
| - | - Click the ‘**Create**’ toolbar button to create a new user. | + | - Click the ‘**Create**’ toolbar button to create a new user.\\ \\ |
| - Select this new user in the left-hand list, which will be named ‘U2017-?????????’ to display the new user’s details.\\ \\ | - Select this new user in the left-hand list, which will be named ‘U2017-?????????’ to display the new user’s details.\\ \\ | ||
| - Edit the user details and enter or replace:\\ \\ Login (e.g. your initials)\\ Firstname (the first name of the new user)\\ Surname (the surname of the new user)\\ \\ | - Edit the user details and enter or replace:\\ \\ Login (e.g. your initials)\\ Firstname (the first name of the new user)\\ Surname (the surname of the new user)\\ \\ | ||
| Line 75: | Line 77: | ||
| - With the **same user selected in the list**, click on the ‘**Reset**’ toolbar button. Enter a password twice in the text boxes provided to create a new password for the user.\\ \\ | - With the **same user selected in the list**, click on the ‘**Reset**’ toolbar button. Enter a password twice in the text boxes provided to create a new password for the user.\\ \\ | ||
| - Finally, click on ‘**Manager Logout**’ – you can do this either within the gold manager menu on the original OPAC screen, or here in the User Manager – both will remove all manager windows from the screen and log you out. | - Finally, click on ‘**Manager Logout**’ – you can do this either within the gold manager menu on the original OPAC screen, or here in the User Manager – both will remove all manager windows from the screen and log you out. | ||
| + | |||
| ===== Creating a Reader Assistant ===== | ===== Creating a Reader Assistant ===== | ||
| Line 100: | Line 103: | ||
| - Logging in as the reader of this pairing **will not** automatically login the managerial user. | - Logging in as the reader of this pairing **will not** automatically login the managerial user. | ||
| - In normal operation, you would have many readers in the database who had been created during the normal library operation. At times, you may consider that one or more of them are trusted to perform basic library operations. To do so, you would create a new User (i.e. not reader, as that already exists) and turn on only the most basic permissions that you want them to perform, then attach their reader number to it. This is therefore the reverse order than what was demonstrated above. See the manual for more information. | - In normal operation, you would have many readers in the database who had been created during the normal library operation. At times, you may consider that one or more of them are trusted to perform basic library operations. To do so, you would create a new User (i.e. not reader, as that already exists) and turn on only the most basic permissions that you want them to perform, then attach their reader number to it. This is therefore the reverse order than what was demonstrated above. See the manual for more information. | ||
| + | |||
| + | ---- | ||
| + | {{:logo.png?nolink |}}\\ | ||
| + | [[pergamonmu:quickstart:install|Installation of Pergamon MU]]\\ | ||
| + | [[:start|Pergamon Wiki Home]] | ||
pergamonmu/quickstart/install/initial.1502183800.txt.gz · Last modified: 2017/08/08 09:16 by admin
Page Tools
