Getting Started with Quark Publishing Platform 2015 - December 2019 Update (v15.0)

Installing Quark Publishing Platform software

Quark Publishing Platform includes multiple installers for server and client components. These installers must be run in the sequence below. If you do not follow the sequence below, you will need to copy files manually after completing all the Quark Publishing Platform software installations.

  1. Quark Publishing Platform Database

  2. QuarkXPress Server

  3. Quark Publishing Platform Server

  4. QuarkCopyDesk

  5. QuarkXPress

  6. Quark Publishing Platform Client (this installer also installs Quark Publishing Platform XTensions software for QuarkCopyDesk and QuarkXPress)

  7. Quark XML Author for Quark Publishing Platform

  8. Quark Publishing Platform Adapters for Microsoft Office

Installing Quark Publishing Platform Database

You have three options for installing your Quark Publishing Platform Database: MS SQL Server, Azure SQL, and Oracle. For Azure SQL, please contact your Quark Enterprise representative. For the others, please follow the instructions below.

If you experience any problems while installing your Quark Publishing Platform Database, consult the log files (QPSDb.log) created during the installation. These can be found here: AppData/Local/Temp

Installing Quark Publishing Platform Database on Windows — MS SQL Server

You must install and configure Microsoft SQL Server on Windows before you can install the Quark Publishing Platform Database for MS SQL Server. The following two configuration settings are required for MS SQL Server:

  • The service SQL Server Browser must be enabled during the installation or upgrade.

  • Use the MS SQL Server Configuration Manager to enable TCP/IP network protocols.

You install the Quark Publishing Platform Database with the Quark Publishing Platform Database installer ("Setup.exe" in the Installer/Database folder) or the Quark Publishing Platform Server Installer ("Quark Publishing Platform Server.exe").

To install the Quark Publishing Platform Database for MS SQL Server:

  1. Double-click the "Setup.exe" file in the Installer/Database folder.

    The Quark Publishing Platform Database — Setup dialog box displays.

  2. Click Next.

    The License Agreement screen displays.

  3. Select I accept the terms in the license agreement and click Next.

    The Database Information screen displays.

  4. Choose SQL Server from the Select Database Type drop-down menu. Under Choose Database Preference, select either Create new Database or Use already existing Database, and click Next.

    A screen for entering your MS SQL Server information displays.

  5. Enter [host name]\[instance name],[Port Number] in theHost/Instance Name,Port Number field.

    The port value appears in SQL Server Configuration Manager which is installed with SQL Server.

  6. Enter the name of the Quark Publishing Platform Database you want to create or use in the Database Name field.

    The installer creates a database with this name.

  7. Enter the user name or login name for the database in the User Name field.

  8. Enter a password for the login name/user name in the User Password field.

    The installer creates a login with the name and password and gives that login the db_owner role.

  9. Click Browse in the Database Destination Folder area to specify the path for storing database data files.

  10. Click Next.

    The Ready to Install the Application screen displays.

  11. Click Install.

  12. When the installation concludes, click Finish.

If you chose the Use already existing Database option, then a blank database and the user/login name must already exist with the following characteristics:

  • The database cannot contain any table with a name beginning with QPP.

  • The database must have three file groups and each file group must be associated with one file on the file system:

    1. Index_QPP

    2. Blob_QPP

    3. Data_QPP

  • The database must have the given values for the following parameters:

    1. Auto Update Statistics Asynchronously = True

    2. Is Read Committed Snapshot On = True

    3. Parameterization = Forced

    4. Recursive Triggers Enabled =True

  • The user name/login name should have either a db_owner role or the user name/login name should have the db_dbwriter, db_dbreader and db_ddladmin roles.

Put all the necessary information in the UI screen. On completion, the QPP Schema containing all the QPP tables will be created in this database.

Installing database from a separate machine

