Choose your language

Choose your login

Support

How to configure embedded software after a server migration or an IP/Hostname change

THE PAGE APPLIES TO:

ā€œHelp! Weā€™re in the process of migrating our PaperCut server to a new server, or changing itā€™s IP address. What do we need to configure on our PaperCut-embedded copiers so that they keep communicating to the server?ā€ā€™

This article pertains exclusively to PaperCut MF, the edition of PaperCut that implements copier control.

Maybe your organization has decided to change the IP address or hostname of your PaperCut server (possibly as part of a PaperCut Server Migration). If the IP address or hostname of your PaperCut server changes, then how do copiers running the PaperCut embedded application know how to contact the PaperCut server? You may need to make the changes for each brand of device as described below.

Before undertaking these changes we recommend you contact your PaperCut Partner for consultation and technical assistance (their details can be found on the About page in the admin interface of your PaperCut server).

Brother, via BSI

  1. Using a web browser, go to the URL of the Brother deviceā€™s web admin page. E.g. http://<device-ip></device-ip> and login to the Brother device as ā€œadminā€

  2. Click on ā€œAdministration Settingsā€ or ā€œAdministratorā€ at the top of the page

  3. Under Solutions Application Entry, ensure the Login and Logout URL both read: http://papercut.server.IP.address:9191/device/brother?name=device_name

  4. Submit changes and restart device

For example, if your PaperCutā€˜s server IP address was ā€œ192.168.1.57ā€,and you gave the MFD the name ā€œBrotherMFDā€ the URL would read: http://192.168.1.57:9191/device/brother?name=BrotherMFD

NOTE: The [device name] in the URL above will be the Device name that is used in the PaperCut administration interface on your server

Canon (MEAP)

  1. Using a web browser go to the URL of the Canon deviceā€™s web admin page. E.g. http://<device-ip></device-ip>

  2. Enter the System Manager ID and System PIN to enter admin mode

  3. Click the ā€˜Configure PaperCutā€™ option

  4. Enter the PaperCut serverā€™s new hostname or IP address under ā€œServer Hostnameā€

  5. Submit changes and restart device

Dell (eSF)

  1. Using a web browser go to the URL of the Dell deviceā€™s web admin page. E.g. http://<device-ip></device-ip>

  2. Look for an option called ā€œEmbedded Solutionsā€ or ā€œDevice Solutionsā€

  3. Click the ā€œPaperCutā€ entry

  4. Click on the ā€œConfigureā€ button that appears

  5. Enter the PaperCut serverā€™s new hostname or IP address under ā€œServer Hostnameā€

  6. Submit changes and restart device

HP OXP

  1. The initial setup of HP OXP devices may involve manually defining the Application Serverā€™s IP address / hostname via the system.network-address global configuration key. Check this config key via the Advanced Config Editor, and if the value is not blank, change it to reflect the new IP address or FQDN of the Application Server before then changing the server address on the HP device. For more information please see Section 5.1.1 Inbound connections to PaperCut MF Application Server of the PaperCut MF HP OXP Embedded Manual.

  2. If the system.network-address config key is blank, then HP OXP devices server address will automatically be adjusted when the PaperCut MF server next reconfigures the device, which will happen periodically automatically. One way to force this update is to restart the PaperCut Application Server service.

  3. If an HP OXP device has been configured to utilise HTTPS / SSL when communicating with the Application Server, the SSL certificate may need to be regenerated to accommodate the change in server network address. For more information please see Section 5.2.1 HTTPS Security (recommended) of the PaperCut MF HP OXP Embedded Manual.

HP FutureSmart

  1. Using a web browser go to the URL of the HP deviceā€™s web admin page. E.g. http://<device-ip></device-ip>

  2. Click Sign In in the top-right corner of the page and log in using the device Administrator credentials

  3. Select the PaperCut Server Configuration menu on the General tab in the deviceā€™s web admin page

  4. Enter the PaperCut serverā€™s new hostname or IP address under ā€œServer Hostnameā€

  5. Submit changes and restart device

HP, via Chai SOE DSE

  1. Using a web browser, go to the PaperCut embedded configuration page, E.g. http://<device-ip>/hp/device/papercut.home</device-ip>

  2. Edit the Server IP / Hostname field

  3. Click Apply Changes and restart device

