High Performance Solutions for Email Marketers!
 
Login:
Password:
 

 


Frequently Asked Questions
Find answers to the most commonly asked questions about our products here.

Campaign Manager
How do I add an IP address on an injector server?
How do I add a default gateway on an injection server?
How do forward a port from one machine to another?
I am experiencing slowness why might this be?
How is an email address marked as unsubscribed in the database?
Is there a limit on the number of ip/domain sets you can use when sending a campaign?
How do I use an external server for DNS?
How can I have the user automatically unsubscribed when they click on the unsubscribe link?
How can I request the user enters their email when sent to the unsubscribe page?
How to insert an unsubscribe link into the text footer of a campaign?
Injector
How do I run the injector?
How do I send messages with Text only content?
How do I send messages with HTML or XML content?
How do I send Multipart MIME messages?
How do I inject messages to a remote PMTA server?
How do I inject messages to a port other than port 25?
How can I inject more messages into PMTA?
How do I configure the PI to use a Virtual MTA Pool?
How do I configure the domain name PI sends the mail from?
How do I configure the email address PI sends the mail from?
How do I add additional headers to the email?
Does PI does any list cleaning?
How do I run multiple injectors?
Campaign Manager
How do I add an IP address on an injector server?

Save the code below as addip.sh. Run it as root as specified below.

#!/bin/sh
#
# addip.sh
#
# Description: This script adds an IP address on a system. You
# need to specify the IP address to add and the subnet mask. You
# need to run this script as the root user.
#
# Example: addip.sh IP_ADDRESS SUBNET_MASK
#
# Copyright 2007 Permicity LLC. All Rights Reserved
#

