Initial Configuration

You have ASTPP installed on your system. Now we must perform the initial configuration. You will need to go in and manually confirm the contents of /var/lib/astpp/astpp-config.conf. You will also need to edit the settings stored in the database using phpmyadmin (Sometime in the near future, we'll have an editor available.) I have outlined the variables and fields below.

ASTPP Database Configuration
Host: Enter the ipaddres or dns name of the machine which is running MySQL where the ASTPP database will be hosted. - $config{dbhost}
Username: The username in MySQL with the necessary permissions to create the ASTPP database. - $config{dbuser}
Password: The password belonging to the above user. - $config{dbpass}
Database: Enter the database name you chose earlier. - $config{dbname}

Asterisk CDR Database Configuration
Asterisk CDR Host: Enter the ipaddres or dns name of the machine which is running MySQL where the Asterisk CDR database is hosted. - $config{cdr_dbhost}
Asterisk CDR Username: The MySQL user with the necessary permissions to edit information in the Asterisk CDR database. - $config{cdr_dbuser}
Asterisk CDR Password: The password for the above user. - $config{cdr_dbpass}
Asterisk CDR Database: The name of the Asterisk CDR database. - $config{cdr_dbname}

Assorted Configuration Fields - These are set in the database table "system".
Card Length (4-20): This field is necessary for calling card number generation. It specifies how many digits long the calling card number should be. It also specifies the length of the "cc" number which is tagged to each account. - $config{cardlength}
Card Starting Number - Enter 0 if Not Required: This field is used to force the calling card number to begin with a specified digit. - $config{startingdigit}
Email New Account Info to admin: If set to 1, ASTPP will send the administrator an email every time an account is generated in ASTPP. - $config{email}
Admin Email: Please enter the administrators email address. - $config{emailadd}
Currency Name: Please enter the currency you use. Ie CAD, or USD. This field is only used for display purposes. - $config{currency_name}
Company Name (No Spaces): Please enter your company name using an underscore instead of a space. - $config{company_name}
Company Website: Please enter the URL of your companys website. This is used in customer emails. - $config{company_website}
Customer Service Email Address: Please enter your customer service email address. This is used in customer emails. - $config{company_email}
Asterisk Server (DNS/IP): Please enter the IP address or DNS name required to access your asterisk server. This is used in sample configurations sent out in customer emails. - $config{asterisk_server}
New User Default Pricelist: This field is used if a brand is not sent with a signup order from the automated signup process (astpp-auto-admin.cgi). - $config{new_user_brand}
Email Users on action? Do you wish for your users to receive email on account creation and removal etc? - $config{user_email}
Debug Mode: If Debug Mode is set to yes ASTPP will provide extra debugging information. This is useful when solving problems and during setup. This can cause problems in certain versions of Apache as Apache is not able to handle the extra debugging output. - $config{debug}
Asterisk Configuration Directory: Your asterisk configuration directory. Ie “/etc/asterisk” - $config{asterisk_dir}
New User Context: When ASTPP creates a new SIP/IAX device as ordered by astpp-auto-admin.cgi it will place the user into this context unless otherwise ordered by the automated process. - $config{default_context}
Default Reg Seconds: Asterisk default device registration timeout. Typically is set to 3600. - $config{reg_seconds}
Sip Port: Sip Port to use. Typically set at 5600. - $config{sip_port}
IAX Port: IAX port to use. Typically set at 4569. - $config{iax_port}
Client IP Address: This would allow you to force your clients to connect from a specific IP address. I believe you could also enter a range of IP addresses in here. I would leave it set at “dynamic”. - $config{ipaddr}
Codecs usually (all): What codecs do you support? List them here seperated by commas. - $config{codecs}
Default Client Type (friend/user/peer): What type of devices should ASTPP add? We recommend leaving this at friend. - $config{type}
Outoing Key: IAX2 supports RSA authentication. If you are using it enter your key name here. - $config{key}
Remote Incoming User Name: The name you will be trying to connect to when you send calls to your users devices. - $config{remote_incoming}
Key Home: Please enter the URL where users can download your RSA key from if appropriate. - $config{key_home}

Asterisk Manager Options. ASTPP uses the Asterisk manager to connect to Asterisk and force reloads. It is also used by the realtime rating engine.
Asterisk Manager User: What username shall ASTPP use to connect to that Asterisk manager? - $config{astman_user}
Asterisk Manager Secret: Password for the above user. - $config{astman_secret}
Asterisk Manager Host: Asterisk host to connect to. - $config{astman_host}

astpp-rate-engine.pl Options – Rating Engine Options
Default Pricelist: If the rating engine cannot find a cost under the cards brand it looks under the default brand. - $config{default_brand}

Least Cost Routing Options
Enable LCR (Least Cost Routing)? Do you wish to use LCR? This will affect the output of the credit control engine. - $config{enablelcr}

Ok, having made it this far you have probably changed most of the lines that need changing. However, ASTPP is a very flexible application. Therefore you're not done yet. Once you have finished the configuration using astpp-install.cgi please be sure to remove the file as it poses a great security risk if it is left in place.