If you want to run the Platform Database installer from a different machine than the one on which the MS SQL database is installed:

  1. Meet the following prerequisites:

    • MS SQL Server Management Studio is installed on the machine.

    • The logged-on Windows user must have a sysadmin role on the MS SQL machine with Windows authentication.

    If the user does not want a sysadmin role, then a database which already exists in the user's MS SQL Server must be provided.

    • A folder for data files must exist on the machine on which the database MS SQL server is installed. This folder should contain the following subfolder: c:/test/QPPDATA/TestDb/, where TestDb is a folder name that is the same as the name of the database to be created.

  2. Follow the instructions for installing the database, giving the folder c:\test ( for example, this can be any folder) as the destination folder for data files while creating the database.

Creating/updating databases if Windows authentication only is supported

Quark Publishing Platform supports MS SQL Server with Windows authentication and mixed mode authentication.

If you are using MS SQL Server with Windows authentication then use the following instructions to create the database for Quark Publishing Platform Server.

The database folder contains two .bat files, "CreateAndSetupSSO.bat" and "UpdateUsingSSO.bat". These files rely on the logged-on user's credentials and do not require a database username and password.

To create or update the database:

  1. Open the "Update" or "Create" folder in the Database folder.

  2. Run the "CreateAndSetupSSO.bat" to create the Quark Publishing Platform database, or the "UpdateUsingSSO.bat" to update the existing database, with the following arguments:

    • HOSTNAME: The hostname where the database is to be created.

    • INSTANCENAME: The name of the already created database instance, if the instance is running on a non-default port. Enter the port number separated by <,> without any spaces and enclosed in "" (e.g. "mssqlserver,12345").

    • DATABASE: The name of the database to be created.

    • DESTINATION: Drive in which data files are to be created. Destination path must be enclosed in "", and must end with a \. Leave blank if the database already exists.

Installing Quark Publishing Platform Database on Windows — Oracle

You must install and configure Oracle before you can install the Quark Publishing Platform Database for Oracle. You can install the Quark Publishing Platform Database for Oracle on Windows with the Quark Publishing Platform Database installer ("Setup.exe" in the Installer/Database folder) or the Quark Publishing Platform Server installer ("Quark Publishing Platform Server.exe").

To install the Quark Publishing Platform Database for Oracle:

  1. Copy the "Setup.exe" file on the machine on which the Oracle database is installed and running.

  2. Double-click the "Setup.exe" file in the Installer/Database folder.

    The Quark Publishing Platform Database — Setup dialog box displays.

    You can also access the Quark Publishing Platform Database — Setup dialog box by double-clicking the "Quark Publishing Platform Server.exe" file and  then clicking Install QPP Database

  3. Click Next.

    The License Agreement screen displays.

  4. Click I accept the terms in the license agreement and click Next.

    The Database Information screen displays.

  5. Enter the Oracle Service Name in the Instance Name field.

  6. Enter the password of the database SYS user in the SYS Password field.

  7. Enter the name of the Quark Publishing Platform schema that you want to create in the Schema Name field.

  8. Enter the password of the Quark Publishing Platform schema in the Schema Password field.

    The installer creates a schema with the given name and password.

  9. Select the paths for storing data files, index files, and LOB files in the Destination Folder for area.

  10. Click Next.

    The Ready to Install the Application screen displays.

  11. Click Install.

  12. When the installation concludes, click Finish.

If you want to use an already existing database, you do not need to provide the Sys Password when installing the database, but a blank database and the user/login name must already exist with the following characteristics:

  • The existing database user name cannot own any tablespace with the name QPP.

  • The database user must have the following roles:

    1. CREATE session

    2. CREATE table

    3. CREATE view

    4. CREATE procedure

    5. create TRIGGER

    6. create SEQUENCE

    7. CREATE synonym

  • The database user must have the following QUOTA (as described with examples):

    ALTER USER DbUser DEFAULT TABLESPACE DATA_QPP;

    ALTER USER DbUser QUOTA UNLIMITED ON DATA_QPP;

    ALTER USER DbUser QUOTA UNLIMITED ON INDEX_QPP;

    ALTER USER DbUser QUOTA UNLIMITED ON BLOB_QPP;

    ALTER USER DbUser QUOTA 0 ON SYSTEM;

    ALTER USER DbUser QUOTA 0 ON SYSAUX;

Configuring Quark Publishing Platform schema for Oracle on Linux

