Setting up advanced hybrid storage for Windows and Ubuntu systems
  1. guides
  2. en
  3. Administrator's Guide
  4. Print Management
  5. Using Advanced Hybrid storage
  6. Setting up advanced hybrid storage for Windows and Ubuntu systems

Setting up advanced hybrid storage for Windows and Ubuntu systems

Learn how to set up advanced hybrid storage for Windows and Ubuntu systems.
Supported operating systems
  • Windows Server 2022 Datacenter (AMD64)
  • Ubuntu 22.04 (AMD64)
  • Ubuntu 24.04 (AMD64)
Installing the advanced hybrid package
Before you begin, you must enable the additional hybrid storage option from the Organizational Settings page. For more information, see Configuring organizational settings.
  1. Depending on your requirement, get the Windows installation package or the Ubuntu installation package.
    For more information on accessing the installation packages, contact your Lexmark representative.
  2. Unzip the installation package.
  3. Open the Windows PowerShell as an administrator.
  4. Run the installer script file with the following command line options:
    • For Windows and Ubuntu operating system
      :
      $clientSecret = ConvertTo-SecureString "client_secret_value" -AsPlainText -Force$proxyPassword = ConvertTo-SecureString "proxy_password_value" -AsPlainText -Force
    • For Windows operating system
      —
      install.ps1
      Basic installation:
      & .\install.ps1 -DATA_CENTER "<data-center>" -CLIENT_ID "<client-id>" -CLIENT_SECRET $clientSecret
      Advanced installation:
      & .\install.ps1 -DATA_CENTER "<data-center>" -CLIENT_ID "<client-id>" -CLIENT_SECRET $clientSecret -JOB_PATH "<job-path>" -INSTALLATION_DIR "<install-path>" -SERVER_PORT "<server-port>" -ENABLE_HOSTNAME "<enable-hostname>" -DEVICE_NAME "<device-name>" -HTTPS_PROXY "http://<proxy_host>:<proxy_port>" -PROXY_USER "<username>" -PROXY_PASSWORD $proxyPassword -LOG_REDACT_PRIVATE_INFORMATION "<log-redact-private-information>" -LOG_IP_ADDRESSES "<log-ip-addresses>"
    • For Ubuntu operating system
      —
      installer.sh
      Basic installation:
      bash installer.sh DATA_CENTER=<data-center> CLIENT_ID=<client_id> CLIENT_SECRET=<client_secret>
      Advanced installation:
      bash installer.sh DATA_CENTER=<data-center> CLIENT_ID=<client_id> CLIENT_SECRET=<client_secret> JOB_PATH=</path/to/store/jobs> INSTALLATION_DIR=</path/to/installation/ directory> PROXY_USER=<proxy_username> PROXY_PASSWORD=<proxy_password> LOG_REDACT_PRIVATE_INFORMATION=<log-redact-private-information> LOG_IP_ADDRESSES=<log-ip-addresses>

Uninstalling advanced hybrid storage

For Windows operating system
  1. Open Windows PowerShell in administrator mode.
  2. Navigate to installation directory.
  3. Make sure that the
    uninstall.ps1
     file is present in the directory.
  4. Execute the
    uninstall.ps1
     file.
For Ubuntu operating system
  1. Open terminal.
  2. Navigate to Installation Directory
  3. Make sure that the
    uninstaller.sh
     file is present in the directory.
  4. Execute the
    uninstaller.sh
     file with elevated access.

Upgrading advanced hybrid storage

For Windows operating system
  1. Download the desired package.
  2. Open the Windows PowerShell as an administrator.
  3. Execute the
    install.ps1
     file without any arguments.
For Ubuntu operating system
  1. Download the desired package.
  2. Open terminal.
  3. Execute the
    installer.sh
     file without any arguments.

Understanding the installation parameter information

Common variables
Name
Value
Description
DATA_CENTER
For Optra, instead of DATA_CENTER, set SPRING_PROFILES_ACTIVE.
Select one of the following that matches your data-center location:
  • us
  • eu
This variable is used by the application to connect to the data center where the Lexmark Cloud Services organization is located.
CLIENT_ID
For Optra, instead of CLIENT_ID, set EDGE_CLIENT_ID.
  1. From the Account Management portal, click
    Applications
     tab.
  2. In the search bar, search for
    CPM Advanced Hybrid Storage
    .
  3. Click the application name.
  4. On the CPM Advanced Hybrid Storage page, in the OAuth Settings section, identify
    <client_ID>
     and
    <client_secret>
    .
