Corrade: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
No edit summary
 
(12 intermediate revisions by 3 users not shown)
Line 4: Line 4:


= '''<span style="color:#00528c">Download Links</span>''' =
= '''<span style="color:#00528c">Download Links</span>''' =
: '''Windows:'''
 
: '''[http://grimore.org/secondlife/scripted_agents/corrade/install_guides/debian Linux - Debian]'''
: '''[http://grimore.org/secondlife/scripted_agents/corrade/install_guides/debian Linux - Debian]'''
: '''[http://grimore.org/secondlife/scripted_agents/corrade/install_guides/freebsd Linux - FreeBSD]'''
: '''[http://grimore.org/secondlife/scripted_agents/corrade/install_guides/freebsd Linux - FreeBSD]'''
: '''[http://grimore.org/secondlife/scripted_agents/corrade/install_guides/raspberry_pi Raspberry Pi]'''
: '''[http://grimore.org/secondlife/scripted_agents/corrade/install_guides/raspberry_pi Raspberry Pi]'''


= '''<span style="color:#00528c">Windows Install</span>''' =
Check with the '''[secondlife:///app/group/e269893f-a570-0087-930e-6ba2a0b77f9c/about Wizardry and Steamworks:Support]''' group if you need help with Corrade installs on operating systems '''other than''' MS-Windows.
 
= '''<span style="color:#00528c">Windows Installation</span>''' =
These instructions are provided by Aphrodite Atlas.  
These instructions are provided by Aphrodite Atlas.  
:1) Download the latest '''[http://grimore.org/secondlife/scripted_agents/corrade#download_binaries Corrade Progressive 9.106 or later]''' - Progressive 9.91 has issues with multiple groups - (this has the "configurator" utility for easier setup)
:1) Download the latest '''[http://grimore.org/secondlife/scripted_agents/corrade Corrade Progressive build for Windows]'''.
:2) Unpack the .zip file to the location you want it to run from
:2) Unpack the .zip file to the location you want it to run from
:3) Run '''configurator.exe''' to configure your bot
:3) Run '''configurator.exe''' to configure your bot
:4) On the '''Client''' tab:  
:4) At the lower right, use the drop-down to select ADVANCED
::A) Input the bot account's name
::A) On the '''Client''' tab:  
::B) Input the bot account's password
:::1) Input the bot account's name
::C) Change '''start location''' to desired location (provide a SLURL if you don't want "last location" or "home" used.)  
:::2) Input the bot account's password
::D) Save the file as "Corrade.ini"
:::3) Change '''start location''' to desired location (provide a Login URL (SLURL) if you don't want "last location" or "home" used.)  
:5) On the '''Masters''' tab:  
:::4) Save the file as "Corrade.ini"
:: E) Remove the example master names
::B) On the '''Masters''' tab:  
:: F) Click the '''Add Master''' button
:::1) Remove the example master names
:: G) Add yourself as a master
:::2) Click the '''Add Master''' button
:: H) Save the file as Corrade.ini
:::3) Add yourself as a master
:6) On the '''Groups''' tab:  
:::4) Save the file as Corrade.ini
:: I) Remove (or edit) the example groups
::C) On the '''Groups''' tab:  
:: J) Remember to click '''Add Group''' when creating a new group
:::1) Remove (or edit) the example groups
:: K) Replace with info for the group you want the bot to give invitations to and handle ejects for
:::2) Remember to click '''Add Group''' when creating a new group
:: L) Under '''group permissions''' you MUST check/tick the "groups" box, anything else is optional
:::3) Replace with info for the group you want the bot to give invitations to and handle ejects for
:: M) The password you enter on this tab is your "Security Code" - this is '''not''' the SL account password! Numbers, letters, symbols are ok.  
:::4) Under '''group permissions''' you MUST check/tick the "groups" box, anything else is optional. '''NOTE''': Possibly you'll need to tick all the permissions to get Corrade to respond when you add it to CasperLet. Try with just "groups"; if it doesn't work, come back to configurator.ini, select all the permissions, save, and restart Corrade, then test again.
:: N) "Workers" = maximum simultaneous tasks. Up to 10 for best results.  
:::5) The password you enter on this tab is your "Security Code" - this is '''not''' the SL account password! Numbers, letters, symbols are ok.  
:: O) Specify a database in the form of ''databasename.db'''
:::6) "Workers" = maximum simultaneous tasks. Up to 10 for best results.  
:: P) Specify a log file location and filename if you enable chat logging
:::7) Specify a database in the form of ''databasename.db'''
:: Q) Save the file as Corrade.ini
:::8) Specify a log file location and filename if you enable chat logging
:7) Run Corrade
:::9) Save the file as Corrade.ini
:8) From Windows, go Start > Run > cmd.exe  '''as ADMINISTRATOR'''
::D) Ensure that SIML, RLV, HTTP, Nucleus and notifications are disabled. This will lighten the client in the event you plan to use it for only basic group invite/eject functions.
:9) cd into the directory in which you unpacked Corrade
:5) Run Corrade
:10) At the command line, type '''Corrade.exe''' and hit enter.  
::A) From Windows, go Start > Run > cmd.exe  '''as ADMINISTRATOR'''
::B) cd into the directory in which you unpacked Corrade
::C) At the command line, type '''Corrade.exe''' and hit enter.
 
'''NOTE''': Should you need to run multiple Corrade instances on a single machine, it is critical that you either disable Nuclear for each instance, or change the port on which each instance '"dials out"' from your machine.


=== Corrade as a Windows Service ===
=== Corrade as a Windows Service ===
----
----
Information on how to set up Corrade as a service (so it auto restarts) is located '''[http://grimore.org/secondlife/scripted_agents/corrade/auto_restart/windows on the Grimore site]'''
Information on how to set up Corrade as a service (so it auto restarts) is located '''[http://grimore.org/secondlife/scripted_agents/corrade/auto_restart/windows on the Grimore site]'''
'''Note:''' It is recommended when you set it up as a service to use "Auto Delayed Start".


= '''<span style="color:#00528c">Adding Corrade Bots to CasperTech Products</span>''' =
= '''<span style="color:#00528c">Adding Corrade Bots to CasperTech Products</span>''' =


=== Adding CorradeBot to CasperLet ===
=== Adding Corrade to CasperLet ===
----
----
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none; "width: 85%;"
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none; "width: 85%;"
Line 59: Line 67:
|-
|-
| valign="top" |You will be presented with information about:<ol><li> The bot type you've chosen </li> <li>Where to purchase the bot in question (in case you don't have it already).</li></ol>
| valign="top" |You will be presented with information about:<ol><li> The bot type you've chosen </li> <li>Where to purchase the bot in question (in case you don't have it already).</li></ol>
These screen assumes your choice is CorradeBot.   
These screen assumes your choice is Corrade.   
| [[File:RobotArmy-Corrade.png|300px|thumb|left|Corrade bot info]]
| [[File:RobotArmy-Corrade.png|300px|thumb|left|Corrade bot info]]
|-
|-
| valign="top" | If you've selected '''Corrade bot''' you'll see this screen. Remember that:  <br /><ol><li>'''Label''' = Display name of that bot as you want it to appear in your bots list.</li><li>Corrade will accept letters, numbers and symbols in the Security Code.</li></ol><br />Once you are done entering in setup information, click the "Next" button. If you've missed information that is required, there will be a popup screen to tell you what you're missing when you click "Next".  
| valign="top" | If you've selected '''Corrade''' you'll see this screen. Remember that:  <br /><ol><li>'''Label''' = Display name of that bot as you want it to appear in your bots list.</li><li>Corrade will accept letters, numbers and symbols in the Security Code.</li></ol><br />Once you are done entering in setup information, click the "Next" button. If you've missed information that is required, there will be a popup screen to tell you what you're missing when you click "Next".  
| [[File:RobotArmy-CorradeSetup.png|300px|thumb|left|Click for larger image]]
| [[File:RobotArmy-CorradeSetup.png|300px|thumb|left|Click for larger image]]
|-
|-

Latest revision as of 17:21, 14 August 2017

Corrade Support Information

Inworld group: Wizardry and Steamworks:Support
Contact: Kira Komarov

Download Links

Linux - Debian
Linux - FreeBSD
Raspberry Pi

Check with the Wizardry and Steamworks:Support group if you need help with Corrade installs on operating systems other than MS-Windows.

Windows Installation

These instructions are provided by Aphrodite Atlas.

1) Download the latest Corrade Progressive build for Windows.
2) Unpack the .zip file to the location you want it to run from
3) Run configurator.exe to configure your bot
4) At the lower right, use the drop-down to select ADVANCED
A) On the Client tab:
1) Input the bot account's name
2) Input the bot account's password
3) Change start location to desired location (provide a Login URL (SLURL) if you don't want "last location" or "home" used.)
4) Save the file as "Corrade.ini"
B) On the Masters tab:
1) Remove the example master names
2) Click the Add Master button
3) Add yourself as a master
4) Save the file as Corrade.ini
C) On the Groups tab:
1) Remove (or edit) the example groups
2) Remember to click Add Group when creating a new group
3) Replace with info for the group you want the bot to give invitations to and handle ejects for
4) Under group permissions you MUST check/tick the "groups" box, anything else is optional. NOTE: Possibly you'll need to tick all the permissions to get Corrade to respond when you add it to CasperLet. Try with just "groups"; if it doesn't work, come back to configurator.ini, select all the permissions, save, and restart Corrade, then test again.
5) The password you enter on this tab is your "Security Code" - this is not the SL account password! Numbers, letters, symbols are ok.
6) "Workers" = maximum simultaneous tasks. Up to 10 for best results.
7) Specify a database in the form of databasename.db'
8) Specify a log file location and filename if you enable chat logging
9) Save the file as Corrade.ini
D) Ensure that SIML, RLV, HTTP, Nucleus and notifications are disabled. This will lighten the client in the event you plan to use it for only basic group invite/eject functions.
5) Run Corrade
A) From Windows, go Start > Run > cmd.exe as ADMINISTRATOR
B) cd into the directory in which you unpacked Corrade
C) At the command line, type Corrade.exe and hit enter.

NOTE: Should you need to run multiple Corrade instances on a single machine, it is critical that you either disable Nuclear for each instance, or change the port on which each instance '"dials out"' from your machine.

Corrade as a Windows Service


Information on how to set up Corrade as a service (so it auto restarts) is located on the Grimore site

Note: It is recommended when you set it up as a service to use "Auto Delayed Start".

Adding Corrade Bots to CasperTech Products

Adding Corrade to CasperLet


Steps to perform Reference Image
Log in to CasperLet, go to the Group Bots page and click the "Add New" button.

(If you already have existing bots set up, you will see a list of bots under the "Add New" button - if you wish to edit an existing bot configuration, click the "Edit" button next to the name of the bot you want to edit instead.)
Click for larger image
Use the pulldown to select your bot type.
Click for larger image
You will be presented with information about:
  1. The bot type you've chosen
  2. Where to purchase the bot in question (in case you don't have it already).

These screen assumes your choice is Corrade.

Corrade bot info
If you've selected Corrade you'll see this screen. Remember that:
  1. Label = Display name of that bot as you want it to appear in your bots list.
  2. Corrade will accept letters, numbers and symbols in the Security Code.

Once you are done entering in setup information, click the "Next" button. If you've missed information that is required, there will be a popup screen to tell you what you're missing when you click "Next".
Click for larger image
Now you will arrive at the test screen. Click the blue "Test Now" button to begin testing the configuration.
Click for larger image
You will get a "Please Wait" window while the test is in progress, as shown here.
Click for larger image
If you have an error in your bot configuration, you'll get an additonal popup with the error message.

This is a sample of what the error message popup will say - there will be different errors depending on the configuration issue, and the selected bot.
Click for larger image
If the test of your configuration was a success, you will see this message.
Click for larger image
Clicking "OK" on the Success screen will automatically take you back to the main bots page, with your newly configured bot appearing in the list.

An example of a list of bots may be seen in this image.
Click for larger image

Using CasperLet Bots on a Per-Unit Basis


Steps to perform Reference Image
Adding a bot on a per-unit basis requires the bot to already be set up. You should see a list of bots if this has already been done, similar to this reference image. If you have no bots in the list, you need to create your bot(s).
Click for larger image
Edit the individual unit configuration, and scroll down until you get to the "Group Invite Bots" line.
Click for larger image
Use the pulldown to find the display/label name of your bot to use for group invites from this rental unit, and click the "Add" button.
Click for larger image