Before setting up the Quark Publishing Platform schema, make sure that Oracle software is already installed on the computer with a database on which you will  configure your Quark Publishing Platform schema. Available as part of the Quark Publishing Platform package, the scripts for creating the Quark Publishing Platform schema for Oracle do not create the database. The Linux machine should have JRE 1.8 installed.

  1. Open the "Create" folder in the "Oracle" folder.

  2. To create the Quark Publishing Platform schema, run "CreateAndSetup.sh" (macOS/Linux) or "CreateAndSetup.bat" (Windows) with the following arguments:

    • SysPwd: password of the SYS user in the database

    • QPPUser: name of the Quark Publishing Platform schema that you want to create

    • QPPPwd: password for the Quark Publishing Platform schema

    • ServiceName: Oracle Service Name

    • DataDest: Path where data files are to be created

    • IdxDest: Path where index files are to be created

    • LobDest: Path where lob files are to be created

  3. The script performs the following:

    • Create Tablespaces

    • Create Schema/User

    • Create Tables

    • Create Indexes

    • Create Procedures

    • Initialize Setup data

    • Initialize User data

    • Create Foreign Keys

    • Create Quartz Schema

  4. Although you can use individual scripts provided for each of the tasks listed above, Quark recommends following the prompts and providing information  while running "CreateAndSetup.sh" or "CreateAndSetup.bat."

Deploying Amazon SQL Server (RDS) for Quark Publishing Platform

This section describes the steps necessary to use Amazon SQL Server for Quark Publishing Platform.

Prerequisites

A valid Amazon subscription is required.

Although an existing Virtual Public Cloud (VPC) can be used, Quark recommends creating a new VPC to logically separate and manage Quark resources.

Create a new VPC:

  1. Log on to the Amazon Portal at https://portal.amazon.com.

  2. On the AWS Management Console, under Networking & Content Delivery, Click VPC.

  3. On the VPC Dashboard menu, click Your VPCs.

  4. Click Create VPC.

  5. Specify the Name tag, and the IPv4 CIDR block.

  6. Click Create.

Create subnets:

  1. On the VPC Dashboard menu, click Subnets.

  2. Create two subnets using the Create subnet button. Specify the Name tag and from the VPC drop-down menu choose the VPC that is the same as that of Quark Publishing Server VPC.

    Each subnet should be in different availability zones.

Create a security group:

  1. On the VPC Dashboard menu, click Security Groups.

  2. Click Create security group.

  3. Specify a Security group name and Description, and click Create.

  4. Check the box next to your newly created security group and choose Edit inbound rules from the Actions drop-down menu.

  5. Add an inbound rule in which port 1433 is open.

Create SQL Server (RDS Service)

  1. Log on to the Amazon Portal at https://portal.amazon.com

  2. On the AWS Management Console, under Database, click RDS.

  3. On the Dashboard menu, click Subnet groups.

  4. Click Create DB subnet group. 

    • Specify a Name and Description

    • Under VPC, Choose the same VPC as that of Quark Publishing Platform server.

    • Under Add subnets, include both subnets created for the RDS service.

  5. Click Create.

  6. Navigate back to the dashboard and Click Create database.

    • On the Select engine pane:

      • Select the Microsoft SQL server as the database engine.

      • Select the SQL server edition.

        Quark recommends using SQL Server Enterprise Edition.

  7. Click Next.

  8. On the Choose use case pane, select an option and click Next.

    • On the Specify DB details pane:

      • Choose SQL Server 2016 from the DB engine version drop-down menu.

      • Choose an option from the DB instance class drop-down menu.

        This will be the machine configuration for your SQL server being created. 

     

    • In the Settings section of the Specify DB details pane:

      • Specify a name for your SQL Server database in the DB instance identifier field.

      • Specify the Master username and Master password. 

        This username and password will be used to communicate with the SQL server.

  9. Click Next.

    • In the Network & Security section of the Configure advanced settings pane:

      • Choose a VPC from the Virtual Private Cloud (VPC) drop-down menu that is the same as that of Quark Publishing Platform Server.

      • Choose the subnet group that was created earlier from the Subnet group drop-down menu.

  10. Click Create database. The database service will be created.

