PSM for Windows Installation · 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

______________________________________________________________________________

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

______________________________________________________________________________




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

______________________________________________________________________________




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.

______________________________________________________________________________




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.

http://dev.mysql.com/doc/refman/5.0/es/gpl-license.html

http://dev.mysql.com/doc/refman/5.0/es/gpl-license.html

______________________________________________________________________________




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.

http://www.php.net/license/3_01.txt

http://www.php.net/license/3_01.txt

______________________________________________________________________________




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

______________________________________________________________________________




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.

______________________________________________________________________________




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

http://partner.sysprint.ch/n_forum

______________________________________________________________________________




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 !!

______________________________________________________________________________




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.

______________________________________________________________________________




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

http://partner.sysprint.ch/n_forum

Documents

PSM for Windows Installation · 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