HP OSA / S900 Series

  1. Browse to the URL of the HP deviceā€™s web admin page. E.g. http://<device-ip></device-ip>

  2. Navigate to ā€˜Application Settings ā†’ External Applications Settings ā†’ External Accounting Application Settingsā€™

  3. Edit the Address for Application UI with the new IP/hostname

  4. Edit the Address for Web Service field with the new IP/hostname

  5. Press ā€œSubmitā€

  6. Press ā€œReboot Nowā€

Konica Minolta, via OpenAPI

The server address on Konica Devices will automatically be adjusted when the PaperCut MF server next reconfigures the device, which will happen periodically automatically.

One way to force an update is to restart the PaperCut Application Server service.

NOTE: If you have manually set the serverā€™s IP address / hostname by using the Advanced Config key: ā€œsystem.network-addressā€ then you would need to change this first, before PaperCut can reconfigure the Device. For more information please see the Konica Minolta embedded manual.

Kyocera, via Kyocera Hybrid Platform for Advanced Solutions (HyPAS)

  1. At the MFD press the Admin Login button and enter the Administrator credentials

  2. Once logged in edit the PaperCut server IP address

  3. Click on ā€œApplyā€ and reboot the MFD to make the changes take effect

Lexmark, via Lexmark Embedded Solutions Framework (LeSF)

  1. Browse to the URL of the Lexmark deviceā€™s web admin page. E.g. http://<device-ip></device-ip>

  2. Look for an option called ā€œEmbedded Solutionsā€ or ā€œDevice Solutionsā€

  3. Click the ā€œPaperCutā€ entry

  4. Click on the ā€œConfigureā€ button that appears

  5. Enter the PaperCut serverā€™s new hostname or IP address under ā€œServer Hostnameā€

  6. Submit changes and restart device

Ricoh, via Ricoh Embedded Software Architecture (ESA)

For SDK/J application v21505 or later:

  1. Access the Admin Screen press the small ā€œAdminā€ text in the lower right corner of the login screens

  2. Enter the MFDā€™s Administrator username and password to access the settings

  3. Update the IP address

  4. Press Save to change the settings and restart the application

NOTE: If you are also changing the name of the device please take care to also ā€˜renameā€™ the device in the PaperCut administration interface.

For SDK/J application versions prior to v21505:

Reinstall the embedded application using the new folder created when PaperCut was installed. Then follow the instructions in the Ricoh embedded manual

NOTE: If you keep the same device name the new device will have the job history of the old device.

For SmartSDK:

To make any changes to Ricoh SmartSDK device, you are required to log in as administrator first as shown in the steps below, then youā€™ll have the ability to change the PaperCut connection settings.

  1. On the device, select ā€œUser Toolsā€ from the home screen

  2. Select ā€œMachine Featuresā€, ā€œLoginā€ and then enter the machine administrator login credentials. Press ā€œExitā€ then select ā€œhomeā€ to go back into PaperCut application.

  3. Go back to the PaperCut application and press the ā€œAdminā€ text in the lower-right corner of the connecting or login screens

  4. Update the fully qualified hostname

  5. Press Save changes to change the settings and reconnect. Remember to log out once the application is reconnected

NOTE: The hostname must be fully qualified, without the complete domain name the application will not be able to connect to the Server.

OKI, via Open Platform

OKI Open Platform devices require two steps to reconfigure for a new IP.

A) Configure OKI Embedded Web Browser (EWB):

  1. Browse to the URL of the OKI deviceā€™s web admin page (TopAccess). E.g. http://<device-ip></device-ip>

  2. Log in as the ā€œAdminā€ user

  3. Select the ā€œAdministrationā€ tab

  4. Navigate to the ā€œAdministrationā€ ā†’ ā€œEWBā€ page.

  5. Under the ā€œHome Page Settingā€ set the ā€œHome Pageā€ by changing ā€œserver-addressā€ for the new address of the PaperCut server. E.g. http://server.ip:9191/device/oki/ Alternatively to use an encrypted HTTPS connection (advisable when using card association) enter https://server.ip:9192/device/oki/

  6. Press the ā€œSaveā€ button and restart the device

B) Configure MFP LDAP server