Note down the endpoint of the database service created above.
Creating Platform Server database schema on AWS RDS for SQL Server

  1. Double-click the "CreateAndSetup.bat" file in the database Installer /database/Cloud/sqlserver/create folder.

  2. Specify the following parameters:

    • HostName: database host endpoint

    • DatabaseName: database schema name

    • LoginName: database user name

    • Password: database user password

    • Master username: Master username.

    • Master username Password: password for the Master username 

Example:

C:\database\cloud\sqlserver\Create>CreateAndSetup.bat qppserverdb.cdsy95nkcdwl.ap-south-1.rds.amazonaws.com Build82a Build82a yourDBPassword yourUserID yourMasterUserPassword

Configure Platform Server to use AWS RDS SQL Server database:
If Quark Publishing Platform Server is already installed:

  1. Open the "Database.properties" file in the Quark Publishing Platform server\conf folder.

  2. Add the SQL database details, altering values to match the installed system:

    qpp.jdbc.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
qpp.jdbc.url = jdbc:sqlserver://qppserverdb.cdsy95nkcdwl.ap-south1.rds.amazonaws.com\\mssqlserver:1433;databaseName=BuildTest
qpp.jdbc.userName=BuildTest
qpp.jdbc.password=Easy123

  3. Save and close the file.

  4. Start Quark Publishing Platform Server.

Configure Platform Server using the server installer

Configure Platform Server to use AWS SQL using the server installer:

  1. Launch the Quark Publishing Platform Server installer.

  2. Enter the QLA details.

  3. Click Next.

  4. On the Database Information screen specify the following parameters:

    • Host Name: Enter the hostname of the AWS SQL database server (RDS) created.

    • Instance Name: Enter the instance name and port.

      Default values are mssqlserver and 1433.

    • Database Name: Enter the name of the database created in the Creating Platform Server database schema on AWS RDS for SQL Server section.

    • Database User Name: Enter the database username.

    • Database User Password: Enter the password for the database username.

  5. Click Next.

Installing QuarkXPress Server

For information on installing QuarkXPress Server, see the Getting Started with QuarkXPress Server file found here: http://www.quark.com/Support/Documentation/QuarkXPress_Server/2017.aspx

When the Port and Folder Settings screen displays:

  • check Enable HTTP Interface

  • enter a port number (Record the port number because you will need it when you install Quark Publishing Platform Server.)

  • check Enable the File System Document Pool

  • click Browse, and specify a location

Installing Quark Publishing Platform Server

Windows

To install the Quark Publishing Platform Server application:

  1. Double-click the "setup.exe" file.

    The Quark Publishing Platform - Setup screen displays.

  2. Click Next.

    The License Agreement screen displays.

  3. Click I accept the terms in the license agreement, then click Next.

    The Software Verification screen displays.

  4. Enter your validation code and click Next.

    The License Server Information screen displays with your serial number and date of installation.

  5. Enter the IP address or hostname of your Quark License Administrator (QLA) computer in the Host Name or IP Address field.

  6. Enter the port number in the Port field.

  7. If you use a QLA backup server, enter the hostname or IP address and port number in the Backup Host Name or IP Address and Port fields.

  8. Click Next.

    The Database Information screen displays.

    On the database information screen, check Use MS SQL Server with Windows/domain authentication when Windows or domain authentication is enabled on the SQL Server.

  9. The validation code you entered in step 5 corresponds to your database choice, which displays in gray in the Choose Database control. The other options vary according to your choice.

    • If you chose to use a Microsoft SQL Server database that you have already installed, SQL Server displays in gray. Enter the host name, instance name, port number, database name, database user name, and database user password for the Microsoft SQL Server database server. See "Installing Quark Publishing Platform Database on Windows — MS SQL Server" for details.

      The default port for such a database is 1433, but yours may be different. To find out, check the database instance in SQL Server Configuration Manager.

    • If you chose to use an Oracle database, Oracle displays in gray. Enter the host name, instance name, port number, database user name, and database user password for the Oracle server. See "Installing Quark Publishing Platform Database on Windows — Oracle" for details.

  10. Click Next.

    The Destination Folder screen displays.

  11. For Quark Publishing Platform Server Windows Service configuration, choose an option from the Choose System drop-down menu.

    • To specify local system account control, choose Local.

    • To specify domain user control, choose Domain and enter a domain name, user name, and password.

      If you choose Domain, enter an account name that has administrative rights on the computer.

  12. Click Next.

    The QuarkXPress Server Information screen displays.

  13. Enter your QuarkXPress Server IP address and port number and click Next.

    The Ready to Install the Application screen displays.

  14. Click Install.

  15. When installation is complete, the installer does the following things:

    • It automatically opens the Quark Publishing Platform Server console and starts Quark Publishing Platform Server. After this initial launch, you can start and stop Quark Publishing Platform Server from the console.

    • It displays the Quark Publishing Platform home page in the default Web browser.

