Getting Started with QuarkXPress Server 2018
Contents Introduction..................................................................................1 Related Documents ......................................................................2 System Requirements...................................................................3 System requirements: Mac OS X ......................................................................3 System requirements: Windows .......................................................................
Uninstalling: Windows.....................................................................................23 Changes in this version ..............................................................24 New for QuarkXPress Server 2018.................................................................24 Known and resolved issues ........................................................26 Contacting Quark .......................................................................27 In the Americas .....................
INTRODUCTION Introduction QuarkXPress® Server is a high-fidelity content-composition and rendering server application. It is built on multiple technologies derived from QuarkXPress. Through a network connection and a browser, QuarkXPress Server can return rendered versions of QuarkXPress layouts and QuarkCopyDesk articles in a variety of formats. This document provides information about QuarkXPress Server software.
RELATED DOCUMENTS Related Documents For more information about using the QuarkXPress Server, you may need to reference the other QuarkXPress Server documentation/resources listed below. Document/Item Name Description Where to find A guide written for the end user of the QuarkXPress Server. Contains all of the QuarkXPress Server User Guide QXPS documentation, QuarkXPress Server User Guide including documentation for QXPSM, and Modifier schema. http://www.quark.
SYSTEM REQUIREMENTS System Requirements This section lists baseline minimum requirements for evaluation and demonstration. Like any enterprise system, performance is highly contextual based on data complexity, number of requests, and IT infrastructure. Your specific requirements for production shall require development as part of the overall solution planning process. For more information, please contact http://www.quark.com/support or your Quark sales contact.
SYSTEM REQUIREMENTS • Java J2SE™ Runtime Environment (JRE™) 8.0 Hardware • 1 processor core and 4 sub-renderers with 4GB of RAM for each renderer* • 10GB of additional disk space per renderer for temporary files ! *Like any enterprise system, performance is highly contextual based on data complexity, number of requests, and IT infrastructure. Contact your account manager for sizing your organization’s publishing needs.
SYSTEM REQUIREMENTS ! *Like any enterprise system, performance is highly contextual based on data complexity, number of requests, and IT infrastructure. Contact your account manager for sizing your organization’s publishing needs.
SYSTEM REQUIREMENTS Installing QuarkXPress Server The topics below describe how to install QuarkXPress Server. Installing QuarkXPress Server: Mac OS X To install QuarkXPress Server: 1. Disable any virus protection software. If you are concerned about a virus infecting your computer, run a virus check on the installer file and then disable your virus detection software. 2. Double-click the Installer icon and follow the instructions on the screen. 3. When prompted, enter the validation code.
INSTALLING QUARKXPRESS SERVER 1. Disable any virus protection software. If you are concerned about a virus infecting your computer, run a virus check on the installer file and then disable your virus detection software. 2. Double-click the Installer icon and follow the instructions on the screen. 3. In the Software Verification screen, enter the validation code. ! Do not discard the validation code. You will need it if you have to reinstall. 4.
UPGRADING QUARKXPRESS SERVER Upgrading QuarkXPress Server 1. Uninstall your current version of QuarkXPress Server as described in “Uninstalling“. 2. Install the new version of the software as described in “Installing QuarkXPress Server“.
DEPLOYING QUARKXPRESS SERVER MANAGER Deploying QuarkXPress Server Manager There are three ways to deploy QuarkXPress Server Manager: • As a standalone server. To deploy QuarkXPress Server Manager in this manner, install the software as described in “Installing QuarkXPress Server Manager,” then double-click the server/QXPSMServerStart.command (Mac OS X) or server/QXPSMServerStart.bat (Windows) file in the QuarkXPress Server Manager application folder.
DEPLOYING QUARKXPRESS SERVER MANAGER Installing QuarkXPress Server Manager: Mac OS X ! You must uninstall the previous version of QuarkXPress Server Manager before installing this version. See “Uninstalling“ for more information. To install QuarkXPress Server Manager: 1. Disable any virus protection software. If you are concerned about a virus infecting your computer, run a virus check on the installer file and then disable your virus detection software. 2.
DEPLOYING QUARKXPRESS SERVER MANAGER ! This type of deployment model is possible only when the application in which QuarkXPress Server Manager is to be embedded is a Spring application and is deployed with an embedded or external Tomcat Web container. To install QuarkXPress Server Manager in a shared Spring context: 1.
DEPLOYING QUARKXPRESS SERVER MANAGER createWebApplicationContext(ServletContext servletContext, ApplicationContext parent) { return super.createWebApplicationContext(servletContext, parent); } } } 5. Create a file named “applicationContext.xml” in webapps/qxpsm/WEB-INF and fill it with the following content: PAGE 16
DEPLOYING IN AN EXTERNAL WEB CONTAINER Deploying in an external Web container For development, and simple test deployments, QuarkXPress Server and QuarkXPress Server Manager are provided pre-installed in an instance of Apache Tomcat. However, for production deployment alongside other Web applications, QuarkXPress Server and QuarkXPress Server Manager can be deployed in an existing Tomcat or WebSphere.
DEPLOYING IN AN EXTERNAL WEB CONTAINER • Enter the IP address or hostname of the QLA Server in the QlaServer.machinename= field. • Enter the port number of the QLA Server in the QlaServer.port= field. If you have a backup QLA server, enter the IP address (or hostname) and port number in the Backup.QlaServer.machinename= and Backup.QlaServer.port= fields. 7. (Windows OS only) Execute vcredist_x64.exe provided with the build before starting QXPS. 8. Copy the Documents folder to [TOMCAT_HOME]. 9.
DEPLOYING IN AN EXTERNAL WEB CONTAINER 1. Verify that Tomcat 7.0.77 is installed. 2. Locate the Tomcat installation folder (referred to here as [Tomcat_Home]). 3. Locate the QuarkXPress Server Manager external Tomcat installation folder (referred to here as [QXPSM_Tomcat]). 4. Drag the contents of [QXPSM_Tomcat]/conf to [Tomcat_Home]/conf. 5. Drag the contents of [QXPSM_Tomcat]/webapps to [Tomcat_Home]/webapps. 6. Drag [QXPSM_Tomcat]/qxpsm to [Tomcat_Home]. 7.
DEPLOYING IN AN EXTERNAL WEB CONTAINER Installing the IBM-WebSphere developer version 1. Go to the $(IBM_MANAGER_DIR) folder and run “install.exe” with administrator privilege. 2. Launch the IBM Installation Manager 1.6.2 with administrator privilege. 3. Go to File->Preferences. The Preferences dialog displays. Select the Repositories option on the left side. 4. Click the Add Repository button from the right side. Browse to and select the “respository.config” file from the $(IBM_WEBSPHERE_DIR)/was.
DEPLOYING IN AN EXTERNAL WEB CONTAINER IBM WebSphere 8.5.5.0 will be installed in your Program Files location. C:\Program Files (x86)\IBM\WebSphere. 8. During the installation, you will be asked to enter the configuration file for Part 2 and Part 3 of IBM WebSphere. Select the files from their respective folders: 9. • $(SDK-FOR-Java-1.7_DIR)/was.repo.8550.java7_part2 • $(SDK-FOR-Java-1.7_DIR)/was.repo.8550.java7_part3 The Java7 SDK for IBM WebSphere will be installed successfully.
DEPLOYING IN AN EXTERNAL WEB CONTAINER 4. In the [TOMCAT_HOME]/bin/conf/Qla.properties file, set the host name, port number, and serial number of your instance of QLA Server. • Set QlaServer.machinename to the IP address or hostname of the QLA server. • Set QlaServer.port to the port number of the QLA server. • If you have a backup QLA server, set Backup.QlaServer.machinename and Backup.QlaServer.port to its IP address or hostname and port number. 5. Extract the “EAR (qxps-2017.ear)” file.
DEPLOYING IN AN EXTERNAL WEB CONTAINER QXPS WebApp silent deployment into IBM WebSphere 1. Copy the [QXPS_BUILD]/conf folder to WebSphere’s current directory (for example, $(WS_INSTALLED_DIR)/AppServer/profiles/AppSrv01. Open ServerApp properties and update the following: 2. • qxpswebserver.embeddedwebcontainer= false • qxps.webapp.context.name= /qxps In the [TOMCAT_HOME]/bin/conf/Qla.properties file, set the host name, port number, and serial number of your instance of QLA Server.
DEPLOYING IN AN EXTERNAL WEB CONTAINER 5. Open the “ServerApp.properties” file in the [$wls]/wlsxxxx/user_projects/domains/base_domain/conf folder and update the following entries: 6. • qxpswebserver.embeddedwebcontainer= false • qxps.webapp.context.name= /qxps Open the “‘QXPSLoadComponents.properties”‘ file located at [$wls]/wlsxxxx/user_projects/domains/base_domain /conf and remove the following entries: PAGE 24DEPLOYING IN AN EXTERNAL WEB CONTAINER QXPS WebApp deployment into WebLogic UI 1. Navigate to the administrative console page for your server (http://localhost:7001/console) and log in using the domain credentials that you entered during the WebLogic setup in “Deploying QXP Server in WebLogic”. 2. Go to domain structure > Deployments > Install, then select the QuarkXPress Server EAR file ([QXPS_BUILD]\QXPS-EAR\qxps-2017.ear) and select Next. 3.
INTRODUCTION TO QLA SERVER Introduction to QLA Server QLA Server is the software component that issues licenses to the Quark application clients. After you install Quark License Administrator Server, download your license file from the Quark Web site. The server can be any computer on the network that meets the minimum system requirements. The server monitors license usage over the network and grants licenses to the client computers.
INTRODUCTION TO QLA SERVER Uninstalling If the uninstaller detects a running instance of the application, an alert displays. Close the application before you begin to uninstall. Uninstalling: Mac OS X To uninstall QuarkXPress Server, open the Applications folder on your hard drive (or the folder in which QuarkXPress Server was installed) and drag the QuarkXPress Server folder to the trash.
CHANGES IN THIS VERSION Changes in this version This section will cover the various changes introduced in different versions of QuarkXPress Server. ! For details about all of these changes, see A Guide to QuarkXPress Server. New for QuarkXPress Server 2018 Changes in version 14.0.2 included the following: • QuarkXPress Server is compatible with QuarkXPress 2018 (14.x).
CHANGES IN THIS VERSION • Added PICTURE@ALTTEXT. This lets you set alternate text for each image to enhance accessibility.
KNOWN AND RESOLVED ISSUES Known and resolved issues For lists of known issues and resolved issues in this version of the software, visit the Quark Web site at http://www.quark.com. Product documentation, including lists of known and resolved issues, is available under Support > Product Documentation.
CONTACTING QUARK Contacting Quark The support portal allows you to log support tickets, track tickets, receive status notifications, chat with a technical support representative, search the Knowledge Base, and access product documentation. With direct access to documentation across all Quark software - from QuarkXPress and App Studio to Quark Enterprise Solutions - you can find answers to your questions at your convenience.
LEGAL NOTICES Legal Notices ©2018 Quark Software Inc. and its licensors. All rights reserved. Quark, the Quark logo, and QuarkXPress are trademarks or registered trademarks of Quark Software Inc. and its affiliates in the U.S. and/or other countries. All other marks are the property of their respective owners.