The value is used to register and authenticate with the Cloud Print Management.
CLIENT_SECRET
For Optra, instead of CLIENT_SECRET , set EDGE_CLIENT_SECRET.
Same as CLIENT_ID.
Same as CLIENT_ID.
Optional variables
Name
Value
Description
SERVER_PORT
Any port
The application listens on this port. The default port is 9443.
DEVICE_ID
Custom device name of Windows or Ubuntu servers
Unique Identifier to identity a particular advanced storage device. The default value is server's hostname.
CLEAN_UP_SCHEDULE
Cron expression
This value determines how often the application checks to determine if a job should be removed from this storage device. The default value is 30 minutes.
ENABLE_HOSTNAME
True or False
The value determines whether the printer connects to this device using the host name or the IP address. The preferred and default value is False because due to network configurations, the host name may not be discoverable by the printer.
STATUS_SCHEDULE
Cron expression
The value is how often the application updates its information (IP, disk space, etc.) to Cloud Print Management. The default value is one minute.
LOG_REDACT
_PRIVATE_INFORMATION
True or False
This value determines if we should remove private information from the logs. The default value is True.
LOG_IP_ADDRESSES
True or False
The value determines whether to log the IP addresses. The default value is False.
LOGGING_LEVEL
_COM_LEXMARK
DEBUG/ INFO/ ERROR/ WARN
The default value is INFO.
To change the logging level:
For Windows operating system:
  1. From the installation directory, edit the value of the environment variable in
    lexmark-print-management-advanced-hybrid-service.xml.
    .
  2. Restart the service
For Ubuntu operating system:
  1. Run
    lexmark-print-management-advanced-hybrid-service
    .
  2. Run
    lexmark-print-management-advanced-hybrid-service
    .
Additional optional variables for Windows and Ubuntu
Name
Value
Description
JOB_PATH
For Optra, JOB_PATH needs to be defined only if using external hard drive. For example, JOB_PATH = /media/sda1/jobs.
Fully qualified path to the directory where hybrid jobs are to be stored.
The following are the default values:
  • For Windows, the path is C:\ProgramData
    \Lexmark\Hybrid\Jobs.
  • For Ubuntu, the path is /var/Lexmark/Hybrid/Jobs.
INSTALLATION_DIR
Fully qualified path to the wanted installation directory.
The following are the default values:
  • For Windows, the path is C:\Program Files\Lexmark\Hybrid Storage Edge Service.
  • For Ubuntu, the path is /opt/Lexmark/HybridStorageEdgeService.
DEVICE_NAME
A name to uniquely identify each device where the service is running.
A unique identifier from Cloud Print Management to identity a particular device.
HTTPS_PROXY
http:// <proxy_host>:<proxy_port>
  • If the server is behind proxy, we will detect the system proxy. You can override the system proxy by setting the HTTPS_PROXY variable during installation.
  • You can also add or modify the proxy setting after installation.
  • In Windows: Update the HTTPS_PROXY variable in the lexmark-print-management-advanced-hybrid-service.xml file located in the installation folder.
  • For Ubuntu, perform the following steps:
    1. Update the variable in the service manager.
    2. Run
      sudo systemctl edit lexmark-print-management-advanced-hybrid-service
      .
    3. Add the following lines:
      [Service] Environment
      ="https_proxy=http://
      <proxy_address>
      :<proxy_port>".
    4. Save and exit the editor.
    5. Run
      sudo systemctl daemon-reload
      .
    6. Run
      sudo systemctl restartlexmark-print-management-advanced-hybrid-service
      .
PROXY_USER
If a proxy needs authentication, then it is encrypted and stored in a local file system.
PROXY_PASSWORD
DNS_TIMEOUT
This is only required for Optra.
The default value is 3000 ms.
if you observe intermittent failure to sync jobs, then set this variable.

Disabling storage clients

  1. From the Cloud Print Management portal, click
    Print Clients
    >
    Client Status
    .
  2. Click the
    Advanced Hybrid Storage Client
     tab.
  3. Select one or more devices.
  4. Click
    Disable
    >
    Disable Storage Client
     or
    Disable Storage Clients
    .

Deleting storage clients

  1. From the Cloud Print Management portal, click
    Print Clients
    >
    Client Status
    .
  2. Click the
    Advanced Hybrid Storage Client
     tab.
  3. Select one or more devices.
  4. Click
    Delete
    >
    Delete Storage Client
     or
    Delete Storage Clients
    .
It may take some time for the deletion to take effect.

This site uses cookies for various purposes including enhancing your experience, analytics, and ads. By continuing to browse this site or by clicking "Accept and close", you agree to our use of cookies. For more information, read our Cookies page.