Ensure that ‘Server’ directory and all its contents (sub directories and files inside them) has read and write permission for the USER who is going to run Server with any user other than who has installed the Quark Publishing Platform Server.

Installing Quark Publishing Platform Server on Red hat Linux

  1. Extract ‘Server.tar’ in the desired location on your RHEL system with the USER (hereafter referred as USER) intending to run QPP erver. Enter the desired location: cd <location>. Extract Server.tar in this location. Command to extract: tar -xvf Server.tar

  2. A directory named 'Server' (hereafter referred as 'Server directory') can be seen in this location now. 

  3. Make sure ‘Server’ directory and all its contents (sub directories and files inside them) at least has read and execute permissions for the USER. 

  4. Create a directory in your system with read, write and execute permissions for the USER. This directory will be used as the data folder for the Platform Server where following data will be written by the Platform Server:

    a. ‘work’ directory - Tomcat’s work directory

    b. ‘PublishingRescueFolder’ directory – contains publishing data in case of publishing failure 

    c. ‘log’ directory - QPP logs folder where 

    d. ‘qxpsmcache’ directory – Qxpsm cache folder 

    e. ‘workspacecache’ directory – workspace temp folder for rendering preview files 

    f. ‘index’ directory - Lucene indexes directory applicable only for single server deployment 

  5. Now cd to Server directory. 

  6. Run ‘installserverdependencies.sh’ with sudo privileges. This will install the following dependencies required by Platform Server: 

    a. openjdk 8 

    b. ImageMagick 7 

    c. Fontconfig – required by Highcharts and ImageMagick

  7. Run ‘setupdatafolder.sh’. This will ask for the writable folder’s absolute path. Provide the path chosen in step 4. Check that it ran without errors. This script will link the Platform Server to the provided writable folder. This will enable the Platform Server to write data to this directory. 

  8. Modify configurations like Database properties, Elastic Search properties in env.properties. 

  9. Modify configuration files like ManagerConfig.xml, etc. present in conf directory. 

  10. Open the following ports on your RHEL system: Inbound ports - 61400 and activemq port 61401. Outbound ports – 9300, 1433. 

  11. Run serverstartup.sh to start the server. 

  12. Use serverstop.sh to stop the Server.

Quark Publishing Platform Script Manager

Quark Publishing Platform Script Manager enables you to automate Quark Publishing Platform Server tasks with scripting. Quark Publishing Platform Script Manager is installed in the "ScriptManager" folder in the "Quark Publishing Platform Server" application folder. If you want to install Quark Publishing Platform Script Manager on another computer, copy the Quark Publishing Platform "ScriptManager" folder to the other computer.

Quark Publishing Platform Script Manager must be configured to run on the same machine as Quark Publishing Platform Server.

You must make changes to the batch file ("ScriptManagerStartup.bat" for Windows) to include a path entry for the JRE. If you are running it on the same machine as  Quark Publishing Platform Server, then that path can be C:[Server Install Path]\jre1.8-windows\bin.

From Quark Publishing System 8.1 to 9.2, you had to be licensed to use Script Manager. As of Quark Publishing Platform 9.5, Script Manager is no longer a separate  licensable item.

Silent installation of Platform Server

