Installing proCube Publisher and Configuring Utilities

Installing proCube Publisher

This topic contains Publisher's installation requirements, how to install Publisher, and how to configure utilities.

Publisher requirements

Here is a list of requirements you will need to meet in order to install and use Publisher.

  • Determine the number of machines that will be using Publisher.

  • Configure a login and password for each machine.

  • Install the latest version of proCube on machines with markup and publisher servers.

  • Even if your machine is running 64-bit, configure its OS IIS to run 32-bit .Net web applications.

  • Create a PublisherTemp directory. If the machine is shared, enable access for all components.

  • Prepare a domain user and password that Publisher will work under. Grant this domain user full access rights to create and delete all files in the PublisherTemp directory and full access rights to all deployment and report locations.

  • Ensure that you are a local administrator on the machine where you install Publisher.

  • Ensure that SQL is set for mixed mode authentication and that you are an administrator on the machine where SQL is installed.

Configuring a 64-bit IIS server to run 32-bit .Net applications

To set up a 64-bit IIS server to run 32-bit applications:

  1. From the inetpub\AdminScripts directory, run the following script:

C:\Inetpub\AdminScripts>cscript.exe adsutil.vbs set W3SVC/AppPools/Enable32BitAppOnWin64  true

  1. Verify that a 32-bit .Net is installed and activated (as shown in the figure below).

Figure 1.    .NET Installed

  1. If the 32-bit .Net is not found, run the following script:

C:\Windows\Microsoft.NET\Framework\v2.0.50727>aspnet_regiis.exe  -i

  1. Restart the IIS server.

Installing Publisher

The Publisher install wizard installs both Publisher and the Publisher Configuration utility. You can choose to install both or you can pick and choose the program features that you want to install.

To install Publisher:

  1. Run the Setup file. Shortly, the wizard starts and the Welcome dialog opens.

InstallWelcome.png

Figure 2.    Install Wizard's Welcome

  1. Click Next to continue and open the License Agreement dialog.

InstallLicense.png

Figure 3.    License Agreement Dialog

  1. Select "accept terms" and click Next to continue and open the Setup Type dialog.

InstallSetup.png

Figure 4.    Setup Type Dialog

  1. Select a setup type (Complete or Custom):

  • Complete — select this setup type if components reside on one machine.

  • Custom — select this setup type if components reside on different machines. The SQL server must be installed before proceeding with a Custom installation.

  1. If you select Complete and click Next, the Database Server dialog opens. If you select Custom and click Next, the Custom Setup dialog opens where you can deselect the pieces that will not be installed on the machine.

INstallCustomSetup.png

Figure 5.    Custom Setup Dialog

  1. Clicking Next opens the Database Server dialog.

InstallDatabaseServer.png

Figure 6.    Database Server Dialog

  1. Enter the path for your installed SQL database or the path where you plan to install it. Click Next to open the Destination Folder Dialog.

InstallDestinationFolder.png

Figure 7.    Destination Folder Dialog

  1. Accept the default path or use click Change to select another install path. Click Next to open the Temporary Path Location dialog.

InstallTempPathLoc.png

Figure 8.    Temporary Path Location Dialog

  1. Using the drop-down, or by entering directly a path directly into the Folder name: field, define the location where the  temporary and log files can be written. Click Next to open the Logon Information dialog.

InstallLogonInformation.png

Figure 9.    Logon Information Dialog

  1. Enter a domain/user and password under which the application will operate. You must be an administrator on this machine. Click Browse to locate servers and users defined for each of those servers. To add a new user, click New User Information. Click Next to open the E-mail Account Information.

InstallEmailAccountInformation.png

Figure 10.           E-mail Account Information

You can enter this information now or at a later time using the Publisher Configuration Utility (go to E-mail for instructions).

  1. Fill out the first three fields if your e-mail security is based on user authentication. Unlike previous dialogs, the domain and user name are entered in separate fields. Enter a Name or IP address for the e-mail server. The last three fields are concerned with the generated e-mail and the last two of those are optional. Click Next to open the Start Installation dialog.

  2. Click Next to begin the installation.

  3. A final dialog opens - click Finish to complete the installation process.

Enabling the website

Once the installation is complete, you will need to enable the website to identify Windows users.

  1. Open Administration tools.

  2. From the Internet Information Services Manager, expand the Web Sites node.

  3. Under Default Web Site, right click on Configuration and select Properties to open the Configuration Properties dialog.

ConfigurationPropertiesDialog.png

