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 QXP Server in external Tomcat
To install QuarkXPress Server as an independent Web application in an existing Tomcat Web container:
-
Verify that Tomcat 7.0.77 is installed.
-
Set up the following environment variables:
-
JAVA_HOME= Java installation folder. For example:E:\Program Files\Java\jdk1.8.0_121 -
CATALINA_HOME= Tomcat installation folder. For example:E:\apache-tomcat-7.0.77
-
-
Copy contents of the
[QXPS_BUILD]/webappsfolder to the[TOMCAT_HOME]/webappsfolder. -
Copy the
[QXPS_BUILD]/conffolder to[TOMCAT_HOME]/bin. -
In the
[TOMCAT_HOME]/bin/conf/Qla.propertiesfile, set the host name, port number, and serial number of your instance of QLA Server.-
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 theBackup.QlaServer.machinename=andBackup.QlaServer.port=fields.
-
-
(Windows only) Execute
vcredist_x64.exeprovided with the build before starting QXPS. -
Copy the
Documentsfolder to[TOMCAT_HOME]. -
Open
[TOMCAT_HOME]/conf/server.xmland add the following inside the<Host name="localhost" appBase="webapps".....>tag:<Context path="/qxps/documents" docBase="../Documents/Documentation" > <Manager pathname=""/> </Context>Uncomment the Mac OS X settings section.
Deploying QXPSM in external Tomcat
To install QuarkXPress Server Manager as an independent Web application in an existing Tomcat Web container:
-
Verify that Tomcat 7.0.77 is installed.
-
Locate the Tomcat installation folder (referred to here as
[Tomcat_Home]). -
Locate the QuarkXPress Server Manager external Tomcat installation folder (referred to here as
[QXPSM_Tomcat]). -
Drag the contents of
[QXPSM_Tomcat]/confto[Tomcat_Home]/conf. -
Drag the contents of
[QXPSM_Tomcat]/webappsto[Tomcat_Home]/webapps. -
Drag
[QXPSM_Tomcat]/qxpsmto[Tomcat_Home]. -
Open the file
[Tomcat_Home]/conf/ManagerContainerConfig.xmland make the following changes in theContainerAdapterbean:-
Set
cacheFolderContextFileto the path of the "cache.xml" file relative to the current working directory. -
Set
serverXmlFilePathto the path of the "Server.xml" file relative to the current working directory.
-
-
Open the file
[Tomcat_Home]/conf/Catalina.propertiesand specify the path of the shared class loader. For example:shared.loader=${catalina.home}/qxpsm/lib/*.jar,${catalina.home}/conf -
Open the file
[Tomcat_Home]/conf/Catalina/localhost/cache.xmland set the docbase attribute to the path of the appropriate cache folder. -
Double-click the "startup.bat" file. These files can be found in the
TOMCAT_HOME/binfolder.
Deploying QXP Server in WebSphere
To install QuarkXPress Server as an independent Web application in an IBM WebSphere Web container:
Prerequisites
-
Download the IBM Installation Manager 1.6.2 software and extract its contents to your local folder (for example,
IBM_MANAGER_DIR). -
Download the IBM WebSphere 9.0.0.3 developer version software. This is in 3 parts in an archived (.zip) format.
-
Extract all 3 parts of IBM WebSphere 9.0.0.3 to your local folder (for example,
IBM_WEBSPHERE_DIR). -
Download the SDK for Java 1.8 for IBM WebSphere 9.0.0.3, This is in 3 parts in an archived (.zip) format.
-
Extract all 3 parts of SDK for Java 1.8 to your local folder (for example,
SDK-FOR-Java-1.8_DIR).
Installing the IBM-WebSphere developer version
-
Go to the
$(IBM_MANAGER_DIR) folder and run "install.exe" with administrator privilege. -
Launch the IBM Installation Manager 1.6.2 with administrator privilege.
-
Go to File->Preferences. The Preferences dialog displays. Select the Repositories option on the left side.
-
Click the Add Repository button from the right side. Browse to and select the "respository.config" file from the
$(IBM_WEBSPHERE_DIR)/was.repo.9003.developers.ilan_part1folder. -
Click Apply and then click OK.
-
Go to the IBM Installation Manager, select the Install option.
IBM WebSphere 9.0.0.3 will be installed in your Program Files location.
C:\Program Files (x86)\IBM\WebSphere. -
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:
-
$(IBM_WEBSPHERE_DIR)/was.repo.9003.developers.ilan_part2 -
$(IBM_WEBSPHERE_DIR)/was.repo.9003.developers.ilan_part3
-
-
Go to Start->WebSphere Customization Toolbox. Select the Create option on the right side.
The Profile Management Tool dialog displays.
-
Select
Application Serveras the WebSphere Application Server and click Next. -
Select Typical file creation and click Next.
-
Select Disable Administrative Security and click Next.
-
Select Create a profile.
Configure the Java 7 SDK in the IBM WebSphere
-
Open the cmd window. Navigate to the
$(WS_INSTALLED_DIR)/AppServer/binfolder. -
Type the command
managesdk.bat -listAvailable. -
Launch the IBM installation manager.
-
Go to File->Preferences. The Preferences dialog displays. Select the Repositories option on the left side.
-
Click the Add Repository button from the right side. Browse to and select the "repository.config" file from the
$(SDK-FOR-Java-1.8_DIR)/was.repo.9003.java7_part1folder. -
Click Apply and then click OK.
-
Go to the IBM Installation Manager, select the Install option.
IBM WebSphere 9.0.0.3 will be installed in your Program Files location.
C:\Program Files (x86)\IBM\WebSphere. -
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:
-
$(SDK-FOR-Java-1.8_DIR)/was.repo.9003.java7_part2 -
$(SDK-FOR-Java-1.8_DIR)/was.repo.9003.java7_part3
-
-
The Java7 SDK for IBM WebSphere will be installed successfully. Check it at the
$(WS_INSTALLED_DIR)/AppServer/java_1.8_64folder -
Open the cmd window. Navigate to the
$(WS_INSTALLED_DIR)/AppServer/binfolder. -
Type the command
managesdk.bat -listAvailable. -
Type the command
managesdk.bat -enableProfile -profileName AppSrv01-sdkname 1.8_64. This binds IBM WebSphere into Java7 runtime.
Start IBM WebSphere
-
Enter
First Step.batfrom the start menu or from$(WS_INSTALLED_DIR)/AppServer/profiles/AppSrv01/firststeps/firststeps.bat.The WebSphere Application server dialog displays.
-
Start the Server.
QXPS WebApp deployment into IBM WebSphere UI
-
Copy the
[QXPS_BUILD]/conffolder to WebSphere's current directory (for example,$(WS_INSTALLED_DIR)/AppServer/profiles/AppSrv01. Open "ServerApp.properties" and update the following:-
qxpswebserver.embeddedwebcontainer= false -
qxps.webapp.context.name= /qxps
-
-
Open the "QXPSLoadComponents.properties" file located at
$(WS_INSTALLED_DIR)/AppServer/profiles/AppSrv01/confand remove the following entries:<import resource="classpath:com/quark/azure/auth/AzureAuthContext.xml"/> <import resource="classpath:com/quark/qxps/azure/config/AzureConfiguration.xml"/> <import resource="classpath:com/quark/qxps/azure/config/AzureConfiguration.xml"/> -
Open the "PropertiesFilePlaceholders.properties" files located at
$(WS_INSTALLED_DIR)/AppServer/profiles/AppSrv01/confand remove the following entries:-
<value>file:./conf/AzureAuthenticate.properties</value>
-
-
In the
[TOMCAT_HOME]/bin/conf/Qla.propertiesfile, set the host name, port number, and serial number of your instance of QLA Server.-
Set
QlaServer.machinenameto the IP address or hostname of the QLA server. -
Set
QlaServer.portto the port number of the QLA server. -
If you have a backup QLA server, set
Backup.QlaServer.machinenameandBackup.QlaServer.portto its IP address or hostname and port number.
-
-
Extract the "EAR (qxps-2020.ear)" file. Open the "qxps-servlet.xml" file located at
$(QXPS-EAR_DIR)\qxps-2020\source\qxps\WEB-INF\and remove the following entries:<value>file:./conf/AzureAuthenticate.properties</value> <property name="authManager" ref="azureAuthenticationManager"/> <prop key="/secure/azureauth">azureAuthReplyController</prop> <property name="authResultCBHandler" ref="qxpsAzureAuthResultCBHandler"/> <property name="authManager" ref="azureAuthenticationManager"/> -
Create the WAR bundle by using the "CreateQXPS_EAR.bat" batch file located at the extracted folder:
$(QXPS-EAR_DIR) -
Open http://localhost:9080/ibm/console/ in a browser and login.
-
Select the Application tab from the right and select New Application.
-
Select New Enterprise Application. When asked for the path to the new application, choose the file and click Next.
-
When asked “How do you want to install the application?”, select Fast Path and click Next.
-
Change the application name if required and click Next.
-
Select both the modules and click Next.
-
Select both the web modules and click Next.
-
Select the qxpsadmin module and click Next and then Finish.
-
Save the changes to the master configuration.
-
Select the Server tab from the right and select WebSphere Application Servers> server1 > Web server plug-in properties.
-
Set the maximum number of connections that can be handled by the application server to 150.
-
Save the changes.
-
Select the Application tab from the right and select Application Types -> WebSphere Enterprise applications. Select qxps and Start.