To work with FrameMaker Publishing Server, do the following:
(Optional) Enable HTTP or HTTPS with Windows authentication (if you want to restrict access by switching on the authentication)
Install a command line tool (Install a free command line tool, such as cURL, to access FrameMaker Publishing Server using the command line.)
(Optional) Enable HTTP ports for FMPS access from other network machines
(Optional) Enable email
Enable browse functionality through Java™ applet
To install FMPS, perform the following steps:
Run the FMPS installer. The following Installation Options dialog appears:
Select Adobe FrameMaker 2019.
Select Adobe FrameMaker Publishing Server Components
The installer also installs Microsoft deploy, registers IIS and its components for FMPS use, and installs basic website - the application settings of that website need to be edited manually in IIS.
If you want to change the default install location, click the Browse icon next to the Location field and select a new destination.
On Windows 10 operating system, you might have to deploy the site manually. Follow the steps mentioned in the section
Manually install FMPS website in IIS.Unzip the following
file.The
default location of the WebServerUI.rar
WebServerUI.rar
file is:
Program
Files\Adobe\Adobe FrameMaker Publishing Server Core 2019\www \WebServerUI.rar
The contents of the WebServerUI.rar file must be extracted within the same (www) folder.
In the Internet Information Services (IIS) Manager, under Sites > fmps15> Application Settings (Under ASP.NET), change the following settings:
Debug: Set the value to true to allow debugging.
DebugLog: Enter path of the debug log that gets populated with error messages.
FMPSBaseDir: The directory that would contain all tasks-related data.
FMPSDomain: The domain name of FMPS. Use the network domain the machine belongs to or workgroup name if the machine is not on a domain.
FMPSHelpDataEnabled: Set this to true to enable Server Help to be viewable by any user.
FMPSPassword: Password associated with the user name entered in FMPSUserName.
FMPSSchFolder: This folder contains FMPS scheduled tasks.
FMPSUserName: user name for accessing FMPS (do not add the domain name here)
Go to Application pools > fmps15 > Advanced Settings > Process Model > Identity > Custom Account and set credentials as follows:
User name: Enter <domain>\<username> keeping them same as the details entered in the step 3.
Password: Enter the password you entered in step 3.
Confirm Password: Re-enter your password.
In a browser, open the website http://localhost:6234/index.html
.
The browser displays FMPS website's index.html page.
To optimize the performance of FrameMaker in automated publishing tasks, make the following changes to FrameMaker configuration. These changes are essential to run scheduled tasks on FMPS and modify the behavior in the following ways.
FMPS ignores unresolved cross-references, unresolved text insets, and missing graphics.
To use MathML, accept the EULA in FrameMaker.
Check all source documents for errors before initiating a build task.
FMPS automatically opens and closes FrameMaker instance. You cannot control these operations.
FMPS does not report missing fonts. Ensure that the machine that hosts FMPS has all the required fonts.
Open Web.config
file from the
following location:
Program Files\Adobe\Adobe FrameMaker
Publishing Server Core 2019\www
<endpoint address="fmserver/v1"
binding="webHttpBinding" contract="Server.IWebService" behaviorConfiguration="webhttp" bindingConfiguration="securehttp"
/>
<endpoint address="" binding="webHttpBinding" contract="Server.IWebPage"
behaviorConfiguration="webhttp" bindingConfiguration="securehttp"
/>
To enable Windows authentication over HTTPS, locate the following lines and uncomment them:
<endpoint address="fmserver/v1"
binding="webHttpBinding" contract="Server.IWebService" behaviorConfiguration="webhttp" bindingConfiguration="securehttps"
/>
<endpoint address="" binding="webHttpBinding" contract="Server.IWebPage"
behaviorConfiguration="webhttp" bindingConfiguration="securehttps"
/>
By default the code is commented using the <!--
and -->
tags.
Remove the comment tags to use the code in the Web.config file.
In the Internet Information Services (IIS) Manager, go to Sites > fmps15, select Authentication (under IIS) and enable Windows Authentication.
If you do not enable authentication, there is no need to pass the authentication-related parameters while accessing FMPS through APIs. For more information, see Working with FMPS using the APIs.
Open Web.config
file from the
following location:
Program Files\Adobe\Adobe FrameMaker
Publishing Server Core 2019\www
To use HTTP without Windows authentication, locate the following lines and uncomment them:
<endpoint address="fmserver/v1"
binding="webHttpBinding" contract="Server.IWebService" behaviorConfiguration="webhttp"
/>
<endpoint address="" binding="webHttpBinding" contract="Server.IWebPage"
behaviorConfiguration="webhttp" />
To use HTTPS without Windows authentication, locate the following lines and uncomment them:
<endpoint address="fmserver/v1"
binding="webHttpBinding" contract="Server.IWebService" behaviorConfiguration="webhttp" bindingConfiguration="securehttpswoauth"
/>
<endpoint address="" binding="webHttpBinding" contract="Server.IWebPage"
behaviorConfiguration="webhttp" bindingConfiguration="securehttpswoauth"
/>
By default the code is commented using the <!--
and -->
tags.
Remove the comment tags to use the code in the Web.config file.
In the Internet Information Services (IIS) Manager, go to Sites > fmps15, select Authentication (under IIS) and disable Anonymous Authentication.
Install a command line tool, such as cURL, to pass commands to FMPS. cURL is a freeware command line tool.
If FMPS fails to install the IIS website, you can execute the deploy command to install the website. To manually install the FMPS website, log in as Administrator and complete the following steps:
Go to FMPS installation folder.
(Program
Files\Adobe\Adobe FrameMaker Publishing Server Core 2019\deploy
)
Run the deploy.bat
file in administrator
mode with the following syntax:
deploy.bat addsite
-sitename <newsite> -port 6234 -physicalpath "<path>" addpool[or
setpool] -poolname <newpool>
In this command,
provide values for newsite
, path
,
and newpool
.
In the following example, the FMPS site is added to an existing pool:
deploy.bat addsite
-sitename fmps15 -port 6234 -physicalpath "C:\Program Files\Adobe\Adobe
FrameMaker Publishing Server Core 2019\www" setpool -poolname fmps15
To allow Win Server (example) for port access 6234, check if the HTTP ports for FMPS access from other machines is enabled. If it is not, enable the HTTP ports for FMPS access.
Click Start, type Firewall.cpl
,
and then click OK.
Click Advanced Settings.
Check if an inbound traffic rule is already enabled or not. If it is not, then perform the following steps:
Right-click Inbound Rules on the left pane.
If a new rule by the name FMPS Port Open exists and is checked, the ports are already enabled and you do not need to go ahead with this task. If such a rule is not visible, create a new rule by following rest of this task.
Select New Rule.
Select Port.
Under Specific Local Ports, enter your port number (Default is 6234. All the examples in this document use the port as 6234. If you have set the port to something else, replace 6234 in the examples with your port number).
Continue clicking Next until the end of the wizard. Name the rule when prompted.
Check if your port is now accessible - if required, restart the Windows Firewall service (under Services).
Complete the following steps to enable email notifications of tasks (such as “Run successful” and “Run failed.”):
Open server.ini
file from the following
location:
Program Files\Adobe\Adobe FrameMaker Publishing
Server Core 2019\
Locate the Server
flag and set its value
to your mail server (Example: inner-relay-1.corp.abc.com).
When you launch the FMPS website, the browser prompts you for permission to run Java applet. Allow the browser to run the Java applet to enable browse functionality in FMPS.
Otherwise, while opening various files in FMPS, enter the path and name of the files manually.