If you want to install the Platform server on more than one machine and do not want to enter the Database, QLA and QuarkXPress Server information again, you can  use the silent installation feature of the Quark Publishing Platform Server.

  1. Install the Quark Publishing Platform Server on one machine with all of the necessary information.

  2. Navigate to the Quark Publishing Platform Server installer folder.

  3. Copy the "setup.xml" and the "silent.bat" files to the same folder on the machine on which you will run the silent installation.

  4. Edit the "silent.bat" file in a text editor, giving the path of the installer for the Platform Server. Save the file.

  5. Double-click the "silent.bat" file.

    The Quark Publishing Platform Server will be installed without prompting for any information.

    The installation process will use the information about the Database, QLA and QuarkXPress Server from the "setup.xml" file.

Installing Quark Publishing Platform Client

macOS

To install the Quark Publishing Platform Client application:

  1. Disable any virus protection software. If you are concerned about a virus infecting your computer, run a virus check on the Installer files and then disable your virus detection software before installing.

  2. Double-click the "Quark Publishing Platform Client 2015 Installer.mpkg" file and follow the instructions on the screen.

You do not need to enter a validation code during the installation process.

Windows

To install the Quark Publishing Platform Client application:

  1. Disable any virus protection software. If you are concerned about a virus infecting your computer, run a virus check on the Installer files and then disable your virus detection software before installing.

  2. Double-click the "Setup.exe" file and follow the instructions on the screen.

You do not need to enter a validation code during the installation process.

Installing Quark XML Author for Quark Publishing Platform

For information on installing Quark XML Author, see the Quark XML Author for Quark Publishing Platform ReadMe.

Configuring Quark XML Author for web sharing

The web sharing configuration is only recommended for standalone server installations and not for external web container deployments or EAR based deployments. If web sharing configuration is required under those scenarios you will need to work with Quark support.
Configuring Quark XML Author for web sharing is optional. Web sharing installation and configuration is only intended for adding the ability for Platform end users to download and install XA and Office Adapters from the Platform landing page.

The deployment location will be in the "Quark Publishing Platform Server"/webapps folder on the Platform server machine.

To configure Quark XML Author for web sharing:

  1. Copy and extract the adapter archive "Platform<version and build>_Quark_XML_Author.zip".

  2. From the extracted archive, copy/overwrite all files from the webapps\ROOT folder to the Quark Publishing Platform Server\webapps\ROOT folder.

  3. From the extracted archive, copy all files from the webapps\clientinstallers\QXA Adapter folder to the Quark Publishing Platform Server\webapps\clientinstallers\ folder.

  4. Under "Quark Publishing Platform Server\webapps\clientinstallers\QXA Adapter\BUSDOCS\en" extract the BUSDOCS configuration archive, typically named "XML_Author_<version and build>_for_Platform_<version >_<Word version>_<configuration>_(unlimited).zip, e.g. "XML_Author_7.0_for_Platform_15.0_BUSDOCS_(Unlimited).zip", and copy the 2010 folder to the Quark Publishing Platform Server\webapps\clientinstallers\QXA Adapter\BUSDOCS\en folder.

    The same steps need to be repeated for the Japanese archive under Quark Publishing Platform Server\webapps\clientinstallers\QXA Adapter\BUSDOCS\ja.

  5. Under "Quark Publishing Platform Server\webapps\clientinstallers\QXA Adapter\DITA\en" extract the DITA configuration archive, typically named "XML_Author_<version and build>_for_Platform_<version >_<Word version>_<configuration>_(unlimited).zip, e.g. "XML_Author_6.3.6485.14898_for_Platform_15.0_DITA_(Unlimited).zip", and copy the 2010 folder to the Quark Publishing Platform Server\webapps\clientinstallers\QXA Adapter\DITA\en folder.

    The same steps need to be repeated for the Japanese archive under Quark Publishing Platform Server\webapps\clientinstallers\QXA Adapter\DITA\ja.

  6. Run the Batch file after updating the HostName/IP and the Port in the Batch file "ConfigureAdapter.bat" under "clientinstallers/QXA Adapter/<configuration>/<language>

Configuring the Platform Adapters for Microsoft Office components for web sharing

The web sharing configuration is only recommended for standalone server installations and not for external web container deployments or EAR based deployments. If web sharing configuration is required under those scenarios you will need to work with Quark support.

