psm for windows installation · microsoft windows server 2008 r2 (64 bit), windows 2012 server (64...
TRANSCRIPT
______________________________________________________________________________
Gaswerkstrasse 6 Tel. 044 730 23 45
CH-8952 Schlieren Fax 044 730 18 35
Web: www.sysprint.ch Mail: [email protected]
PSM for Windows Installation
Version: 7.02
______________________________________________________________________________
Gaswerkstrasse 6 Tel. 044 730 23 45
CH-8952 Schlieren Fax 044 730 18 35
Web: www.sysprint.ch Mail: [email protected]
Contents
1. History ............................................................................................................................... 4
2. Migration ........................................................................................................................... 4
3. Requirements for PSM on Windows ................................................................................... 4
4. The installation packages ................................................................................................... 4
5. MySQL Installation ............................................................................................................. 5
6. PHP Installation ................................................................................................................. 6
7. PSM Installation ................................................................................................................. 7
8. Installation check ............................................................................................................... 8
9. Migration from Linux based PSM ........................................................................................ 9
10. Uninstall ............................................................................................................................ 9
11. Troubleshooting ............................................................................................................... 10
12. Differences between Linux and Windows based PSM ........................................................ 12
______________________________________________________________________________
Gaswerkstrasse 6 Tel. 044 730 23 45
CH-8952 Schlieren Fax 044 730 18 35
Web: www.sysprint.ch Mail: [email protected]
1. History
In 2006, the first release of PSM was made available. It was a SUSE based hardware appliance, capable of
consumable ordering. Over the years, there have been many improvements, such as second toner alert,
error message capturing, counter reporting, stock administration and more. However, the basic OS used
was still Linux, whereby we changed from SUSE to UBUNTU, because UBUNTU allowed much more flexibil-
ity in terms of the hardware and VMWare images. VMWare images have been the only software possibility,
if somebody did not want to install hardware, and they have become the most used variant as of today.
So - why Windows? Because there are many companies with rules not allowing them to install anything
else than Windows on their VMWare infrastructure.
2. Migration
If you have PSM for Windows installed already, please follow the migration guide.
3. Requirements for PSM on Windows
To install PSM, you need to have the following:
➢ Microsoft Windows Server 2008 R2 (64 Bit), Windows 2012 Server (64 Bit) or Windows Server 2016 (64 Bit)
o 2008 R2: DotNet 3.5.1 (will automatically be installed if not already present) ➢ Min. 50 GB hard drive (including the system OS) ➢ The 3 PSM installation packages ➢ Console or Remote Access (RDP) to the Server ➢ An Account with local administrator rights on this Server (for the installation) ➢ Aprox 15 Minutes Time ➢ If IIS is already installed, you need to know the base folder (default is C:\inetpub\ )
o (If IIS is not installed, Setup will automatically install and configure it)
4. The installation packages
The installation zip file contains 3 folders with the 3 installation packages.
______________________________________________________________________________
Gaswerkstrasse 6 Tel. 044 730 23 45
CH-8952 Schlieren Fax 044 730 18 35
Web: www.sysprint.ch Mail: [email protected]
5. MySQL Installation
Note: By installing MySQL, you agree to the GNU General Public License at http://dev.mysql.com/doc/ref-
man/5.0/es/gpl-license.html
Assuming that you are logged in with full administration rights on the server, right-click the "mysql for
psm.exe" and select "Run as administrator".
Choose the Folder where IIS installed. If you did not install IIS yet, leave the default value of "C:\Inetpub\"
The MySQL programs will be installed. There will be a self-closing
popup just before setup finishes. This is, when the installer sets up the
correct values for the database, and installs the MySQL Service.
The MySQL Service will automatically be started.
______________________________________________________________________________
Gaswerkstrasse 6 Tel. 044 730 23 45
CH-8952 Schlieren Fax 044 730 18 35
Web: www.sysprint.ch Mail: [email protected]
6. PHP Installation
Note: By installing PHP, you agree to the PHP Licensing terms described at http://www.php.net/li-
cense/3_01.txt
PHP programs are written in the PHP programming language. Because of that, we need to have PHP in-
stalled as well.
Open the "2 - PHP for PSM" Folder.
Right-Click the “php 5.6.7 for PSM.exe” setup program and select “Run as
Administrator”.
You will need to accept the PHP license agreement, and click next on all setup steps. The PHP installer will
also setup the Microsoft IIS sever automatically.
Please note that there are also 2 prerequisite packages from Microsoft contained in the installer.
"Visual C++ Redistributable for Visual Studio 2012"
"Visual C++ Redistributable for Visual Studio 2013"
If these 2 packages are not already installed on the server, you will be asked to install them during the PHP
setup.
Hint: Sometimes the Microsoft Visual C++ installation GUI is displayed behind the PHP installer, so you
don’t see it. Check the task bar or move the PHP installer GUI to see the Microsoft installer GUI.
______________________________________________________________________________
Gaswerkstrasse 6 Tel. 044 730 23 45
CH-8952 Schlieren Fax 044 730 18 35
Web: www.sysprint.ch Mail: [email protected]
7. PSM Installation
Open the "3 - PSM Setup" Folder.
Right-Click the “PSM 6.32.exe” setup program and select “Run As
Administrator”.
Click "next" on all pages, and accept the license agreement. Click "finish" and login using the default
psm credentials.
This ends the PSM installation. You should be able to login from any pc by entering the url
http://yourservername/psm
______________________________________________________________________________
Gaswerkstrasse 6 Tel. 044 730 23 45
CH-8952 Schlieren Fax 044 730 18 35
Web: www.sysprint.ch Mail: [email protected]
8. Installation check
In order to make sure, that PSM is working correctly, you should first verify, if you can login to psm (Default
userid: admin - default password: psm ).
Then you should check if both required services are running. Open Services.msc on the server and check
the following 2 services:
MySQL Database Service:
PSM Scheduler Service:
If all of the above is correct, this ends the installation. You can continue setting up PSM, using the PSM
Quick Guide or PSM Advanced knowledge Guide.
______________________________________________________________________________
Gaswerkstrasse 6 Tel. 044 730 23 45
CH-8952 Schlieren Fax 044 730 18 35
Web: www.sysprint.ch Mail: [email protected]
9. Migration from Linux based PSM
It is possible to migrate an existing Linux based PSM Installation to PSM for Windows.
It is important to follow the steps described below, or else the migration could fail, resulting in the win-
dows installation to become unusable.
Migration Steps:
• Make sure, that the existing PSM runs on Version 5.xx (upgrade to version 6 is possible only, if you
already have version 5. If you have an earlier version, download and install the latest 5.40 version
from http://partner.sysprint.ch/n_forum)
• Upgrade your Linux-based PSM to Version 7.02.
o Note: By the time when this manual was written, version 7.02 was the highest version.
However, if your Linux-based PSM already has a higher version, you can use this version,
but then you should upgrade the Windows PSM to the same version first.
• Create a backup from the updated linux based PSM.
• Restore the Backup on your Windows-PSM
• Restart the “PSM Scheduler” Service on your windows server
10. Uninstall
If you uninstall PSM, make sure you made a backup over the PSM Web-GUI before (if there is any data).
You can uninstall PSM over "add / remove programs".
Make sure, that you uninstall in the following sequence:
- PSM
- PHP
- MySQL
______________________________________________________________________________
Gaswerkstrasse 6 Tel. 044 730 23 45
CH-8952 Schlieren Fax 044 730 18 35
Web: www.sysprint.ch Mail: [email protected]
11. Troubleshooting
PHP / MySQL
If any other PHP and / or MySQL packages were already installed before, you will need to remove them be-
fore installing the ones here. The PHP and MySQL packages included with PSM are customized. You will
have to use them, otherwise PSM will not work.
Setup the correct Handler Mapping settings and order
IIS sometimes behaves strange when it comes to use the correct handler mapping order. If you only see a
403 or 404 error when you connect to PSM, this might be the result or an incorrect handler mapping. To
get this correct, it is important, that you are following the steps below.
Click on the virtual site "PSMS" in the IIS Management console. , double click on the "Handler Mappings"
Icon in the middle window.
Choose "View Ordered List" on the right side window.
Use the "Move Up" / "Move Down" Icons and make sure that "PHP_via_FastCGI" is the first entry in the list,
and that "StaticFile" is the last entry in the List.
Very Important: Move at least one Entry up or down, even if the list is already correct !!
______________________________________________________________________________
Gaswerkstrasse 6 Tel. 044 730 23 45
CH-8952 Schlieren Fax 044 730 18 35
Web: www.sysprint.ch Mail: [email protected]
By moving at least one entry, we cause that the order will no
longer be inherited from the parent. This is exactly what we
want !
Folder Permissions
The 3 installers will setup directory permissions to allow write access to the local group "users" for
C:\inetpub\php\temp (session files, upload files) and to C:\inetpub\wwwroot\psm in order to allow correct
operation. You should not change those permissions unless you got a reason for it. If you change it, you will
also need to change the user used by IIS for the virtual directory PSM.
Note: The above only applies, if you change the default permissions and folder access.
______________________________________________________________________________
Gaswerkstrasse 6 Tel. 044 730 23 45
CH-8952 Schlieren Fax 044 730 18 35
Web: www.sysprint.ch Mail: [email protected]
12. Differences between Linux and Windows based PSM
DNS based Tasks
We found that DNS based Tasks (such as Host Name Resolution which PSM does when querying existing or
new printers) are slower on Windows compared to Linux. There is unfortunately nothing we can do about
this, this is the Way PHP works under Windows. This will not affect PSM's everyday operation, however it
may be noticeable when you scan for new devices.
Automatic Backup / Restore
Currently only local backups are possible. If you enable automatic backup, PSM will write the backup files to
the "downloads" subfolder (usually C:\inetpub\wwwroot\psm\downloads). PSM will keep the backup files
for the last 7 days, and delete older ones. If you need to store it somewhere else, we recommend to share
the "downloads" folder, in order to allow a backup system to retrieve the backup. Local backups can be re-
stored directly from within the PSM Backup/Restore GUI.
File Format
On Linux, backup and update files were named .tar. On PSM for Windows, they are named .zip.
Future Updates
In the future, we will provide 2 packages, a .tar update package for the Linux versions, and a .zip update
package for the Windows version.
Migration Limitations
You can migrate a Linux based PSM to a Windows PSM. However you CANNOT migrate a Windows based
PSM back to a Linux based PSM.
PSM Scheduler
Under Windows, we install a service called "PSM Scheduler". This Service runs under the local system ac-
count. In Version 6 of PSM we have changed all background and privileged functions to run under the
scheduler, in order to avoid the need to run IIS under a privileged account. The Scheduler will check at least
every minute, if there are any new task to perform (Such as background scan for new printers, email order
sending, printer query updates, reboot). You will see the status of any system or user initiated task in the
PSM Scheduler. The same behavior is used on the Linux based PSM variants.
More information : http://partner.sysprint.ch/n_forum