(($# != 2)) && { echo "Usage $0 IP_ADDRESS SUBNET_MASK" >&2; exit 1; }

NEWALIAS=`ifconfig | grep eth0 | awk '{ print $1 }' | tail -1 | sed -e 's/:/ /g' | awk '{ print $2 }'`
NEWALIAS=`expr $NEWALIAS + 1 `

/sbin/ifconfig eth0:$NEWALIAS $1 netmask $2 up

How do I add a default gateway on an injection server?

Save the code below as addgw.sh. Run it as root as specified below.

#!/bin/sh
#
# addgw.sh
#
# Description: This script adds the default gateway on a system. You
# need to specify the IP address of the default gw to add. You
# need to run this script as the root user.
#
# Example: addgw.sh GATEWAY_IP_ADDRESS
#
# Copyright 2007 Permicity LLC. All Rights Reserved
#

(($# != 1)) && { echo "Usage $0 GATEWAY_IP_ADDRESS" >&2; exit 1; }

/sbin/route add default gw $1

How do forward a port from one machine to another?

Save the code below as addforwarding.sh. Run it as root as specified below.

#!/bin/sh
#
# addforwarding.sh
#
# Description: This script adds the forwards a port on the local machine
# to a port on the remote machine. You need to specify the IP address
# of the local machine, the local port, the IP address of the remote
# machine, and the remote port. You need to run this script
# as the root user.
#
# Example: addforwarding.sh LOCAL_IP_ADDRESS LOCAL_PORT REMOTE_IP_ADDRESS REMOTE_PORT
#
# Copyright 2007 Permicity LLC. All Rights Reserved
#

(($# != 4)) && { echo "Usage $0 LOCAL_IP_ADDRESS LOCAL_PORT REMOTE_IP_ADDRESS REMOTE_PORT" >&2; exit 1; }

/sbin/iptables -t nat -A PREROUTING -p tcp -i eth0 -d $1 --dport $2 -j DNAT --to $3:$4
/sbin/iptables -A FORWARD -p tcp -i eth0 -d $3 --dport $4 -j ACCEPT

I am experiencing slowness why might this be?

You could be having bandwidth issues if you are currently sending a campaign. Also consider any previous functions you have started, i.e. processes that are listed in the Dashboard, or a sending of campaigns close together in time.

The Permicity application has 4 automatic processes that run periodically throughout the day. The only one that I would expect to cause delays in the browser getting pages from the server would be the process that runs every 15 minutes to collect the logs from the PMTA server. If the PMTA log is large, then some bandwidth will be consumed while transferring the file to the Permicity application machine.


How is an email address marked as unsubscribed in the database?

To verify that the email was removed from the mailing list, do a List->Search and enter the email address, you will see that its status is unsubscribed. The email still exists in the system with a status of unsubscribed. When creating the mailing lists, the Permicity application ignores any email with a status of unsubscribed.

Is there a limit on the number of ip/domain sets you can use when sending a campaign?

There is no limit to the number of domains/IPs sets that you can choose when creating a new campaign. The application will split your mailing list into as many pieces as there are domains/IPs sets selected. The PMTA is then given each set of emails to send from the assigned domains/IPs set.

How do I use an external server for DNS?

For all domains that you wish to be associated with PCM, you will need to place a copy of the zone file for that domain into a directory on the PCM server. They will then be available as choices for mail domains when you create a new campaign. the directory is: /home/pcm/pcm-prod/dns/data/

How can I have the user automatically unsubscribed when they click on the unsubscribe link?

This is the default behavior of the application. If you want to have the user enter their email address when they click on the unsubscribe link, you can read the FAQ on this page for more information.

How can I request the user enters their email when sent to the unsubscribe page?

This feature can be enabled by Support, please send an email to support@permicity.com

How to insert an unsubscribe link into the text footer of a campaign?

Text messages do not have link capability for tracking the user and campaign information. And since the user will be seeing the link in plain text, keeping it simple is of concern. So in the CAN-SPAM section for the list(s) you are using, create a text message that includes a link like this - using your domain name of choice:
http://valid.redirect.domain.on.your.system/unsubscribe_main.php

Injector
How do I run the injector?
# ./pi config template list


config contains the configuration options
template contains the email content
list contains the email addresses


How do I send messages with Text only content?

You can use the template-text provided with the injector to send text only content.

How do I send messages with HTML or XML content?

You can use the template-html provided with the injector to send messages with XML or HTML content.

How do I send Multipart MIME messages?

You can use the template-multi provided with the injector to send Multipart MIME encoded messages.

How do I inject messages to a remote PMTA server?

You can specify the ip address of the PMTA server in the config file:
PI_SERVER=127.0.0.1

How do I inject messages to a port other than port 25?

You can specify the port you want to inject messages to in the config file:
PI_PORT=25

How can I inject more messages into PMTA?

You can increase the number of messages per injection connection to PMTA by changing the config file parameter for PI_MESSAGES_PER_INJECT:
PI_MESSAGES_PER_INJECT=5000
You can also run multiple injectors, please refer to the Knowledge Base article on how to do so.

How do I configure the PI to use a Virtual MTA Pool?

You first need to configure the VMTA Pool in the PMTA config file. Make sure you reload PMTA so the configuration is updated. Now you can specify the VMTA pool in the PI config file:
PI_VMTA=myvirtualmtapool1


How do I configure the domain name PI sends the mail from?

You can specify the mail domain name in the PI config file:
PI_MAIL_DOMAIN=domain.com


How do I configure the email address PI sends the mail from?

You can specify the email address in the PI config file:
PI_FROM_EMAIL=support

How do I add additional headers to the email?

You can add additional headers by editing the template file and placing the additional headers right after the date specification:
Date: [*date]
X-Additional_Header: Additional Header Information


Does PI does any list cleaning?

Yes, PI will only inject an email address from the list if it is a valid email address. PI checks the syntax of each email address before injection to catch any bad data that might have accidentally been added.

How do I run multiple injectors?

You only need to add the following configuration option to the config file to specify how many injectors you want to run:
# to run 5 injectors simulataneously
PI_NUM_INJECTORS=5

Now you can run multiple injectors by executing the following:
# ./pi config template list