This chapter gives instruction on installing the following Microsoft Office components:

  • Quark Publishing Platform Adapter for Microsoft Office - Word

  • Quark Publishing Platform Adapter for Microsoft Office - Excel

  • Quark Publishing Platform Adapter for Microsoft Office - PowerPoint

  • Quark Publishing Platform Adapter for Microsoft Office - Visio

The deployment location will be in the "Quark Publishing Platform Server" webapps folder on the Platform server machine.

The following steps need to be completed before installing any of the components:

  1. Copy and extract the archive "Platform<version and build>_Adapter_for_Office.zip".

  2. From the extracted archive, copy/overwrite all files from the webapps\ROOT folder to the Quark Publishing Platform Server\webapps\ROOT folder.

  3. Copy the contents of the webapps\clientinstallers folder to the Quark Publishing Platform Server\webapps\clientinstallers folder.

Then perform the steps in the following sections to install the individual components:

Configuring the Quark Publishing Platform Adapter for Microsoft Office - Word

To install the Platform Adapter for Microsoft Word:

  1. Extract the contents of the archive "Word Adapter.zip" file from the webapps\clientinstallers folder on the Platform server machine to the webapps\clientinstallers\Word Adapter\ folder.

  2. Update the HostName/IP and the Port in the Batch file "ConfigureAdapter.bat" under clientinstallers/Word Adapter, and then run the Batch file.

Configuring the Quark Publishing Platform Adapter for Microsoft Office - Excel

To install the Platform Adapter for Microsoft Excel:

  1. Extract the contents of the archive "Excel Adapter.zip" file from the webapps\clientinstallers folder on the Platform server machine to the webapps\clientinstallers\Excel Adapter\ folder.

  2. Update the HostName/IP and the Port in the Batch file "ConfigureAdapter.bat" under clientinstallers/Excel Adapter, and then run the Batch file.

Configuring the Quark Publishing Platform Adapter for Microsoft Office - PowerPoint

To install the Platform Adapter for Microsoft PowerPoint:

  1. Extract the contents of the archive "PowerPoint Adapter.zip" file from the webapps\clientinstallers folder on the Platform server machine to the webapps\clientinstallers\PowerPoint Adapter\ folder.

  2. Update the HostName/IP and the Port in the Batch file "ConfigureAdapter.bat" under clientinstallers/PowerPoint Adapter, and then run the Batch file.

Configuring the Quark Publishing Platform Adapter for Microsoft Office - Visio

To install the Platform Adapter for Microsoft Visio:

  1. Extract the contents of the archive "Visio Adapter.zip" file from the webapps\clientinstallers folder on the Platform server machine to the webapps\clientinstallers\Visio Adapter\ folder.

  2. Update the HostName/IP and the Port in the Batch file "ConfigureAdapter.bat" under clientinstallers/PowerPoint Adapter, and then run the Batch file.

Manually installing Quark Publishing Platform XTensions software

On client computers, you must install QuarkXPress and QuarkCopyDesk before you run the Quark Publishing Platform Client installer. Follow the instructions in the QuarkXPress and QuarkCopyDesk ReadMe files. Launch the applications to verify a successful installation, and then exit the applications.

The Quark Publishing Platform Client installer searches for compatible installations of QuarkXPress and QuarkCopyDesk on your computer and attempts to install  Quark Publishing Platform XTensions software in each program's application folder.

The Quark Publishing Platform Client installer also disables the Dejavu XT XTensions software for QuarkXPress and QuarkCopyDesk. Dejavu XT XTensions software lists recently used files in the Open submenu (File menu), but it can degrade performance in a Quark Publishing Platform environment.

On Windows only, if the Quark Publishing Platform Client installer cannot locate your copies of QuarkXPress and QuarkCopyDesk, it copies the XTensions software to the root level of the "Quark Publishing Platform Client" folder. If this is the case, use the following procedure to install the Quark Publishing Platform XTensions software:

Windows

To manually install the Quark Publishing Platform XTensions software for QuarkXPress and QuarkCopyDesk:

  1. Exit QuarkXPress and QuarkCopyDesk.

  2. Open the "XTensions" folder in the "For QuarkCopyDesk" folder at the root level of your "Quark Publishing Platform Client" folder and copy the XTensions software files to the "XTensions" folder in your QuarkCopyDesk application folder.

  3. Open the "Help" folder in the "For QuarkCopyDesk" folder at the root level of your "Quark Publishing Platform Client" folder and copy the contents to the "Help" folder in your QuarkCopyDesk application folder.

  4. Open the "Documents" folder in the "For QuarkCopyDesk" folder at the root level of your "Quark Publishing Platform Client" folder and copy the contents to the corresponding folders in the "Documents" folder in your QuarkCopyDesk application folder.

  5. Open the "Symbols" folder in the "For QuarkCopyDesk" folder at the root level of your "Quark Publishing Platform Client" folder and copy the contents to the corresponding folders in the "Symbols" folder in your QuarkCopyDesk application folder.

  6. Copy all the remaining files and folders from the "For QuarkCopyDesk" folder at the root level of your "Quark Publishing Platform Client" folder to the root level of your QuarkCopyDesk application folder.

  7. Move the Dejavu XT XTensions software file from the "XTensions" folder in your QuarkCopyDesk application folder to the "XTensions Disabled" folder.

  8. Open the "XTensions" folder in the "For QuarkXPress" folder at the root level of your "Quark Publishing Platform Client" folder and copy the XTensions software files to the "XTensions" folder in your QuarkXPress application folder.

  9. Open the "Help" folder in the "For QuarkXPress" folder at the root level of your "Quark Publishing Platform Client" folder and copy the contents to the "Help" folder in your QuarkXPress application folder.

  10. Open the "Documents" folder in the "For QuarkXPress" folder at the root level of your "Quark Publishing Platform Client" folder and copy the contents to the corresponding folders in the "Documents" folder in your QuarkXPress application folder.

  11. Open the "Symbols" folder in the "For QuarkXPress" folder at the root level of your "Quark Publishing Platform Client" folder and copy the contents to the corresponding folders in the "Symbols" folder in your QuarkXPress application folder.

  12. Copy all the remaining files and folders from the "For QuarkXPress" folder at the root level of your "Quark Publishing Platform Client" folder to the root level of your QuarkXPress application folder.

  13. Move the Dejavu XT XTensions software file from the "XTensions" folder in your QuarkXPress application folder to the "XTensions Disabled" folder.

Making changes after installation

To access the instance of QuarkXPress Server Manager running inside Quark Publishing Platform Server, launch a Web browser, navigate to http://[QPP server]:[port]/qxpsmadmin.

Allocating RAM for Quark Publishing Platform Server

You can change the amount of memory allocated to your JVM. Quark recommends not exceeding 50 percent of available memory on Windows.

Windows

On Windows, you can specify memory allocation in different locations, depending on how you start Quark Publishing Platform Server.

  1. Stop Quark Publishing Platform Server.

  2. If you start Quark Publishing Platform Server with Quark Publishing Platform Server Console or Quark Publishing Platform Server Windows service, open the "wrapper.conf" file.

  3. Search for the "wrapper.java.maxmemory" property.

  4. Adjust the value to any value, unless this exceeds 50 percent of the available memory.

    Quark Publishing Platform supports only 64-bit computers, which allows you to increase the memory to any reasonable value.

  5. Save your changes and restart Quark Publishing Platform Server.

  6. If you use "Serverstartup.bat" to run the Quark Publishing Platform Server, follow the steps below:

  7. Stop Quark Publishing Platform Server.

  8. Open "ServerStartup.bat" in a text-editing application.

  9. Search for "java -Xmx2048m -XX:MaxPermSize=256m -classpath." "2048M" represents 2048 MB of RAM allocated to Quark Publishing Platform Server.

  10. Adjust the value to any value, unless this exceeds 50 percent of the available memory.

    Quark Publishing Platform supports only 64-bit computers, which allows you to increase the memory to any reasonable value.

  11. Save your changes and restart Quark Publishing Platform Server.

© 2020 Quark Software Inc. All rights reserved.