An OKI connects to the PaperCut using LDAP to authenticate users and validate card authentication. The MFP must be configured to establish an LDAP connection to the PaperCut server. To do this:

  1. Log in to the deviceā€™s web administration (TopAccess) with a web browser E.g. http://<device-ip></device-ip>

  2. Select the ā€œAdministrationā€ tab and login as an admin user

  3. Select the ā€œMaintenanceā€ subsection, and the ā€œDirectory Serviceā€ option

  4. Select the Directory service currently setup for PaperCut

  5. Edit the Server IP address with the new servers details

  6. Press ok to save

Samsung, via Samsung eXtensible Open Architecture (XOA)

  1. Using a web browser login to the Samsung web interface, Samsung SyncThru, as administrator

  2. On the top menu bar hover over ā€œXOAā€and select the sub item called ā€œPaperCutā€

  3. Edit the hostname or IP address of the PaperCut server

  4. Apply changes and reboot MFD

Sharp, via Sharp Open Systems Architecture (OSA)

  1. Browse to the URL of the Sharp deviceā€™s web admin page. E.g. http://<device-ip></device-ip>

  2. Navigate to ā€˜Application Settings ā†’ External Applications Settings ā†’ External Accounting Application Settingsā€™

  3. Edit the Address for Application UI with the new IP/hostname

  4. Edit the Address for Web Service field with the new IP/hostname

  5. Press ā€œSubmitā€

  6. Press ā€œReboot Nowā€

NOTE: If youā€™re using Integrated Scanning, youā€™ll also need to update the ā€œPaperCut Scanningā€, ā€œPaperCut Homeā€ and ā€œPrint Releaseā€ which is also under ā€˜Application Settings ā†’ External Applications Settings ā†’ External Accounting Application Settingsā€™. See the Sharp embedded manual, section 3.5 for more information.

NOTE: If you have manually set the serverā€™s IP address / hostname by using the Advanced Config key: ā€œsystem.network-addressā€ then you would need to change this first, before PaperCut can reconfigure the Device. For more information, check the Sharp embedded manual.

Toshiba, via e-BRIDGE Open Platform

Toshiba devices require two steps to reconfigure for a new server IP.

A) Configure Embedded Web Browser (EWB):

  1. Browse to the URL of the Toshiba deviceā€™s web admin page (TopAccess). E.g. http://<device-ip></device-ip>

  2. Log in as the ā€œAdminā€ user

  3. Select the ā€œAdministrationā€ tab

  4. Navigate to the ā€œAdministrationā€ ā†’ ā€œEWBā€ page

  5. Under the ā€œHome Page Settingā€ set the ā€œHome Pageā€ by changing ā€œserver-addressā€ for the new address of the PaperCut server E.g. http://server.ip:9191/device/toshiba/ Alternatively to use an encrypted HTTPS connection (advisable when using card association)enter https://server.ip:9192/device/toshiba/

  6. Press the ā€œSaveā€ button

B) Configure MFP LDAP server

A Toshiba connects to the PaperCut using LDAP to authenticate users and validate card authentication. The MFP must be configured to establish an LDAP connection to the PaperCut server. To do this:

  1. Log in to the deviceā€™s web administration (TopAccess) with a web browser E.g. http://<device-ip></device-ip>

  2. Select the ā€œAdministrationā€ tab and login as an admin user

  3. Select the ā€œMaintenanceā€ subsection, and the ā€œDirectory Serviceā€ option

  4. Select the Directory service currently setup for PaperCut.

  5. Edit the Server IP address with the serverā€™s new details.

  6. Press ok to save, and reboot the device

NOTE: For older SDKv1 devices you also need to change the SNMP trap location.

Xerox, via Xerox Secure Access and Xerox Network Accounting

The server address on Xerox devices will automatically be adjusted when the PaperCut MF server next reconfigures the device, which will happen periodically automatically.

One way to force an update is to restart the PaperCut Application service.

NOTE: If you have manually set the serverā€™s IP address / hostname by using the Advanced Config key: ā€œsystem.network-addressā€ then you would need to change this first, before PaperCut can reconfigure the Device. For more information please see the embedded manual.

Still have questions?

Let us know! We love chatting about whatā€™s going on under the hood. Feel free to leave a comment below or visit our Support Portal for further assistance.


Categories: How-to Articles , Installing, Uninstalling and Migrating , Devices


Keywords: migrate , migration , upgrade , move , moving to a new server , changing servers , transfer

Comments

Last updated June 13, 2024