Figure 11.           Configuration Properties Dialog

  1. Display the Directory Security tab.

  2. Under Authentication and access control, click Edit to open the Authentication Methods dialog.

AuthenticationMethodsDialog.png

Figure 12.           Authentication Methods Dialog

  1. Deselect Enable anonymous access.

  2. Click OK to save your changes and dismiss the open dialogs.

BullZip PDF driver setup

To enable the creation and distribution of pdf reports, install the included pdf driver.

  1. Unpack the contents of the BullzipPDFPrinter_6_0_0_865.zip file into the install directory.

  2. Run BullzipPDFPrinter_6_0_0_865.exe.

  3. Copy global@Bullzip PDF Printer.ini file into the directory where the Bullzip PDF driver has been installed.

  4. Open global@Bullzip PDF Printer.ini for editing.

  5. Follow instructions at the top of the file. Change the “C:\PubTemp “ to point to your Publisher Temp directory. For example:

Output=C:\PubTemp\<basedocname>.pdf

StatusFile=C:\PubTemp\PrintComplete.txt

Server properties configurator

The Server Properties Configurator is a utility for viewing and modifying Publisher settings. All the settings are stored in the registry of the machine from where Publisher is executed. Initial setting values are provided during the installation. The Server Properties Configurator is started by running the SrvUtlCnfg.exe located in the bin directory of the Publisher's install.

The Configurator is a dialog comprised of five tabs:

  • General

  • SQL

  • NT Account

  • E-mail

  • proCube Web

Two buttons are used to read/write any changes to/from the Registry.

  • Refresh reads the data from Registry.

  • Apply All writes changed values to the Registry.

General

This tab contains Publisher directory locations.

  • Temp Path – A location where temporary files and logs are stored.  This also works as a location where the request to Launcher is deposited. This has to be valid on all components.

  • Launcher Path – Location of the Publisher internal launcher application. This has to be valid on the machine where Publisher is installed.

ServerPropertiesConfiguratorGeneral.png

Figure 13.           Server Properties Configurator - General tab

SQL

This tab contains the SQL database connection information. All fields have to be entered on all components.

  • SQL Machine – Full instance name of the SQL server hosting the Publisher database.

  • SQL DB Name- Database name that has Publisher info in it.

  • SQL Account Name – Login account for the SQL Machine.

  • Password – password for the login.

  • Retype Password - Re-enter password for verification purposes.

ServerPropertiesConfiguratorSQL.png

Figure 14.           Server Properties Configurator - SQL tab

NT Account

This tab contains the NT account under whose context IIS will be executed and file system reports distributed. These fields have to be filled out on both IIS and Publisher machines.

  • Account Name – Name of the NT, Active Directory or Machine user.

  • Account Domain- Name of the machine Domain or Active Directory in whose domain user is valid.

  • Password – login's password.

  • Retype Password - Re-enter the password for verification purposes.

ServerPropertiesConfiguratorNTAccount.png

Figure 15.           Server Properties Configurator - NT Account tab

E-mail

The tab provides the e-mail settings for a Publisher machine that distributes reports or notifications by e-mail.  Account information is required only if the mail system is user authenticated. Consult your System Administrator for more information.

  • SMTP Server- name or IP of the mail server (Required field).

  • E-mail From Address- Address that will be displayed in the e-mail as the sender of the e-mail (Required field)

  • E-mail Subject- What will be displayed in the subject field of the e-mail (Optional)

  • E-mail Body- Text that will be displayed in the body of the e-mail. (Optional)

The following fields are required only if the system is user authenticated.

  • Account Name – Name of the NT, Active Directory or Machine user

  • Account Domain- Name of the machine Domain or Active Directory in whose domain user is valid.

  • Password- password following your internal requirements.

  • Retype Password - Re-enter password for verification purposes.

ServerPropertiesConfiguratorEmail.png

Figure 16.           Server Properties Configurator - E-mail tab

proCube Web

This tab provides information on publishing to proCube Web server. This information is required only if you will be publishing to proCube Web.

  • Admin Name- Name of the proCube Web Administrator.

  • Password –Password of proCube Web Administrator.

  • Web Storage Path – Location where reports will be published for display by proCube Web. It will probably be a share accessible by publisher and IIS running proCube Web.

  • SQL proCube Web Repository Password – Password for the login user on the SQL machine hosting the proCube web Repository.

  • Encrypted - Click Encrypt to generate an encrypted value for this machine.

ServerPropertiesConfiguratorproCubeWeb.png

Figure 17.           Server Properties Configurator - proCube Web tab

 

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk